@yoonion/mimi-seed-mcp 0.3.33 → 0.3.35

package/LICENSE

@@ -1,75 +1,75 @@
-# PolyForm Noncommercial License 1.0.0
-
-<https://polyformproject.org/licenses/noncommercial/1.0.0>
-
-Required Notice: Copyright 2026 Pryzm GG (https://mimi-seed.pryzm.gg)
-
-## Acceptance
-
-In order to get any license under these terms, you must agree to them as both strict obligations and conditions to all your licenses.
-
-## Copyright License
-
-The licensor grants you a copyright license for the software to do everything you might do with the software that would otherwise infringe the licensor's copyright in it for any permitted purpose.  However, you may only distribute the software according to [Distribution License](#distribution-license) and make changes or new works based on the software according to [Changes and New Works License](#changes-and-new-works-license).
-
-## Distribution License
-
-The licensor grants you an additional copyright license to distribute copies of the software.  Your license to distribute covers distributing the software with changes and new works permitted by [Changes and New Works License](#changes-and-new-works-license).
-
-## Notices
-
-You must ensure that anyone who gets a copy of any part of the software from you also gets a copy of these terms or the URL for them above, as well as copies of any plain-text lines beginning with `Required Notice:` that the licensor provided with the software.  For example:
-
-> Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
-
-## Changes and New Works License
-
-The licensor grants you an additional copyright license to make changes and new works based on the software for any permitted purpose.
-
-## Patent License
-
-The licensor grants you a patent license for the software that covers patent claims the licensor can license, or becomes able to license, that you would infringe by using the software.
-
-## Noncommercial Purposes
-
-Any noncommercial purpose is a permitted purpose.
-
-## Personal Uses
-
-Personal use for research, experiment, and testing for the benefit of public knowledge, personal study, private entertainment, hobby projects, amateur pursuits, or religious observance, without any anticipated commercial application, is use for a permitted purpose.
-
-## Noncommercial Organizations
-
-Use by any charitable organization, educational institution, public research organization, public safety or health organization, environmental protection organization, or government institution is use for a permitted purpose regardless of the source of funding or obligations resulting from the funding.
-
-## Fair Use
-
-You may have "fair use" rights for the software under the law. These terms do not limit them.
-
-## No Other Rights
-
-These terms do not allow you to sublicense or transfer any of your licenses to anyone else, or prevent the licensor from granting licenses to anyone else.  These terms do not imply any other licenses.
-
-## Patent Defense
-
-If you make any written claim that the software infringes or contributes to infringement of any patent, your patent license for the software granted under these terms ends immediately. If your company makes such a claim, your patent license ends immediately for work on behalf of your company.
-
-## Violations
-
-The first time you are notified in writing that you have violated any of these terms, or done anything with the software not covered by your licenses, your licenses can nonetheless continue if you come into full compliance with these terms, and take practical steps to correct past violations, within 32 days of receiving notice.  Otherwise, all your licenses end immediately.
-
-## No Liability
-
-***As far as the law allows, the software comes as is, without any warranty or condition, and the licensor will not be liable to you for any damages arising out of these terms or the use or nature of the software, under any kind of legal claim.***
-
-## Definitions
-
-The **licensor** is the individual or entity offering these terms, and the **software** is the software the licensor makes available under these terms.
-
-**You** refers to the individual or entity agreeing to these terms.
-
-**Your company** is any legal entity, sole proprietorship, or other kind of organization that you work for, plus all organizations that have control over, are under the control of, or are under common control with that organization.  **Control** means ownership of substantially all the assets of an entity, or the power to direct its management and policies by vote, contract, or otherwise.  Control can be direct or indirect.
-
-**Your licenses** are all the licenses granted to you for the software under these terms.
-
-**Use** means anything you do with the software requiring one of your licenses.
+# PolyForm Noncommercial License 1.0.0
+
+<https://polyformproject.org/licenses/noncommercial/1.0.0>
+
+Required Notice: Copyright 2026 Pryzm GG (https://mimi-seed.pryzm.gg)
+
+## Acceptance
+
+In order to get any license under these terms, you must agree to them as both strict obligations and conditions to all your licenses.
+
+## Copyright License
+
+The licensor grants you a copyright license for the software to do everything you might do with the software that would otherwise infringe the licensor's copyright in it for any permitted purpose.  However, you may only distribute the software according to [Distribution License](#distribution-license) and make changes or new works based on the software according to [Changes and New Works License](#changes-and-new-works-license).
+
+## Distribution License
+
+The licensor grants you an additional copyright license to distribute copies of the software.  Your license to distribute covers distributing the software with changes and new works permitted by [Changes and New Works License](#changes-and-new-works-license).
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you also gets a copy of these terms or the URL for them above, as well as copies of any plain-text lines beginning with `Required Notice:` that the licensor provided with the software.  For example:
+
+> Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
+
+## Changes and New Works License
+
+The licensor grants you an additional copyright license to make changes and new works based on the software for any permitted purpose.
+
+## Patent License
+
+The licensor grants you a patent license for the software that covers patent claims the licensor can license, or becomes able to license, that you would infringe by using the software.
+
+## Noncommercial Purposes
+
+Any noncommercial purpose is a permitted purpose.
+
+## Personal Uses
+
+Personal use for research, experiment, and testing for the benefit of public knowledge, personal study, private entertainment, hobby projects, amateur pursuits, or religious observance, without any anticipated commercial application, is use for a permitted purpose.
+
+## Noncommercial Organizations
+
+Use by any charitable organization, educational institution, public research organization, public safety or health organization, environmental protection organization, or government institution is use for a permitted purpose regardless of the source of funding or obligations resulting from the funding.
+
+## Fair Use
+
+You may have "fair use" rights for the software under the law. These terms do not limit them.
+
+## No Other Rights
+
+These terms do not allow you to sublicense or transfer any of your licenses to anyone else, or prevent the licensor from granting licenses to anyone else.  These terms do not imply any other licenses.
+
+## Patent Defense
+
+If you make any written claim that the software infringes or contributes to infringement of any patent, your patent license for the software granted under these terms ends immediately. If your company makes such a claim, your patent license ends immediately for work on behalf of your company.
+
+## Violations
+
+The first time you are notified in writing that you have violated any of these terms, or done anything with the software not covered by your licenses, your licenses can nonetheless continue if you come into full compliance with these terms, and take practical steps to correct past violations, within 32 days of receiving notice.  Otherwise, all your licenses end immediately.
+
+## No Liability
+
+***As far as the law allows, the software comes as is, without any warranty or condition, and the licensor will not be liable to you for any damages arising out of these terms or the use or nature of the software, under any kind of legal claim.***
+
+## Definitions
+
+The **licensor** is the individual or entity offering these terms, and the **software** is the software the licensor makes available under these terms.
+
+**You** refers to the individual or entity agreeing to these terms.
+
+**Your company** is any legal entity, sole proprietorship, or other kind of organization that you work for, plus all organizations that have control over, are under the control of, or are under common control with that organization.  **Control** means ownership of substantially all the assets of an entity, or the power to direct its management and policies by vote, contract, or otherwise.  Control can be direct or indirect.
+
+**Your licenses** are all the licenses granted to you for the software under these terms.
+
+**Use** means anything you do with the software requiring one of your licenses.

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
@@ -211,13 +212,13 @@ export function startAuth(clientId, clientSecret, options = {}) {
                 };
                 saveTokens(stored);
                 res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
-                res.end(`
-          <html><body style="font-family:system-ui;display:flex;justify-content:center;align-items:center;height:100vh;margin:0">
-            <div style="text-align:center">
-              <h1>✅ Mimi Seed 인증 완료!</h1>
-              <p>이 창을 닫고 Claude Code 또는 Codex로 돌아가세요.</p>
-            </div>
-          </body></html>
+                res.end(`
+          <html><body style="font-family:system-ui;display:flex;justify-content:center;align-items:center;height:100vh;margin:0">
+            <div style="text-align:center">
+              <h1>✅ Mimi Seed 인증 완료!</h1>
+              <p>이 창을 닫고 Claude Code 또는 Codex로 돌아가세요.</p>
+            </div>
+          </body></html>
         `);
                 server.close();
                 activeAuthServer = null;

package/dist/googleads/tools.js

@@ -84,20 +84,20 @@ export async function listAccessibleCustomers(auth, cfg) {
 }
 // ─── 캠페인 목록 ─────────────────────────────────────────────
 export async function listCampaigns(auth, cfg) {
-    const query = `
-    SELECT
-      campaign.id,
-      campaign.name,
-      campaign.status,
-      campaign.advertising_channel_type,
-      campaign.advertising_channel_sub_type,
-      campaign.start_date,
-      campaign.end_date,
-      campaign_budget.amount_micros
-    FROM campaign
-    WHERE campaign.status != 'REMOVED'
-    ORDER BY campaign.name ASC
-    LIMIT 200
+    const query = `
+    SELECT
+      campaign.id,
+      campaign.name,
+      campaign.status,
+      campaign.advertising_channel_type,
+      campaign.advertising_channel_sub_type,
+      campaign.start_date,
+      campaign.end_date,
+      campaign_budget.amount_micros
+    FROM campaign
+    WHERE campaign.status != 'REMOVED'
+    ORDER BY campaign.name ASC
+    LIMIT 200
   `;
     const rows = await search(auth, cfg, query);
     return rows.map((r) => ({
@@ -113,26 +113,26 @@ export async function listCampaigns(auth, cfg) {
 }
 // ─── 캠페인 성과 리포트 ────────────────────────────────────────
 export async function getCampaignReport(auth, cfg, range) {
-    const query = `
-    SELECT
-      campaign.id,
-      campaign.name,
-      campaign.status,
-      campaign.advertising_channel_type,
-      campaign.advertising_channel_sub_type,
-      metrics.clicks,
-      metrics.impressions,
-      metrics.cost_micros,
-      metrics.conversions,
-      metrics.conversions_value,
-      metrics.cost_per_conversion,
-      metrics.ctr,
-      metrics.average_cpc
-    FROM campaign
-    WHERE campaign.status != 'REMOVED'
-      AND segments.date BETWEEN '${range.startDate}' AND '${range.endDate}'
-    ORDER BY metrics.cost_micros DESC
-    LIMIT 500
+    const query = `
+    SELECT
+      campaign.id,
+      campaign.name,
+      campaign.status,
+      campaign.advertising_channel_type,
+      campaign.advertising_channel_sub_type,
+      metrics.clicks,
+      metrics.impressions,
+      metrics.cost_micros,
+      metrics.conversions,
+      metrics.conversions_value,
+      metrics.cost_per_conversion,
+      metrics.ctr,
+      metrics.average_cpc
+    FROM campaign
+    WHERE campaign.status != 'REMOVED'
+      AND segments.date BETWEEN '${range.startDate}' AND '${range.endDate}'
+    ORDER BY metrics.cost_micros DESC
+    LIMIT 500
   `;
     const rows = await search(auth, cfg, query);
     return rows.map((r) => ({
@@ -153,26 +153,26 @@ export async function getCampaignReport(auth, cfg, range) {
 }
 // ─── UAC(앱 캠페인) 리포트 ─────────────────────────────────────
 export async function getUacReport(auth, cfg, range) {
-    const query = `
-    SELECT
-      campaign.id,
-      campaign.name,
-      campaign.status,
-      campaign.advertising_channel_sub_type,
-      metrics.clicks,
-      metrics.impressions,
-      metrics.cost_micros,
-      metrics.conversions,
-      metrics.conversions_value,
-      metrics.cost_per_conversion,
-      metrics.ctr,
-      segments.date
-    FROM campaign
-    WHERE campaign.advertising_channel_type = 'MULTI_CHANNEL'
-      AND campaign.advertising_channel_sub_type IN ('APP_CAMPAIGN', 'APP_CAMPAIGN_FOR_ENGAGEMENT', 'APP_CAMPAIGN_FOR_PRE_REGISTRATION')
-      AND segments.date BETWEEN '${range.startDate}' AND '${range.endDate}'
-    ORDER BY segments.date DESC, metrics.cost_micros DESC
-    LIMIT 500
+    const query = `
+    SELECT
+      campaign.id,
+      campaign.name,
+      campaign.status,
+      campaign.advertising_channel_sub_type,
+      metrics.clicks,
+      metrics.impressions,
+      metrics.cost_micros,
+      metrics.conversions,
+      metrics.conversions_value,
+      metrics.cost_per_conversion,
+      metrics.ctr,
+      segments.date
+    FROM campaign
+    WHERE campaign.advertising_channel_type = 'MULTI_CHANNEL'
+      AND campaign.advertising_channel_sub_type IN ('APP_CAMPAIGN', 'APP_CAMPAIGN_FOR_ENGAGEMENT', 'APP_CAMPAIGN_FOR_PRE_REGISTRATION')
+      AND segments.date BETWEEN '${range.startDate}' AND '${range.endDate}'
+    ORDER BY segments.date DESC, metrics.cost_micros DESC
+    LIMIT 500
   `;
     const rows = await search(auth, cfg, query);
     const byId = new Map();

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/playstore/tools.js

@@ -59,6 +59,14 @@ export async function withEdit(auth, packageName, fn, commit = false) {
     }
 }
 // ─── Play Developer Reporting API / Android vitals ───
+//
+// ⚠️ DRIFT 주의 — getStatistics 의 요청 빌드 규칙(타임존 HOURLY=UTC, errorCount→reportType,
+//    userCohort 게이팅, default 차원/metric)은 웹 콘솔 리포의 복제본과 동일해야 합니다:
+//      web:  src/lib/mcp/tools/play-vitals.ts (buildPlayVitalsRequest)
+//    양쪽 모두 contract 테스트로 잠겨 있음:
+//      sdk:  src/__tests__/playstore-statistics.test.ts
+//      web:  src/__tests__/play-vitals.test.ts
+//    규칙 변경 시 양쪽 코드 + 양쪽 테스트를 함께 수정하세요.
 export async function getStatistics(auth, packageName, query) {
     const metricSet = query.metricSet ?? 'anrRate';
     const resource = METRIC_SET_RESOURCE[metricSet];

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/dist/registers/playstore.js

@@ -3,7 +3,8 @@ import * as playstoreRaw from '../playstore/tools.js';
 import { friendlyPlayError } from '../playstore/errors.js';
 import { saveServiceAccountJsonForPackage, listRegisteredServiceAccounts, deleteServiceAccountJsonForPackage, } from '../auth/playstore-auth.js';
 import { createGoogleOneTimePurchase, createGoogleSubscription, updateGoogleProduct, deleteGoogleProduct, listGoogleProducts, } from '@onesub/providers';
-import { requirePlayStoreAuth, requireServiceAccountJson } from '../helpers.js';
+import { requirePlayStoreAuth, requireServiceAccountJson, requireAuth } from '../helpers.js';
+import * as iam from '../iam/tools.js';
 import { buildPlayStoreReleasePlan } from '../checks/plan.js';
 import { validatePlayReleaseNotes, formatIssuesForUser } from '../lib/text-validators.js';
 // 모든 playstore tools 호출을 친절 에러로 감싸는 프록시 — 403(권한)/404/edit 충돌/
@@ -607,4 +608,61 @@ export function registerPlaystoreTools(server) {
         }
         return { content: [{ type: 'text', text: `✓ ${productId} 삭제 완료` }] };
     });
+    server.tool('setup_playstore_connection', [
+        'Play Store 서비스 계정을 한 번에 설정합니다 (SA 생성 → JSON 키 발급 → 로컬 등록).',
+        'iam_create_service_account → iam_create_key → playstore_register_service_account 를 순서대로 자동 실행.',
+        '완료 후 Play Console에서 서비스 계정 이메일을 초대하는 안내(수동 1단계)가 포함됩니다.',
+        '이미 같은 accountId의 SA가 존재하면 키만 새로 발급하고 등록합니다.',
+    ].join(' '), {
+        packageName: z.string().describe('Android 패키지명 (예: gg.pryzm.speakmoney)'),
+        projectId: z.string().describe('Google Cloud 프로젝트 ID (예: my-project-123). Firebase 콘솔 → 프로젝트 설정에서 확인.'),
+        accountId: z
+            .string()
+            .regex(/^[a-z][a-z0-9-]{4,28}[a-z0-9]$/, 'lowercase, digits, hyphens; 6-30 chars')
+            .default('mimi-play-publisher')
+            .describe('서비스 계정 ID (기본: mimi-play-publisher)'),
+    }, async ({ packageName, projectId, accountId }) => {
+        const auth = await requireAuth();
+        const displayName = `Mimi Seed Play Publisher (${packageName})`;
+        // 1. 서비스 계정 생성 (이미 존재하면 409 → 이메일만 재구성)
+        let saEmail;
+        try {
+            const account = await iam.createServiceAccount(auth, projectId, accountId, displayName);
+            saEmail = account.email;
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            if (msg.includes('409') || msg.toLowerCase().includes('already exists')) {
+                saEmail = `${accountId}@${projectId}.iam.gserviceaccount.com`;
+            }
+            else {
+                throw err;
+            }
+        }
+        // 2. JSON 키 발급
+        const key = await iam.createServiceAccountKey(auth, saEmail);
+        // 3. 로컬 등록 (검증은 Play Console 초대 전이라 skip)
+        saveServiceAccountJsonForPackage(packageName, key.json);
+        return {
+            content: [{
+                    type: 'text',
+                    text: [
+                        `✅ Play Store 서비스 계정 설정 완료`,
+                        '',
+                        `**패키지**: \`${packageName}\``,
+                        `**SA 이메일**: \`${saEmail}\``,
+                        `**저장 경로**: \`~/.mimi-seed/play-service-accounts/${packageName}.json\``,
+                        '',
+                        '## 필수 수동 단계 — Play Console 초대',
+                        '1. https://play.google.com/console/developers 접속',
+                        '2. **설정 → 사용자 및 권한 → 새 사용자 초대**',
+                        `3. 이메일 입력: \`${saEmail}\``,
+                        '4. 권한: **앱 출시** 또는 **릴리스 관리자** 선택 → 초대 전송',
+                        '5. 권한 적용까지 약 5분 소요',
+                        '',
+                        '초대 완료 후 `playstore_verify_service_account` 로 연결 확인 가능합니다.',
+                    ].join('\n'),
+                }],
+        };
+    });
 }

package/package.json

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