@yoonion/mimi-seed-mcp 0.3.33 → 0.3.34

package/dist/auth/google-auth.js

@@ -13,6 +13,7 @@ const SCOPES = [
     'https://www.googleapis.com/auth/admob.monetization',
     'https://www.googleapis.com/auth/androidpublisher',
     'https://www.googleapis.com/auth/adwords', // Google Ads API (googleads_* tools)
+    'https://www.googleapis.com/auth/webmasters', // Search Console API (gsc_* tools, 사이트맵 제출 포함)
 ];
 // Primary config dir. Legacy `~/.preseed` is read as a fallback during the
 // rebrand so existing auth sessions don't force a re-login; new writes go to

package/dist/gsc/tools.d.ts

@@ -0,0 +1,39 @@
+import type { OAuth2Client } from 'google-auth-library';
+export type GscAuth = OAuth2Client;
+export declare function listSites(auth: GscAuth): Promise<import("googleapis").searchconsole_v1.Schema$WmxSite[]>;
+export declare function listSitemaps(auth: GscAuth, siteUrl: string, sitemapIndex?: string): Promise<import("googleapis").searchconsole_v1.Schema$WmxSitemap[]>;
+export declare function getSitemap(auth: GscAuth, siteUrl: string, feedpath: string): Promise<import("googleapis").searchconsole_v1.Schema$WmxSitemap>;
+/** 사이트맵 제출 — webmasters(read-write) 스코프 필요. 응답 본문은 없음(204). */
+export declare function submitSitemap(auth: GscAuth, siteUrl: string, feedpath: string): Promise<{
+    submitted: string;
+    siteUrl: string;
+}>;
+export declare function inspectUrl(auth: GscAuth, siteUrl: string, inspectionUrl: string, languageCode?: string): Promise<import("googleapis").searchconsole_v1.Schema$UrlInspectionResult>;
+export interface SearchAnalyticsParams {
+    startDate: string;
+    endDate: string;
+    dimensions?: string[];
+    rowLimit?: number;
+    startRow?: number;
+    type?: 'web' | 'image' | 'video' | 'news' | 'discover' | 'googleNews';
+}
+export declare function searchAnalytics(auth: GscAuth, siteUrl: string, params: SearchAnalyticsParams): Promise<import("googleapis").searchconsole_v1.Schema$ApiDataRow[]>;
+export interface SearchAnalyticsRow {
+    keys?: string[] | null;
+    clicks?: number | null;
+    impressions?: number | null;
+    ctr?: number | null;
+    position?: number | null;
+}
+/**
+ * Search Analytics rows 요약.
+ * position 은 노출수(impressions) 가중 평균으로 집계한다 — 단순 산술평균은
+ * 노출이 1인 행과 1000인 행을 동등 취급해 실제 평균 순위를 왜곡한다.
+ */
+export declare function summarizeRows(rows: SearchAnalyticsRow[]): {
+    rowCount: number;
+    totalClicks: number;
+    totalImpressions: number;
+    avgCtr: number;
+    avgPosition: number;
+};

package/dist/gsc/tools.js

@@ -0,0 +1,68 @@
+import { google } from 'googleapis';
+/**
+ * Google Search Console (Webmasters) API v1 래퍼.
+ *
+ * `searchconsole('v1')` 은 구 `webmasters('v3')` 의 후속으로, sites/sitemaps/
+ * searchanalytics 에 더해 URL Inspection(`urlInspection.index.inspect`)을 포함한다.
+ * 인증은 mimi-seed OAuth 클라이언트(`requireAuth()`)를 그대로 사용 — webmasters 스코프 필요.
+ */
+const sc = () => google.searchconsole('v1');
+// ─── 속성(사이트) 목록 ───
+export async function listSites(auth) {
+    const res = await sc().sites.list({ auth });
+    return res.data.siteEntry ?? [];
+}
+// ─── 사이트맵 ───
+export async function listSitemaps(auth, siteUrl, sitemapIndex) {
+    const res = await sc().sitemaps.list({ auth, siteUrl, sitemapIndex });
+    return res.data.sitemap ?? [];
+}
+export async function getSitemap(auth, siteUrl, feedpath) {
+    const res = await sc().sitemaps.get({ auth, siteUrl, feedpath });
+    return res.data;
+}
+/** 사이트맵 제출 — webmasters(read-write) 스코프 필요. 응답 본문은 없음(204). */
+export async function submitSitemap(auth, siteUrl, feedpath) {
+    await sc().sitemaps.submit({ auth, siteUrl, feedpath });
+    return { submitted: feedpath, siteUrl };
+}
+// ─── URL 색인 검사 ───
+export async function inspectUrl(auth, siteUrl, inspectionUrl, languageCode = 'en-US') {
+    const res = await sc().urlInspection.index.inspect({
+        auth,
+        requestBody: { siteUrl, inspectionUrl, languageCode },
+    });
+    return res.data.inspectionResult ?? {};
+}
+export async function searchAnalytics(auth, siteUrl, params) {
+    const res = await sc().searchanalytics.query({
+        auth,
+        siteUrl,
+        requestBody: {
+            startDate: params.startDate,
+            endDate: params.endDate,
+            dimensions: params.dimensions,
+            rowLimit: params.rowLimit ?? 1000,
+            startRow: params.startRow,
+            type: params.type,
+        },
+    });
+    return res.data.rows ?? [];
+}
+/**
+ * Search Analytics rows 요약.
+ * position 은 노출수(impressions) 가중 평균으로 집계한다 — 단순 산술평균은
+ * 노출이 1인 행과 1000인 행을 동등 취급해 실제 평균 순위를 왜곡한다.
+ */
+export function summarizeRows(rows) {
+    const totalClicks = rows.reduce((s, r) => s + (r.clicks ?? 0), 0);
+    const totalImpressions = rows.reduce((s, r) => s + (r.impressions ?? 0), 0);
+    const weightedPos = rows.reduce((s, r) => s + (r.position ?? 0) * (r.impressions ?? 0), 0);
+    return {
+        rowCount: rows.length,
+        totalClicks,
+        totalImpressions,
+        avgCtr: totalImpressions > 0 ? Math.round((totalClicks / totalImpressions) * 10000) / 10000 : 0,
+        avgPosition: totalImpressions > 0 ? Math.round((weightedPos / totalImpressions) * 100) / 100 : 0,
+    };
+}

package/dist/index.js

@@ -15,6 +15,7 @@ import { registerCiTools } from './registers/ci.js';
 import { registerInstagramTools } from './registers/instagram.js';
 import { registerFacebookTools } from './registers/facebook.js';
 import { registerGoogleAdsTools } from './registers/googleads.js';
+import { registerGscTools } from './registers/gsc.js';
 import { registerPrompts } from './prompts.js';
 import { registerResources } from './resources.js';
 // dist/index.js 기준 ../package.json — npm 패키지 루트의 버전을 단일 출처로 사용.
@@ -37,6 +38,7 @@ registerCiTools(server);
 registerInstagramTools(server);
 registerFacebookTools(server);
 registerGoogleAdsTools(server);
+registerGscTools(server);
 registerPrompts(server);
 registerResources(server);
 // `npx -y @yoonion/mimi-seed-mcp <subcommand>` 처리.

package/dist/registers/gsc.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerGscTools(server: McpServer): void;

package/dist/registers/gsc.js

@@ -0,0 +1,80 @@
+import { z } from 'zod';
+import { requireAuth } from '../helpers.js';
+import * as gsc from '../gsc/tools.js';
+const SITE_URL_DESC = "Search Console 속성 식별자. 도메인 속성은 'sc-domain:example.com', URL 접두어 속성은 'https://example.com/' 형식.";
+export function registerGscTools(server) {
+    server.tool('gsc_list_sites', 'Search Console에 등록된(권한 있는) 속성 목록 + 권한 레벨 조회. siteUrl 값을 확인할 때 먼저 호출.', {}, async () => {
+        const auth = await requireAuth();
+        const sites = await gsc.listSites(auth);
+        return { content: [{ type: 'text', text: JSON.stringify(sites, null, 2) }] };
+    });
+    server.tool('gsc_list_sitemaps', '속성에 제출된 사이트맵 목록 (마지막 다운로드 시각, 경고/오류 수, submitted/indexed 카운트). ⚠️ 사이트맵 리포트의 indexed 수치는 신뢰도 낮음 — 실제 색인 여부는 gsc_inspect_url 로 확인.', {
+        siteUrl: z.string().describe(SITE_URL_DESC),
+        sitemapIndex: z.string().optional().describe('사이트맵 인덱스 URL — 인덱스 하위 사이트맵만 보고 싶을 때'),
+    }, async ({ siteUrl, sitemapIndex }) => {
+        const auth = await requireAuth();
+        const sitemaps = await gsc.listSitemaps(auth, siteUrl, sitemapIndex);
+        return { content: [{ type: 'text', text: JSON.stringify(sitemaps, null, 2) }] };
+    });
+    server.tool('gsc_get_sitemap', '특정 사이트맵 1개의 상세(타입별 submitted/indexed, 경고/오류, 처리 시각) 조회.', {
+        siteUrl: z.string().describe(SITE_URL_DESC),
+        feedpath: z.string().describe('사이트맵 전체 URL (예: https://example.com/sitemap.xml)'),
+    }, async ({ siteUrl, feedpath }) => {
+        const auth = await requireAuth();
+        const sitemap = await gsc.getSitemap(auth, siteUrl, feedpath);
+        return { content: [{ type: 'text', text: JSON.stringify(sitemap, null, 2) }] };
+    });
+    server.tool('gsc_submit_sitemap', '사이트맵을 Search Console에 제출(또는 재제출)해 재크롤을 유도. webmasters read-write 스코프 필요.', {
+        siteUrl: z.string().describe(SITE_URL_DESC),
+        feedpath: z.string().describe('제출할 사이트맵 전체 URL (예: https://example.com/sitemap.xml)'),
+    }, async ({ siteUrl, feedpath }) => {
+        const auth = await requireAuth();
+        const result = await gsc.submitSitemap(auth, siteUrl, feedpath);
+        return {
+            content: [{
+                    type: 'text',
+                    text: `✅ 사이트맵 제출 완료.\n  ${result.submitted}\n\n반영까지 수 분~수 시간 걸려. gsc_list_sitemaps 로 lastDownloaded 갱신을 확인해.`,
+                }],
+        };
+    });
+    server.tool('gsc_inspect_url', 'URL 1개의 실제 색인 상태 검사 (coverageState, robots.txt 허용 여부, 마지막 크롤 시각, 정규 URL, 리치 결과). 사이트맵 리포트보다 정확한 색인 진단의 단일 출처.', {
+        siteUrl: z.string().describe(SITE_URL_DESC),
+        inspectionUrl: z.string().describe("검사할 전체 URL — 반드시 siteUrl 속성 하위여야 함 (예: 'https://example.com/page')"),
+        languageCode: z.string().optional().describe("이슈 메시지 언어 (BCP-47, 예: 'ko', 'en-US'). 기본 en-US"),
+    }, async ({ siteUrl, inspectionUrl, languageCode }) => {
+        const auth = await requireAuth();
+        const result = await gsc.inspectUrl(auth, siteUrl, inspectionUrl, languageCode ?? 'en-US');
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+    server.tool('gsc_search_analytics', '검색 성과 데이터 조회 (클릭·노출·CTR·평균순위). dimensions로 query/page/country/device/date/searchAppearance 별 분해. 요약(가중 평균순위 포함) + rows 반환.', {
+        siteUrl: z.string().describe(SITE_URL_DESC),
+        startDate: z.string().describe('시작일 (YYYY-MM-DD)'),
+        endDate: z.string().describe('종료일 (YYYY-MM-DD)'),
+        dimensions: z.string().optional().describe('쉼표 구분 분해 차원: query,page,country,device,date,searchAppearance (생략 시 전체 합계)'),
+        rowLimit: z.number().int().min(1).max(25000).optional().describe('최대 행 수 (기본 1000, 최대 25000)'),
+        type: z.enum(['web', 'image', 'video', 'news', 'discover', 'googleNews']).optional().describe('검색 유형 필터 (기본 web)'),
+    }, async ({ siteUrl, startDate, endDate, dimensions, rowLimit, type }) => {
+        const auth = await requireAuth();
+        const dims = dimensions
+            ? dimensions.split(',').map((d) => d.trim()).filter(Boolean)
+            : undefined;
+        const rows = await gsc.searchAnalytics(auth, siteUrl, {
+            startDate,
+            endDate,
+            dimensions: dims,
+            rowLimit,
+            type,
+        });
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        period: { startDate, endDate },
+                        dimensions: dims ?? [],
+                        summary: gsc.summarizeRows(rows),
+                        rows,
+                    }, null, 2),
+                }],
+        };
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yoonion/mimi-seed-mcp",
-  "version": "0.3.33",
+  "version": "0.3.34",
   "description": "Mimi Seed MCP server — Firebase + AdMob + Google Play + App Store management for Claude Code / Codex / Cursor / any MCP client.",
   "type": "module",
   "bin": {