@yoonion/mimi-seed-mcp 0.3.27 → 0.3.28

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/README.md

@@ -1,192 +1,235 @@
-# @yoonion/mimi-seed-mcp
-
-**Mimi Seed** — Firebase · AdMob · Google Play · App Store Connect를 AI 콘솔에서 관리. Claude Code / Cursor / 기타 MCP 클라이언트에서 한 줄 등록으로 사용.
-
-> 이 패키지는 Mimi Seed의 **로컬 MCP 서버**만 포함합니다. 웹 콘솔(Next.js 앱)은 <https://mimi-seed.pryzm.gg>.
-
-## 설치
-
+# @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>.
+
+## 설치
+
 Claude Code:
 
 ```bash
 claude mcp add mimi-seed -- npx -y @yoonion/mimi-seed-mcp
 ```
 
-Claude Desktop (`claude_desktop_config.json`):
-
-```json
-{
-  "mcpServers": {
-    "mimi-seed": {
-      "command": "npx",
-      "args": ["-y", "@yoonion/mimi-seed-mcp"]
-    }
-  }
-}
-```
-
-## 첫 사용 전 인증
+Codex (`~/.codex/config.toml`):
 
-```bash
-npx -y @yoonion/mimi-seed-mcp mimi-seed-auth
+```toml
+[mcp_servers.mimi-seed]
+command = "npx"
+args = ["-y", "@yoonion/mimi-seed-mcp"]
+enabled = true
 ```
-
-브라우저가 열리면 Google 계정으로 로그인. 토큰은 `~/.mimi-seed/tokens.json`에 저장되고 자동 갱신됨.
-
-App Store Connect까지 쓰려면 별도로:
-
-```bash
-npx -y @yoonion/mimi-seed-mcp mimi-seed-appstore-auth
-```
-
-(App Store Connect → Users and Access → Keys에서 API Key 생성 후 Issuer ID / Key ID / .p8 경로 입력)
-
-AI 기능(릴리즈 노트 생성, 리뷰 답변)을 쓰려면:
-
-```bash
-export ANTHROPIC_API_KEY=sk-ant-...
-```
-
----
-
-## 제공 도구 (65+개)
-
-| 영역 | 주요 도구 |
-|------|---------|
-| Firebase | `firebase_list_projects` / `firebase_create_android_app` / `firebase_get_android_config` / `firebase_enable_service` |
-| AdMob | `admob_list_apps` / `admob_create_ad_unit` / `admob_get_today_earnings` / `admob_get_report` |
-| Google Play | `playstore_list_tracks` / `playstore_update_listing` / `playstore_replace_images` / `playstore_reply_review` / `playstore_verify_service_account` |
-| 인앱 결제 | `playstore_create_onetime_product` / `playstore_create_subscription` / `appstore_create_inapp_purchase` / `appstore_create_subscription` |
-| Google Cloud IAM | `iam_list_service_accounts` / `iam_create_service_account` / `iam_list_keys` / `iam_create_key` / `iam_add_iam_policy_binding` |
-| App Store Connect | `appstore_list_apps` / `appstore_list_builds` / `appstore_upload_screenshot` / `appstore_update_whats_new` |
-| 제출 위험 점검 | `playstore_check_submission_risks` / `appstore_check_submission_risks` |
-| 스크린샷 검증 | `screenshot_validate` |
-| AI (Claude) | `generate_release_notes_from_commits` / `generate_review_reply` |
-| 인증 | `mimi_seed_auth_status` / `mimi_seed_auth_start` |
-
----
-
-## 주요 기능
-
-### 제출 위험 점검
-
-출시 전 블로커와 경고를 자동으로 점검합니다.
-
-```
-"내 앱 출시 전 위험 요소 확인해줘"
-→ 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
-- 저장소: https://github.com/jeonghwanko/mimi-seed
-
-MIT © jeonghwanko
+
+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)

package/dist/appstore/setup-cli.js

@@ -42,7 +42,7 @@ async function main() {
     console.log('');
     console.log('  ✅ 연결 완료!');
     console.log('');
-    console.log('  이제 Claude Code에서:');
+    console.log('  이제 Claude Code 또는 Codex에서:');
     console.log('    "내 앱스토어 앱 목록 보여줘"');
     console.log('    "TestFlight 빌드 목록 보여줘"');
     console.log('');

package/dist/auth/bigquery-setup-cli.js

@@ -83,7 +83,7 @@ async function main() {
         }
     }
     console.log('');
-    console.log('  이제 Claude Code 에서:');
+    console.log('  이제 Claude Code 또는 Codex에서:');
     console.log('    "BigQuery 로 GA4 트래픽 분석해줘"');
     console.log('');
     rl.close();

package/dist/auth/cli.js

@@ -216,7 +216,7 @@ async function cmdLogin() {
     err('');
     err('  ✅ 연결 완료!');
     err('');
-    err('  이제 Claude Code에서 이렇게 쓸 수 있어:');
+    err('  이제 Claude Code 또는 Codex에서 이렇게 쓸 수 있어:');
     err('    "내 Firebase 프로젝트 보여줘"');
     err('    "새 Android 앱 등록해줘"');
     err('    "google-services.json 다운로드해줘"');

package/dist/auth/google-auth.js

@@ -214,7 +214,7 @@ export function startAuth(clientId, clientSecret, options = {}) {
           <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로 돌아가세요.</p>
+              <p>이 창을 닫고 Claude Code 또는 Codex로 돌아가세요.</p>
             </div>
           </body></html>
         `);

package/dist/auth/playstore-setup-cli.js

@@ -55,7 +55,7 @@ async function main() {
     console.log('');
     console.log(`  ✅ 저장 완료! (${parsed.client_email})`);
     console.log('');
-    console.log('  이제 Claude Code에서:');
+    console.log('  이제 Claude Code 또는 Codex에서:');
     console.log('    "내 Play 스토어 앱 리스팅 보여줘"');
     console.log('    "Play 구독 상품 목록 보여줘"');
     console.log('');

package/dist/googleads/config.d.ts

@@ -0,0 +1,10 @@
+export interface GoogleAdsConfig {
+    developerToken: string;
+    customerId: string;
+    loginCustomerId?: string;
+}
+/** 하이픈 제거 (API는 숫자만 허용) */
+export declare function normalizeCustomerId(id: string): string;
+export declare function saveConfig(cfg: GoogleAdsConfig): void;
+export declare function loadConfig(): GoogleAdsConfig | null;
+export declare function requireConfig(): GoogleAdsConfig;

package/dist/googleads/config.js

@@ -0,0 +1,45 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+const CONFIG_DIR = path.join(os.homedir(), '.mimi-seed');
+const CONFIG_PATH = path.join(CONFIG_DIR, 'google-ads.json');
+function ensureDir() {
+    if (!fs.existsSync(CONFIG_DIR))
+        fs.mkdirSync(CONFIG_DIR, { recursive: true });
+}
+/** 하이픈 제거 (API는 숫자만 허용) */
+export function normalizeCustomerId(id) {
+    return id.replace(/-/g, '');
+}
+export function saveConfig(cfg) {
+    ensureDir();
+    const normalized = {
+        ...cfg,
+        customerId: normalizeCustomerId(cfg.customerId),
+        loginCustomerId: cfg.loginCustomerId ? normalizeCustomerId(cfg.loginCustomerId) : undefined,
+    };
+    fs.writeFileSync(CONFIG_PATH, JSON.stringify(normalized, null, 2), { mode: 0o600 });
+}
+export function loadConfig() {
+    if (!fs.existsSync(CONFIG_PATH))
+        return null;
+    try {
+        return JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+export function requireConfig() {
+    const cfg = loadConfig();
+    if (!cfg) {
+        throw new Error([
+            '❌ Google Ads 설정이 없어.',
+            '',
+            'googleads_save_config 도구로 먼저 설정해줘:',
+            '  - developerToken: Google Ads 콘솔 → 관리자 → API 센터에서 발급',
+            '  - customerId: Google Ads 계정 ID (예: 123-456-7890)',
+        ].join('\n'));
+    }
+    return cfg;
+}

package/dist/googleads/tools.d.ts

@@ -0,0 +1,48 @@
+import type { OAuth2Client } from 'google-auth-library';
+import type { GoogleAdsConfig } from './config.js';
+export interface DateRange {
+    startDate: string;
+    endDate: string;
+}
+export declare function listAccessibleCustomers(auth: OAuth2Client, cfg: GoogleAdsConfig): Promise<any>;
+export declare function listCampaigns(auth: OAuth2Client, cfg: GoogleAdsConfig): Promise<{
+    id: any;
+    name: any;
+    status: any;
+    channelType: any;
+    channelSubType: any;
+    startDate: any;
+    endDate: any;
+    dailyBudget: number;
+}[]>;
+export declare function getCampaignReport(auth: OAuth2Client, cfg: GoogleAdsConfig, range: DateRange): Promise<{
+    id: any;
+    name: any;
+    status: any;
+    channelType: any;
+    channelSubType: any;
+    clicks: number;
+    impressions: number;
+    cost: number;
+    conversions: number;
+    conversionsValue: number;
+    cpi: number;
+    ctr: number;
+    avgCpc: number;
+}[]>;
+export declare function getUacReport(auth: OAuth2Client, cfg: GoogleAdsConfig, range: DateRange): Promise<{
+    id: string;
+    name: string;
+    status: string;
+    subType: string;
+    clicks: number;
+    impressions: number;
+    cost: number;
+    installs: number;
+    installsValue: number;
+    cpi: number;
+    dateRange: {
+        from: string;
+        to: string;
+    };
+}[]>;

package/dist/googleads/tools.js

@@ -0,0 +1,221 @@
+const API_VERSION = 'v17';
+const BASE = `https://googleads.googleapis.com/${API_VERSION}`;
+// ─── 내부 헬퍼 ───────────────────────────────────────────────
+async function getAccessToken(auth) {
+    const token = await auth.getAccessToken();
+    if (!token.token)
+        throw new Error('OAuth 토큰을 가져올 수 없음. 재인증 필요.');
+    return token.token;
+}
+function buildHeaders(accessToken, cfg) {
+    const headers = {
+        Authorization: `Bearer ${accessToken}`,
+        'developer-token': cfg.developerToken,
+        'Content-Type': 'application/json',
+    };
+    if (cfg.loginCustomerId) {
+        headers['login-customer-id'] = cfg.loginCustomerId;
+    }
+    return headers;
+}
+/** search 엔드포인트 (paged JSON, searchStream보다 안정적) */
+async function search(auth, cfg, query) {
+    const accessToken = await getAccessToken(auth);
+    const url = `${BASE}/customers/${cfg.customerId}/googleAds:search`;
+    const all = [];
+    let pageToken;
+    do {
+        const body = { query, pageSize: 1000 };
+        if (pageToken)
+            body.pageToken = pageToken;
+        const res = await fetch(url, {
+            method: 'POST',
+            headers: buildHeaders(accessToken, cfg),
+            body: JSON.stringify(body),
+        });
+        const text = await res.text();
+        if (!res.ok) {
+            let msg = `Google Ads API ${res.status}`;
+            try {
+                const err = JSON.parse(text);
+                const detail = err?.error?.message ?? err?.[0]?.error?.message ?? text;
+                msg += `: ${detail}`;
+            }
+            catch {
+                msg += `: ${text.slice(0, 300)}`;
+            }
+            throw new Error(msg);
+        }
+        const json = JSON.parse(text);
+        all.push(...(json.results ?? []));
+        pageToken = json.nextPageToken ?? undefined;
+    } while (pageToken);
+    return all;
+}
+function microsToCurrency(micros) {
+    if (micros == null)
+        return 0;
+    return Number(micros) / 1_000_000;
+}
+// ─── 접근 가능한 고객 목록 (API 연결 확인용) ─────────────────────
+export async function listAccessibleCustomers(auth, cfg) {
+    const accessToken = await getAccessToken(auth);
+    const url = `${BASE}/customers:listAccessibleCustomers`;
+    const res = await fetch(url, {
+        method: 'GET',
+        headers: buildHeaders(accessToken, cfg),
+    });
+    const text = await res.text();
+    if (!res.ok) {
+        let msg = `Google Ads API ${res.status}`;
+        try {
+            const err = JSON.parse(text);
+            msg += `: ${err?.error?.message ?? text.slice(0, 300)}`;
+        }
+        catch {
+            msg += `: ${text.slice(0, 300)}`;
+        }
+        throw new Error(msg);
+    }
+    return JSON.parse(text);
+}
+// ─── 캠페인 목록 ─────────────────────────────────────────────
+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 rows = await search(auth, cfg, query);
+    return rows.map((r) => ({
+        id: r.campaign?.id,
+        name: r.campaign?.name,
+        status: r.campaign?.status,
+        channelType: r.campaign?.advertisingChannelType,
+        channelSubType: r.campaign?.advertisingChannelSubType,
+        startDate: r.campaign?.startDate,
+        endDate: r.campaign?.endDate,
+        dailyBudget: microsToCurrency(r.campaignBudget?.amountMicros),
+    }));
+}
+// ─── 캠페인 성과 리포트 ────────────────────────────────────────
+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 rows = await search(auth, cfg, query);
+    return rows.map((r) => ({
+        id: r.campaign?.id,
+        name: r.campaign?.name,
+        status: r.campaign?.status,
+        channelType: r.campaign?.advertisingChannelType,
+        channelSubType: r.campaign?.advertisingChannelSubType,
+        clicks: Number(r.metrics?.clicks ?? 0),
+        impressions: Number(r.metrics?.impressions ?? 0),
+        cost: microsToCurrency(r.metrics?.costMicros),
+        conversions: Number(r.metrics?.conversions ?? 0),
+        conversionsValue: Number(r.metrics?.conversionsValue ?? 0),
+        cpi: microsToCurrency(r.metrics?.costPerConversion),
+        ctr: Number(r.metrics?.ctr ?? 0),
+        avgCpc: microsToCurrency(r.metrics?.averageCpc),
+    }));
+}
+// ─── 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 rows = await search(auth, cfg, query);
+    const byId = new Map();
+    for (const r of rows) {
+        const id = String(r.campaign?.id ?? '');
+        const existing = byId.get(id);
+        const cost = microsToCurrency(r.metrics?.costMicros);
+        const installs = Number(r.metrics?.conversions ?? 0);
+        if (existing) {
+            existing.clicks += Number(r.metrics?.clicks ?? 0);
+            existing.impressions += Number(r.metrics?.impressions ?? 0);
+            existing.cost += cost;
+            existing.installs += installs;
+            existing.installsValue += Number(r.metrics?.conversionsValue ?? 0);
+            if (r.segments?.date)
+                existing.dates.push(r.segments.date);
+        }
+        else {
+            byId.set(id, {
+                id,
+                name: r.campaign?.name ?? '',
+                status: r.campaign?.status ?? '',
+                subType: r.campaign?.advertisingChannelSubType ?? '',
+                clicks: Number(r.metrics?.clicks ?? 0),
+                impressions: Number(r.metrics?.impressions ?? 0),
+                cost,
+                installs,
+                installsValue: Number(r.metrics?.conversionsValue ?? 0),
+                dates: r.segments?.date ? [r.segments.date] : [],
+            });
+        }
+    }
+    return Array.from(byId.values()).map((c) => ({
+        id: c.id,
+        name: c.name,
+        status: c.status,
+        subType: c.subType,
+        clicks: c.clicks,
+        impressions: c.impressions,
+        cost: c.cost,
+        installs: c.installs,
+        installsValue: c.installsValue,
+        cpi: c.installs > 0 ? c.cost / c.installs : 0,
+        dateRange: {
+            from: c.dates.length ? [...c.dates].sort()[0] : range.startDate,
+            to: c.dates.length ? [...c.dates].sort().reverse()[0] : range.endDate,
+        },
+    }));
+}

package/dist/index.js

@@ -13,6 +13,7 @@ import { registerAuthTools } from './registers/auth.js';
 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 { registerPrompts } from './prompts.js';
 import { registerResources } from './resources.js';
 const server = new McpServer({
@@ -31,6 +32,7 @@ registerAuthTools(server);
 registerCiTools(server);
 registerInstagramTools(server);
 registerFacebookTools(server);
+registerGoogleAdsTools(server);
 registerPrompts(server);
 registerResources(server);
 // `npx -y @yoonion/mimi-seed-mcp <subcommand>` 처리.

package/dist/playstore/tools.d.ts

@@ -8,7 +8,22 @@ export type PlayImageType = 'featureGraphic' | 'icon' | 'phoneScreenshots' | 'pr
  * 여기서는 기존 앱의 메타데이터, 빌드, 출시를 관리.
  */
 export declare const publisher: () => import("googleapis").androidpublisher_v3.Androidpublisher;
+export type PlayVitalsMetricSet = 'anrRate' | 'crashRate' | 'errorCount';
+export interface PlayStatisticsQuery {
+    metricSet?: PlayVitalsMetricSet;
+    startDate: string;
+    endDate: string;
+    aggregationPeriod?: 'DAILY' | 'HOURLY';
+    dimensions?: string[];
+    metrics?: string[];
+    filter?: string;
+    pageSize?: number;
+    pageToken?: string;
+    userCohort?: 'OS_PUBLIC' | 'APP_TESTERS' | 'OS_BETA';
+    timeZone?: string;
+}
 export declare function withEdit<T>(auth: OAuth2Client | JWT, packageName: string, fn: (editId: string) => Promise<T>, commit?: boolean): Promise<T>;
+export declare function getStatistics(auth: OAuth2Client | JWT, packageName: string, query: PlayStatisticsQuery): Promise<unknown>;
 export declare function getAppDetails(auth: OAuth2Client | JWT, packageName: string): Promise<import("googleapis").androidpublisher_v3.Schema$AppDetails>;
 export declare function getListing(auth: OAuth2Client | JWT, packageName: string, language?: string): Promise<import("googleapis").androidpublisher_v3.Schema$Listing>;
 export declare function updateListing(auth: OAuth2Client | JWT, packageName: string, language: string, data: {

package/dist/playstore/tools.js

@@ -18,6 +18,28 @@ function mimeTypeFor(filePath) {
  * 여기서는 기존 앱의 메타데이터, 빌드, 출시를 관리.
  */
 export const publisher = () => google.androidpublisher('v3');
+const REPORTING_API_BASE = 'https://playdeveloperreporting.googleapis.com/v1beta1';
+const METRIC_SET_RESOURCE = {
+    anrRate: 'anrRateMetricSet',
+    crashRate: 'crashRateMetricSet',
+    errorCount: 'errorCountMetricSet',
+};
+const DEFAULT_METRICS = {
+    anrRate: ['anrRate', 'userPerceivedAnrRate', 'distinctUsers'],
+    crashRate: ['crashRate', 'userPerceivedCrashRate', 'distinctUsers'],
+    errorCount: ['errorReportCount', 'distinctUsers'],
+};
+function dateToReportingDateTime(date, timeZone) {
+    const match = /^(\d{4})-(\d{2})-(\d{2})$/.exec(date);
+    if (!match)
+        throw new Error(`날짜는 YYYY-MM-DD 형식이어야 해: ${date}`);
+    return {
+        year: Number(match[1]),
+        month: Number(match[2]),
+        day: Number(match[3]),
+        timeZone: { id: timeZone },
+    };
+}
 export async function withEdit(auth, packageName, fn, commit = false) {
     const res = await publisher().edits.insert({ auth, packageName });
     const editId = res.data.id;
@@ -36,6 +58,31 @@ export async function withEdit(auth, packageName, fn, commit = false) {
         }
     }
 }
+// ─── Play Developer Reporting API / Android vitals ───
+export async function getStatistics(auth, packageName, query) {
+    const metricSet = query.metricSet ?? 'anrRate';
+    const resource = METRIC_SET_RESOURCE[metricSet];
+    const timeZone = query.timeZone ?? 'America/Los_Angeles';
+    const url = `${REPORTING_API_BASE}/apps/${encodeURIComponent(packageName)}/${resource}:query`;
+    const res = await auth.request({
+        url,
+        method: 'POST',
+        data: {
+            timelineSpec: {
+                aggregationPeriod: query.aggregationPeriod ?? 'DAILY',
+                startTime: dateToReportingDateTime(query.startDate, timeZone),
+                endTime: dateToReportingDateTime(query.endDate, timeZone),
+            },
+            dimensions: query.dimensions ?? ['versionCode'],
+            metrics: query.metrics ?? DEFAULT_METRICS[metricSet],
+            ...(query.filter ? { filter: query.filter } : {}),
+            ...(query.pageSize ? { pageSize: query.pageSize } : {}),
+            ...(query.pageToken ? { pageToken: query.pageToken } : {}),
+            ...(query.userCohort ? { userCohort: query.userCohort } : {}),
+        },
+    });
+    return res.data;
+}
 // ─── 앱 목록 ───
 export async function getAppDetails(auth, packageName) {
     return withEdit(auth, packageName, async (editId) => {

package/dist/registers/googleads.d.ts

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

package/dist/registers/googleads.js

@@ -0,0 +1,120 @@
+import { z } from 'zod';
+import { requireAuth } from '../helpers.js';
+import { saveConfig, loadConfig, requireConfig } from '../googleads/config.js';
+import * as googleads from '../googleads/tools.js';
+export function registerGoogleAdsTools(server) {
+    server.tool('googleads_save_config', 'Google Ads API 설정 저장 (Developer Token + 계정 ID). 최초 1회만 필요.', {
+        developerToken: z.string().describe('Google Ads 콘솔 → 관리자 → API 센터에서 발급한 Developer Token'),
+        customerId: z.string().describe('Google Ads 계정 ID (예: 123-456-7890)'),
+        loginCustomerId: z.string().optional().describe('MCC(관리자) 계정 ID — 하위 계정 접근 시 필요'),
+    }, async ({ developerToken, customerId, loginCustomerId }) => {
+        saveConfig({ developerToken, customerId, loginCustomerId });
+        return {
+            content: [{
+                    type: 'text',
+                    text: [
+                        '✅ Google Ads 설정 저장 완료.',
+                        `  customerId: ${customerId}`,
+                        loginCustomerId ? `  loginCustomerId: ${loginCustomerId}` : '',
+                        '',
+                        '이제 googleads_list_campaigns 나 googleads_get_uac_report 를 사용할 수 있어.',
+                        '',
+                        '⚠️  Google Ads API는 adwords OAuth 스코프가 필요해.',
+                        '기존 토큰에 스코프가 없으면 npx -y @yoonion/mimi-seed-mcp mimi-seed-auth 로 재인증해줘.',
+                    ].filter(Boolean).join('\n'),
+                }],
+        };
+    });
+    server.tool('googleads_list_campaigns', 'Google Ads 캠페인 목록 조회 (상태, 채널 타입, 일일 예산 포함)', {}, async () => {
+        const auth = requireAuth();
+        const cfg = requireConfig();
+        const campaigns = await googleads.listCampaigns(auth, cfg);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(campaigns, null, 2),
+                }],
+        };
+    });
+    server.tool('googleads_get_campaign_report', '기간별 캠페인 성과 리포트 (클릭, 노출, 비용, 전환수, CPI, CTR)', {
+        startDate: z.string().describe('시작일 (YYYY-MM-DD)'),
+        endDate: z.string().describe('종료일 (YYYY-MM-DD)'),
+    }, async ({ startDate, endDate }) => {
+        const auth = requireAuth();
+        const cfg = requireConfig();
+        const report = await googleads.getCampaignReport(auth, cfg, { startDate, endDate });
+        const totalCost = report.reduce((s, r) => s + r.cost, 0);
+        const totalClicks = report.reduce((s, r) => s + r.clicks, 0);
+        const totalImpressions = report.reduce((s, r) => s + r.impressions, 0);
+        const totalConversions = report.reduce((s, r) => s + r.conversions, 0);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        period: { startDate, endDate },
+                        summary: {
+                            totalCost: Math.round(totalCost * 100) / 100,
+                            totalClicks,
+                            totalImpressions,
+                            totalConversions,
+                            avgCpi: totalConversions > 0 ? Math.round(totalCost / totalConversions * 100) / 100 : null,
+                        },
+                        campaigns: report,
+                    }, null, 2),
+                }],
+        };
+    });
+    server.tool('googleads_get_uac_report', '앱 캠페인(UAC) 리포트 — 앱 설치 캠페인별 설치수, CPI, ROAS 집계', {
+        startDate: z.string().describe('시작일 (YYYY-MM-DD)'),
+        endDate: z.string().describe('종료일 (YYYY-MM-DD)'),
+    }, async ({ startDate, endDate }) => {
+        const auth = requireAuth();
+        const cfg = requireConfig();
+        const report = await googleads.getUacReport(auth, cfg, { startDate, endDate });
+        const totalCost = report.reduce((s, r) => s + r.cost, 0);
+        const totalInstalls = report.reduce((s, r) => s + r.installs, 0);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        period: { startDate, endDate },
+                        summary: {
+                            totalCost: Math.round(totalCost * 100) / 100,
+                            totalInstalls,
+                            avgCpi: totalInstalls > 0 ? Math.round(totalCost / totalInstalls * 100) / 100 : null,
+                            campaignCount: report.length,
+                        },
+                        campaigns: report,
+                    }, null, 2),
+                }],
+        };
+    });
+    server.tool('googleads_list_accessible_customers', 'OAuth 토큰으로 접근 가능한 Google Ads 계정 목록 (API 연결 확인용)', {}, async () => {
+        const auth = requireAuth();
+        const cfg = requireConfig();
+        const result = await googleads.listAccessibleCustomers(auth, cfg);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+    server.tool('googleads_config_status', 'Google Ads 연동 설정 현황 확인', {}, async () => {
+        const cfg = loadConfig();
+        if (!cfg) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: '❌ Google Ads 설정 없음. googleads_save_config 로 먼저 설정해.',
+                    }],
+            };
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        status: 'configured',
+                        customerId: cfg.customerId,
+                        loginCustomerId: cfg.loginCustomerId ?? null,
+                        hasDeveloperToken: !!cfg.developerToken,
+                    }, null, 2),
+                }],
+        };
+    });
+}

package/dist/registers/playstore.js

@@ -37,6 +37,45 @@ export function registerPlaystoreTools(server) {
         const tracks = await playstore.listTracks(auth, packageName);
         return { content: [{ type: 'text', text: JSON.stringify(tracks, null, 2) }] };
     });
+    server.tool('playstore_get_statistics', 'Google Play Developer Reporting API / Android vitals 통계 조회. ANR/Crash/Error count를 기간·버전·기기·국가 등으로 분해해 확인', {
+        packageName: z.string().describe('패키지명 (예: gg.pryzm.coffee)'),
+        metricSet: z.enum(['anrRate', 'crashRate', 'errorCount'])
+            .default('anrRate')
+            .describe('조회할 Vitals metric set. 기본: anrRate'),
+        startDate: z.string().describe('시작일 YYYY-MM-DD (포함)'),
+        endDate: z.string().describe('종료일 YYYY-MM-DD (보통 exclusive처럼 다음날 지정 권장)'),
+        aggregationPeriod: z.enum(['DAILY', 'HOURLY']).default('DAILY').describe('집계 단위'),
+        dimensions: z.array(z.enum([
+            'apiLevel',
+            'versionCode',
+            'deviceModel',
+            'deviceBrand',
+            'deviceType',
+            'countryCode',
+            'deviceRamBucket',
+            'deviceSocMake',
+            'deviceSocModel',
+            'deviceCpuMake',
+            'deviceCpuModel',
+            'deviceGpuMake',
+            'deviceGpuModel',
+            'deviceGpuVersion',
+            'deviceVulkanVersion',
+            'deviceGlEsVersion',
+            'deviceScreenSize',
+            'deviceScreenDpi',
+        ])).optional().describe('분해 차원. 기본: ["versionCode"]'),
+        metrics: z.array(z.string()).optional().describe('조회 metric. 기본은 metricSet별 핵심 metric + distinctUsers'),
+        filter: z.string().optional().describe('AIP-160 필터. 예: versionCode = 42'),
+        pageSize: z.number().int().min(1).max(100000).optional().describe('최대 행 수'),
+        pageToken: z.string().optional().describe('다음 페이지 토큰'),
+        userCohort: z.enum(['OS_PUBLIC', 'APP_TESTERS', 'OS_BETA']).optional().describe('사용자 cohort'),
+        timeZone: z.string().optional().describe('날짜 기준 timezone. 기본: America/Los_Angeles (Play Reporting API 샘플/지원 기준)'),
+    }, async (args) => {
+        const auth = requirePlayStoreAuth(args.packageName);
+        const result = await playstore.getStatistics(auth, args.packageName, args);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
     server.tool('playstore_list_images', 'Google Play 리스팅 이미지 목록 조회 (imageType별)', {
         packageName: z.string().describe('패키지명'),
         language: z.string().describe('언어 코드 (예: ko-KR)'),

package/dist/resources.js

@@ -25,7 +25,7 @@ export function registerResources(server) {
                     '# Mimi Seed — 앱 출시·운영 Agent',
                     '',
                     '당신은 Mimi Seed MCP를 통해 인디 개발자의 앱 출시와 운영을 돕는 에이전트입니다.',
-                    'Google Play · App Store · Firebase · AdMob을 직접 제어하는 65+ 도구를 사용할 수 있습니다.',
+                    'Google Play · App Store · Firebase · AdMob · CI/CD · BigQuery를 직접 제어하는 110+ 도구를 사용할 수 있습니다.',
                     '',
                     '## 출시 요청 처리 순서',
                     '',

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@yoonion/mimi-seed-mcp",
-  "version": "0.3.27",
-  "description": "Mimi Seed MCP server — Firebase + AdMob + Google Play + App Store management for Claude Code / Cursor / any MCP client.",
+  "version": "0.3.28",
+  "description": "Mimi Seed MCP server — Firebase + AdMob + Google Play + App Store management for Claude Code / Codex / Cursor / any MCP client.",
   "type": "module",
   "bin": {
     "mimi-seed-mcp": "dist/index.js",
@@ -27,6 +27,7 @@
     "mcp-server",
     "model-context-protocol",
     "claude",
+    "codex",
     "firebase",
     "admob",
     "google-play",