@yoonion/mimi-seed-mcp 0.3.32 → 0.3.34

package/README.md

@@ -1,11 +1,11 @@
-# @yoonion/mimi-seed-mcp
-
+# @yoonion/mimi-seed-mcp
+
 **Mimi Seed** — Firebase · AdMob · Google Play · App Store Connect를 AI 콘솔에서 관리. Claude Code / Codex / Cursor / 기타 MCP 클라이언트에서 한 줄 등록으로 사용.
-
-> 이 패키지는 Mimi Seed의 **로컬 MCP 서버**만 포함합니다. 웹 콘솔(Next.js 앱)은 <https://mimi-seed.pryzm.gg/tool>.
-
-## 설치
-
+
+> 이 패키지는 Mimi Seed의 **로컬 MCP 서버**만 포함합니다. 웹 콘솔(Next.js 앱)은 <https://mimi-seed.pryzm.gg/tool>.
+
+## 설치
+
 Claude Code:
 
 ```bash
@@ -20,216 +20,216 @@ command = "npx"
 args = ["-y", "@yoonion/mimi-seed-mcp"]
 enabled = true
 ```
-
-Claude Desktop (`claude_desktop_config.json`):
-
-```json
-{
-  "mcpServers": {
-    "mimi-seed": {
-      "command": "npx",
-      "args": ["-y", "@yoonion/mimi-seed-mcp"]
-    }
-  }
-}
-```
-
-## 첫 사용 전 인증
-
-```bash
-npx -y @yoonion/mimi-seed-mcp mimi-seed-auth
-```
-
-브라우저가 열리면 Google 계정으로 로그인. 토큰은 `~/.mimi-seed/tokens.json`에 저장되고 자동 갱신됨.
-
-플랫폼별 추가 인증 (필요한 것만):
-
-```bash
-npx -y @yoonion/mimi-seed-mcp mimi-seed-appstore-auth    # App Store Connect (API Key)
-npx -y @yoonion/mimi-seed-mcp mimi-seed-playstore-auth   # Google Play 서비스 계정 JSON
-npx -y @yoonion/mimi-seed-mcp mimi-seed-bigquery-auth    # BigQuery (Crashlytics export 등)
-```
-
-- **App Store Connect**: Users and Access → Keys에서 API Key 생성 후 Issuer ID / Key ID / .p8 경로 입력 → `~/.mimi-seed/appstore.json`
-- **Google Play**: Play Console 서비스 계정 JSON 경로 입력 (패키지별 등록)
-- **BigQuery**: Google OAuth 또는 서비스 계정으로 데이터셋 조회 권한 부여
-
-AI 기능(릴리즈 노트 생성, 리뷰 답변)을 쓰려면:
-
-```bash
-export ANTHROPIC_API_KEY=sk-ant-...
-```
-
----
-
-## 제공 도구 (110+개)
-
-| 영역 | 도구 수 | 주요 도구 |
-|------|---------|-----------|
-| App Store Connect | 30 | `appstore_submit_for_review` / `appstore_upload_screenshot` / `appstore_update_whats_new` / `appstore_create_version` |
-| Google Play | 26 | `playstore_submit_release` / `playstore_promote_release` / `playstore_replace_images` / `playstore_reply_review` / `playstore_verify_service_account` |
-| Firebase | 17 | `firebase_create_android_app` / `firebase_get_android_config` / `firebase_create_ios_app` / `firebase_enable_service` |
-| AdMob | 7 | `admob_list_apps` / `admob_create_ad_unit` / `admob_get_today_earnings` / `admob_get_report` |
-| CI/CD (GitHub Actions · GitLab) | 6 | `ci_trigger_build` / `ci_get_build_status` / `ci_list_workflows` / `ci_cancel_build` |
-| Facebook | 6 | `facebook_post_photo` / `facebook_post_multi_photo` / `facebook_list_pages` |
-| Google Cloud IAM | 5 | `iam_create_service_account` / `iam_create_key` / `iam_add_iam_policy_binding` |
-| BigQuery | 5 | `bigquery_run_query` / `bigquery_list_datasets` / `bigquery_get_table_schema` |
-| 점검 / 위험 | 4 | `playstore_check_submission_risks` / `appstore_check_submission_risks` / `screenshot_validate` / `release_status` |
-| Instagram | 4 | `instagram_post_image` / `instagram_post_carousel` / `instagram_save_config` |
-| AI (Claude) | 2 | `generate_release_notes_from_commits` / `generate_review_reply` |
-| 인증 | 2 | `mimi_seed_auth_start` / `mimi_seed_auth_status` |
-
-> 인앱 결제(IAP·구독) 도구는 위 Play Store·App Store 카운트에 포함됩니다 — `playstore_create_subscription` · `appstore_create_inapp_purchase` 등 (`@onesub/providers` 위임).
-
----
-
-## 슬래시 커맨드 (MCP Prompts)
-
+
+Claude Desktop (`claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "mimi-seed": {
+      "command": "npx",
+      "args": ["-y", "@yoonion/mimi-seed-mcp"]
+    }
+  }
+}
+```
+
+## 첫 사용 전 인증
+
+```bash
+npx -y @yoonion/mimi-seed-mcp mimi-seed-auth
+```
+
+브라우저가 열리면 Google 계정으로 로그인. 토큰은 `~/.mimi-seed/tokens.json`에 저장되고 자동 갱신됨.
+
+플랫폼별 추가 인증 (필요한 것만):
+
+```bash
+npx -y @yoonion/mimi-seed-mcp mimi-seed-appstore-auth    # App Store Connect (API Key)
+npx -y @yoonion/mimi-seed-mcp mimi-seed-playstore-auth   # Google Play 서비스 계정 JSON
+npx -y @yoonion/mimi-seed-mcp mimi-seed-bigquery-auth    # BigQuery (Crashlytics export 등)
+```
+
+- **App Store Connect**: Users and Access → Keys에서 API Key 생성 후 Issuer ID / Key ID / .p8 경로 입력 → `~/.mimi-seed/appstore.json`
+- **Google Play**: Play Console 서비스 계정 JSON 경로 입력 (패키지별 등록)
+- **BigQuery**: Google OAuth 또는 서비스 계정으로 데이터셋 조회 권한 부여
+
+AI 기능(릴리즈 노트 생성, 리뷰 답변)을 쓰려면:
+
+```bash
+export ANTHROPIC_API_KEY=sk-ant-...
+```
+
+---
+
+## 제공 도구 (110+개)
+
+| 영역 | 도구 수 | 주요 도구 |
+|------|---------|-----------|
+| App Store Connect | 30 | `appstore_submit_for_review` / `appstore_upload_screenshot` / `appstore_update_whats_new` / `appstore_create_version` |
+| Google Play | 26 | `playstore_submit_release` / `playstore_promote_release` / `playstore_replace_images` / `playstore_reply_review` / `playstore_verify_service_account` |
+| Firebase | 17 | `firebase_create_android_app` / `firebase_get_android_config` / `firebase_create_ios_app` / `firebase_enable_service` |
+| AdMob | 7 | `admob_list_apps` / `admob_create_ad_unit` / `admob_get_today_earnings` / `admob_get_report` |
+| CI/CD (GitHub Actions · GitLab) | 6 | `ci_trigger_build` / `ci_get_build_status` / `ci_list_workflows` / `ci_cancel_build` |
+| Facebook | 6 | `facebook_post_photo` / `facebook_post_multi_photo` / `facebook_list_pages` |
+| Google Cloud IAM | 5 | `iam_create_service_account` / `iam_create_key` / `iam_add_iam_policy_binding` |
+| BigQuery | 5 | `bigquery_run_query` / `bigquery_list_datasets` / `bigquery_get_table_schema` |
+| 점검 / 위험 | 4 | `playstore_check_submission_risks` / `appstore_check_submission_risks` / `screenshot_validate` / `release_status` |
+| Instagram | 4 | `instagram_post_image` / `instagram_post_carousel` / `instagram_save_config` |
+| AI (Claude) | 2 | `generate_release_notes_from_commits` / `generate_review_reply` |
+| 인증 | 2 | `mimi_seed_auth_start` / `mimi_seed_auth_status` |
+
+> 인앱 결제(IAP·구독) 도구는 위 Play Store·App Store 카운트에 포함됩니다 — `playstore_create_subscription` · `appstore_create_inapp_purchase` 등 (`@onesub/providers` 위임).
+
+---
+
+## 슬래시 커맨드 (MCP Prompts)
+
 MCP 클라이언트(Claude Code, Codex 등)에서 슬래시 커맨드로 바로 노출됩니다.
-
-| 커맨드 | 설명 |
-|--------|------|
-| `/mimi-seed:deploy` | 블로커 점검 → 릴리즈 노트 생성 → 스토어 적용을 한 번에 |
-| `/mimi-seed:health` | 인증 상태 + 앱 출시 준비도 빠른 요약 |
-| `/mimi-seed:review-inbox` | 미답변 리뷰 조회 → AI 답변 초안 생성 |
-
-## MCP Resources
-
-| URI | 설명 |
-|-----|------|
-| `mimi-seed://auth/status` | Google OAuth 토큰 상태 (JSON) |
-| `mimi-seed://agent/guide` | 에이전트 역할 정의 — 출시 워크플로우·주의사항 (Markdown) |
-
----
-
-## 주요 기능
-
-### 제출 위험 점검
-
-출시 전 블로커와 경고를 자동으로 점검합니다.
-
-```
-"내 앱 출시 전 위험 요소 확인해줘"
-→ playstore_check_submission_risks("com.example.myapp")
-→ appstore_check_submission_risks("1234567890")
-```
-
-**점검 항목:**
-- Google Play: 리스팅 완성도(제목/설명/짧은설명), 스크린샷 수, 아이콘, 내부 빌드 존재, 연락처
-- App Store: What's New, 설명/키워드, 스크린샷 커버리지, TestFlight 빌드, 개인정보처리방침 URL
-
----
-
-### 스크린샷 해상도 검증
-
-업로드 전 로컬 파일을 스토어 규격과 비교합니다.
-
-```
-"이 스크린샷들이 App Store 규격에 맞는지 확인해줘"
-→ screenshot_validate(["/path/to/screen1.png", "/path/to/screen2.png"], platform="ios", displayType="APP_IPHONE_69")
-```
-
-iOS displayType 예시: `APP_IPHONE_69`, `APP_IPHONE_67`, `APP_IPHONE_65`, `APP_IPAD_PRO_3GEN_129`  
-Android imageType 예시: `phoneScreenshots`, `sevenInchScreenshots`, `featureGraphic`
-
----
-
-### AI 릴리즈 노트 생성 (ANTHROPIC_API_KEY 필요)
-
-git 커밋 내역을 Claude가 사용자 친화적인 릴리즈 노트로 변환합니다.
-
-```
-"최근 커밋으로 릴리즈 노트 만들어줘"
-→ generate_release_notes_from_commits(
-     commits=[{message: "feat: 다크모드 추가"}, ...],
-     appName="MyApp",
-     locales=["ko", "en-US", "ja"]
-   )
-```
-
-3가지 톤(간결/상세/마케팅) + 다국어를 한 번에 생성. 이후 `playstore_update_release_notes` 또는 `appstore_update_whats_new`로 바로 적용.
-
----
-
-### AI 리뷰 답변 생성 (ANTHROPIC_API_KEY 필요)
-
-스토어 리뷰에 대한 AI 답변 초안을 생성합니다.
-
-```
-"이 리뷰에 답변 작성해줘"
-→ generate_review_reply(
-     reviewText="앱이 자꾸 튕겨요",
-     rating=2,
-     appName="MyApp",
-     tone="empathetic",
-     language="ko"
-   )
-```
-
-tone 옵션: `friendly`(친근) / `professional`(정중) / `empathetic`(공감) / `brief`(간결)
-
-> ⚠ AI 생성 답변은 초안입니다. 게시 전 반드시 검토하세요.  
-> 답변 게시는 `playstore_reply_to_review` 도구를 사용하세요.
-
----
-
-## End-to-end: 서비스 계정 → JSON 키 → Play Console 권한
-
-서버(예: [onesub](https://github.com/jeonghwanko/onesub))가 Google Play 영수증을 백그라운드로 검증하려면 서비스 계정 JSON이 필요합니다. Claude에게 한 번에 시킬 수 있어요:
-
-> 1. `my-project`에 `onesub-play-verifier` 서비스 계정 만들고
-> 2. JSON 키 발급받아서
-> 3. `com.yourapp.id`에 대해 검증
-
-Claude가 연쇄 호출:
-
-- `iam_create_service_account("my-project", "onesub-play-verifier", "onesub Play verifier")`
-- `iam_create_key("onesub-play-verifier@my-project.iam.gserviceaccount.com")` → JSON 반환
-- `playstore_verify_service_account(<json>, "com.yourapp.id")` → 아직 Play Console 권한이 없어서 403 반환 기대
-
-그 다음 **Play Console에서 수동으로** (또는 별도 androidpublisher.users API 호출):
-
-- Users and permissions → 서비스 계정 이메일 초대
-- **View financial data, orders, and cancellation survey responses** 체크
-- **~5분 대기** 후 `playstore_verify_service_account` 재실행 → ✓
-
-마지막으로 JSON을 `GOOGLE_SERVICE_ACCOUNT_KEY` 서버 env에 넣으면 Play 영수증 검증 가능.
-
-> Cloud IAM 역할과 Play Console 권한은 다릅니다. `iam_add_iam_policy_binding`은 Cloud IAM 역할(예: `roles/iam.serviceAccountTokenCreator`)만 부여 — Play Console의 "View financial data"는 별도.
-
----
-
-## 환경변수
-
-| 변수 | 설명 |
-|------|------|
-| `ANTHROPIC_API_KEY` | AI 릴리즈 노트 생성 / 리뷰 답변 활성화 (선택) |
-
----
-
-## 레거시 호환성
-
-Preseed 시절(`~/.preseed/`) 데이터는 자동으로 이어받음:
-
-- `~/.preseed/tokens.json` 있으면 읽음 (재인증 불필요)
-- `~/.preseed/appstore.json`도 동일
-- 환경변수 `PRESEED_GOOGLE_CLIENT_ID` / `PRESEED_GOOGLE_CLIENT_SECRET` 계속 인식
-
-새로 쓰는 건 `~/.mimi-seed/`.
-
----
-
-## Links
-
-- CLI 패키지: [`mimi-seed`](https://www.npmjs.com/package/mimi-seed)
-- 웹 콘솔: <https://mimi-seed.pryzm.gg/tool>
-- 저장소: <https://github.com/jeonghwanko/mimi-seed>
-
----
-
-## License
-
-[PolyForm Noncommercial License 1.0.0](../../LICENSE) — 비상업적 사용만 허용.
-상업적 이용 문의: turbo08@gmail.com
-
-**Required Notice:** Copyright 2026 Pryzm GG (https://mimi-seed.pryzm.gg)
+
+| 커맨드 | 설명 |
+|--------|------|
+| `/mimi-seed:deploy` | 블로커 점검 → 릴리즈 노트 생성 → 스토어 적용을 한 번에 |
+| `/mimi-seed:health` | 인증 상태 + 앱 출시 준비도 빠른 요약 |
+| `/mimi-seed:review-inbox` | 미답변 리뷰 조회 → AI 답변 초안 생성 |
+
+## MCP Resources
+
+| URI | 설명 |
+|-----|------|
+| `mimi-seed://auth/status` | Google OAuth 토큰 상태 (JSON) |
+| `mimi-seed://agent/guide` | 에이전트 역할 정의 — 출시 워크플로우·주의사항 (Markdown) |
+
+---
+
+## 주요 기능
+
+### 제출 위험 점검
+
+출시 전 블로커와 경고를 자동으로 점검합니다.
+
+```
+"내 앱 출시 전 위험 요소 확인해줘"
+→ playstore_check_submission_risks("com.example.myapp")
+→ appstore_check_submission_risks("1234567890")
+```
+
+**점검 항목:**
+- Google Play: 리스팅 완성도(제목/설명/짧은설명), 스크린샷 수, 아이콘, 내부 빌드 존재, 연락처
+- App Store: What's New, 설명/키워드, 스크린샷 커버리지, TestFlight 빌드, 개인정보처리방침 URL
+
+---
+
+### 스크린샷 해상도 검증
+
+업로드 전 로컬 파일을 스토어 규격과 비교합니다.
+
+```
+"이 스크린샷들이 App Store 규격에 맞는지 확인해줘"
+→ screenshot_validate(["/path/to/screen1.png", "/path/to/screen2.png"], platform="ios", displayType="APP_IPHONE_69")
+```
+
+iOS displayType 예시: `APP_IPHONE_69`, `APP_IPHONE_67`, `APP_IPHONE_65`, `APP_IPAD_PRO_3GEN_129`  
+Android imageType 예시: `phoneScreenshots`, `sevenInchScreenshots`, `featureGraphic`
+
+---
+
+### AI 릴리즈 노트 생성 (ANTHROPIC_API_KEY 필요)
+
+git 커밋 내역을 Claude가 사용자 친화적인 릴리즈 노트로 변환합니다.
+
+```
+"최근 커밋으로 릴리즈 노트 만들어줘"
+→ generate_release_notes_from_commits(
+     commits=[{message: "feat: 다크모드 추가"}, ...],
+     appName="MyApp",
+     locales=["ko", "en-US", "ja"]
+   )
+```
+
+3가지 톤(간결/상세/마케팅) + 다국어를 한 번에 생성. 이후 `playstore_update_release_notes` 또는 `appstore_update_whats_new`로 바로 적용.
+
+---
+
+### AI 리뷰 답변 생성 (ANTHROPIC_API_KEY 필요)
+
+스토어 리뷰에 대한 AI 답변 초안을 생성합니다.
+
+```
+"이 리뷰에 답변 작성해줘"
+→ generate_review_reply(
+     reviewText="앱이 자꾸 튕겨요",
+     rating=2,
+     appName="MyApp",
+     tone="empathetic",
+     language="ko"
+   )
+```
+
+tone 옵션: `friendly`(친근) / `professional`(정중) / `empathetic`(공감) / `brief`(간결)
+
+> ⚠ AI 생성 답변은 초안입니다. 게시 전 반드시 검토하세요.  
+> 답변 게시는 `playstore_reply_review` 도구를 사용하세요.
+
+---
+
+## End-to-end: 서비스 계정 → JSON 키 → Play Console 권한
+
+서버(예: [onesub](https://github.com/jeonghwanko/onesub))가 Google Play 영수증을 백그라운드로 검증하려면 서비스 계정 JSON이 필요합니다. Claude에게 한 번에 시킬 수 있어요:
+
+> 1. `my-project`에 `onesub-play-verifier` 서비스 계정 만들고
+> 2. JSON 키 발급받아서
+> 3. `com.yourapp.id`에 대해 검증
+
+Claude가 연쇄 호출:
+
+- `iam_create_service_account("my-project", "onesub-play-verifier", "onesub Play verifier")`
+- `iam_create_key("onesub-play-verifier@my-project.iam.gserviceaccount.com")` → JSON 반환
+- `playstore_verify_service_account(<json>, "com.yourapp.id")` → 아직 Play Console 권한이 없어서 403 반환 기대
+
+그 다음 **Play Console에서 수동으로** (또는 별도 androidpublisher.users API 호출):
+
+- Users and permissions → 서비스 계정 이메일 초대
+- **View financial data, orders, and cancellation survey responses** 체크
+- **~5분 대기** 후 `playstore_verify_service_account` 재실행 → ✓
+
+마지막으로 JSON을 `GOOGLE_SERVICE_ACCOUNT_KEY` 서버 env에 넣으면 Play 영수증 검증 가능.
+
+> Cloud IAM 역할과 Play Console 권한은 다릅니다. `iam_add_iam_policy_binding`은 Cloud IAM 역할(예: `roles/iam.serviceAccountTokenCreator`)만 부여 — Play Console의 "View financial data"는 별도.
+
+---
+
+## 환경변수
+
+| 변수 | 설명 |
+|------|------|
+| `ANTHROPIC_API_KEY` | AI 릴리즈 노트 생성 / 리뷰 답변 활성화 (선택) |
+
+---
+
+## 레거시 호환성
+
+Preseed 시절(`~/.preseed/`) 데이터는 자동으로 이어받음:
+
+- `~/.preseed/tokens.json` 있으면 읽음 (재인증 불필요)
+- `~/.preseed/appstore.json`도 동일
+- 환경변수 `PRESEED_GOOGLE_CLIENT_ID` / `PRESEED_GOOGLE_CLIENT_SECRET` 계속 인식
+
+새로 쓰는 건 `~/.mimi-seed/`.
+
+---
+
+## Links
+
+- CLI 패키지: [`mimi-seed`](https://www.npmjs.com/package/mimi-seed)
+- 웹 콘솔: <https://mimi-seed.pryzm.gg/tool>
+- 저장소: <https://github.com/jeonghwanko/mimi-seed>
+
+---
+
+## License
+
+[PolyForm Noncommercial License 1.0.0](../../LICENSE) — 비상업적 사용만 허용.
+상업적 이용 문의: turbo08@gmail.com
+
+**Required Notice:** Copyright 2026 Pryzm GG (https://mimi-seed.pryzm.gg)

package/dist/ai/review.js

@@ -55,6 +55,6 @@ export function formatReviewReply(result) {
         '',
         `⚠ ${result.note}`,
         '',
-        '이 답변이 마음에 들면 playstore_reply_to_review 도구로 게시하세요.',
+        '이 답변이 마음에 들면 playstore_reply_review 도구로 게시하세요.',
     ].join('\n');
 }

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/prompts.js

@@ -61,7 +61,7 @@ export function registerPrompts(server) {
                         '3. 각 리뷰에 generate_review_reply 로 답변 초안 생성',
                         `   톤: ${tone ?? 'empathetic'}`,
                         '4. 초안 보여주고 게시 여부 확인 (비가역 — 반드시 동의 받을 것)',
-                        '5. 확인 후 playstore_reply_to_review 로 게시',
+                        '5. 확인 후 playstore_reply_review 로 게시',
                         '',
                         '⚠️ AI 생성 답변은 초안입니다. 게시 전 반드시 검토하세요.',
                     ].join('\n'),

package/dist/registers/ai.js

@@ -32,7 +32,7 @@ export function registerAiTools(server) {
         'tone: friendly(친근) / professional(정중) / empathetic(공감) / brief(간결) — 기본: friendly',
         'language: ko / en / ja / zh 등 — 기본: ko',
         '⚠ 생성된 답변은 초안입니다. 게시 전 반드시 검토하세요.',
-        '답변 게시는 playstore_reply_to_review 도구를 사용하세요.',
+        '답변 게시는 playstore_reply_review 도구를 사용하세요.',
     ].join(' '), {
         reviewText: z.string().describe('리뷰 원문'),
         rating: z.number().min(1).max(5).optional().describe('별점 (1~5)'),

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/resources.js

@@ -44,7 +44,7 @@ export function registerResources(server) {
                     '',
                     '- `playstore_submit_release(status=completed)` — 비가역, 반드시 명시 동의 필요',
                     '- `appstore_submit_for_review` — 비가역, 반드시 명시 동의 필요',
-                    '- `playstore_reply_to_review` — 공개 게시, 반드시 검토 후 동의 필요',
+                    '- `playstore_reply_review` — 공개 게시, 반드시 검토 후 동의 필요',
                 ].join('\n'),
             }],
     }));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yoonion/mimi-seed-mcp",
-  "version": "0.3.32",
+  "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": {