Mogut

面向 Apple 生态（iOS + Mac Catalyst）的只读 App Store 增长分析（ASO）MCP 服务器。

Mogut 从不向 App Store 写入内容。写入操作会以可直接执行的 Heimdall 工具调用形式移交，由用户批准后执行。

1.0：13 个实时数据源上的 47 个工具，最终汇聚到报告编排器。 report_app 一次调用即可生成完整 App Report；周期档位 （每日/每周/每月）从本地历史中报告差异。参见 CHANGELOG.md。

安装

npm install -g mogut
mogut setup

向导会将 Mogut 注册到它发现的 MCP 客户端中（Claude Code & Desktop、Codex、 Cursor、VS Code、Windsurf、Antigravity）——之后重启一次客户端即可。

向导将凭据存储在 macOS Keychain（com.milowda.credentials）中，并使用 .env 作为回退方案。秘密只在终端中输入——绝不在聊天中出现，绝不被记录，绝不被显示。参见 SECURITY.md。

Related MCP server: ASO Score MCP

MCP 配置

{
  "mcpServers": {
    "mogut": { "command": "mogut", "args": [] }
  }
}

默认暴露九种工具：六个 mogut_* 元工具，外加三个报告 编排器（report_app、report_competitor_deep、report_comparison——第四个 report_actions 将在 v1.1 中加入）。其余工具均按 profile 选择启用：设置 MOGUT_PROFILES="keyword,competitor"（或 "all"）。mogut_search_tools 可以查找某个工具，并 告诉你哪个 profile 会启用它。流程见 GUIDE.md。

结果什么样

每个工具都会返回数据（structuredContent）外加一条供宿主模型使用的写作指令—— 统计量一律在代码中计算，绝不交给模型推断。每个结果都携带 source、confidence 和 lastCheckedAt；截断是可见的（已获取/已分析计数）； 评论和竞品文本会被标记为不可信数据。损坏的数据源会成为明显被跳过的区块，而绝不是一个编造的数字。

层级

mogut_status 显示当前层级，实时校验凭据（verify: true），并对 180 天 Apple Ads 密钥轮换进行倒计时。

哪种 App Store Connect 角色解锁哪些内容

该数据流只有在完成那一次 POST 之后才会产生数据。Mogut 永远不会在 MCP 界面上发送该请求： 在终端中运行 npx mogut analytics enable --app <id>（会要求输入具有 Admin 权限的 .p8 路径，在内存中使用，不存储任何内容），或使用 --print-only 打印请求并转交给持有 Admin 权限的人。 disable 用于撤销该操作。

进阶：Apple Ads 热度指数

官方 Apple Ads API 没有热度指数（已实测：POST /api/v5/keywords/popularities → 404）。Ads UI 显示的数字来自一个未公开的端点， 它使用 Web 会话而不是 OAuth 进行身份验证。Mogut 可以读取它，但向导不会要求你提供：它要求粘贴浏览器 Cookie，会过期，而且使用它相对于 Apple Ads 条款属于灰色地带。没有它，keyword_popularity_fetch 就会回退到一个标记为低置信度的代理评分。

如果你仍然想使用：

1. 登录 https://app-ads.apple.com 并打开任意一个广告活动页面。

2. 打开开发者工具 → Network，筛选 /cm/api，点击其中一个请求。

3. 完整复制该请求的 Cookie 请求头。

4. 在启动 Mogut 的 MCP 客户端所在环境中执行 export MOGUT_APPLE_ADS_SESSION='<the cookie header>'；或者把它存储到 com.milowda.credentials Keychain 服务的 apple-ads-session 账号下。

当会话过期时，重新执行一次。mogut_discover_sources 会在该端点开始拒绝请求后把数据源显示为 down。

报告是什么样

report_app 生成按需的完整报告；daily_digest、weekly_change_report 和 monthly_status_report 生成周期层级，从同一份本地历史中读取差异。两者的匿名黄金样例： EXAMPLE_REPORT_FULL.md · EXAMPLE_REPORT_PERIODIC.md。

开发

npm install && npm run build && npm test

需要添加一个数据源？请阅读 CONTRIBUTING.md——适配器约定和 fixture 要求都由测试来保证。

src/core/catalog.ts 由 docs/TOOL_CATALOG.md 生成——使用 node scripts/gen-catalog.mjs 重新生成。

MIT.