Sonar — ASO for AI agents

@sonarapp/mcp

官方 Sonar MCP 服务——面向 AI Agent 的 App Store 优化工具。

如需使用托管的 Grok Build 和 Cursor 市场插件，请参阅 插件设置、身份验证和权限。

它支持 Claude Desktop、Claude Code、Cursor、Cline 以及任何兼容 Model Context Protocol 的客户端，可在 iOS App Store 和 Google Play 中查询应用、研究关键词、审查 ASO、挖掘评论并估算收入。由 Sonar 提供支持。

---

工具

共 55 个工具，涵盖整个 Sonar REST API，并按所需条件分组。

读取工具 — 无状态（任何有额度的套餐）

工具	功能	无需密钥即可使用
sonar_app_lookup	按商店 ID 查询应用元数据	是
sonar_app_search	按关键词搜索应用（按商店排名顺序返回）	是
sonar_app_aso_score	ASO 审查评分（0-100），附逐项检查结果	是
sonar_app_extract_keywords	从应用详情页提取目标关键词	是
sonar_app_reviews	获取评论，可按评分筛选并选择排序方式	—
sonar_app_revenue	估算月收入，并给出置信度等级	—
sonar_keyword_search	关键词研究（难度、热度、相关词）	—
sonar_keyword_metrics	查询特定关键词的难度和热度（每次调用最多 25 个）	是（每天 5 个关键词）
sonar_keyword_suggestions	获取商店的自动补全建议	是
sonar_top_charts	免费／付费／畅销榜单及日间变化	是

无状态工具适用于任何有额度的套餐（API Credits、Indie 或 Agency），支持 iOS 和 Android。标记为“是”的工具也可在免费套餐中免密使用（见下方“免费试用”）。

读取工具 — 你的工作区（Indie 套餐）

工具	功能
sonar_list_products	列出你的产品及其关联的商店版本和竞争对手数量
sonar_list_apps	列出你跟踪的应用及最新快照（评分、评论、安装量）
sonar_get_app	应用详情及最多 90 天的快照历史
sonar_app_overview	应用仪表板概览：曝光度、声量份额、变化趋势和机会
sonar_app_keywords	应用跟踪的关键词，包含难度、热度、备注和星标
sonar_app_rankings	应用所跟踪关键词的每日排名历史
sonar_app_changes	检测到的版本发布、元数据编辑、截图／价格／类别变更
sonar_keyword_rankings	跟踪关键词的 SERP 历史（排名情况及时间）
sonar_discovered_keywords	Sonar 为应用发现的未跟踪关键词，按机会排序
sonar_competitor_keywords	竞争对手排名靠前的关键词，以及与你的应用相比的差距分析
sonar_competitor_landscape	与所有竞争对手相比的差距、威胁和潜在客户，以及最新的 AI 洞察
sonar_review_insights	最新的 AI 评论分析：好评／投诉主题、引述和趋势
sonar_list_alerts	列出你的提醒规则（类型、范围、阈值、启用状态）
sonar_alert_events	检测到的提醒事件（排名变化、评分下降、评论激增），按时间从新到旧排列

工作区读取功能需要 Indie 套餐或更高套餐（有效试用也适用）；默认的 read 范围密钥即可满足要求。

读取工具 — Agency 套餐

工具	功能说明
sonar_portfolio	产品组合汇总：各应用的 KPI、最大变动项、需关注列表和最佳机会
sonar_app_sales	App Store Connect 销售数据：下载量、重新下载量、IAP 数量、预估收益
sonar_app_engagement	App Store Connect 转化漏斗：展示次数、页面浏览量、下载量、来源、会话数

这些工具需要 Agency 套餐（Agency 试用版也算），其他套餐调用时会返回 403。sonar_app_sales 和 sonar_app_engagement 仅适用于 iOS，还需要连接 App Store Connect：trysonar.app/settings/connections；engagement 数据需要具有 Admin 角色的 App Store Connect 密钥。

写入工具（Indie 套餐 + 写入权限范围）

工具	功能说明
sonar_create_product	在 Sonar 工作区中创建产品并开始跟踪其应用
sonar_track_app	关联现有产品在另一应用商店中的版本（iOS ↔ Android）
sonar_track_competitor	在产品下添加竞品应用
sonar_remove_competitor	从产品中移除竞品
sonar_delete_product	删除产品并取消跟踪其应用
sonar_untrack_app	取消跟踪某个应用及其跟踪数据
sonar_track_keywords	开始每日跟踪某个应用的关键词排名（批量、幂等）
sonar_update_keyword_note	设置或清除已跟踪关键词的备注
sonar_star_keyword	为已跟踪的关键词加星标或取消星标（将其标记为目标）
sonar_delete_tracked_keyword	停止跟踪某个关键词与应用的组合
sonar_untrack_keywords	批量取消跟踪某个应用的关键词（指定 ID 或全部）
sonar_scan_competitor	在竞品上运行 AI 关键词发现扫描（使用 sonar_competitor_keywords 读取结果）
sonar_analyze_competitors	为你的某个应用生成最新的 AI 竞品分析（冷却期为 7 天）
sonar_generate_review_insights	为已跟踪的应用生成最新的 AI 评论分析（冷却期为 90 天）
sonar_set_alert	创建或更新提醒规则
sonar_delete_alert	删除提醒规则

写入工具会修改你的工作区，需要 Indie 套餐或更高套餐（有效试用版也算），并且需要通过托管端点使用 OAuth 登录（该方式具有写入权限），或使用以 write scope 创建的 API 密钥。两个 AI 生成工具 sonar_analyze_competitors 和 sonar_generate_review_insights 需要付费套餐，试用期间不可用。服务端会强制执行所有这些要求；不满足时，调用将返回 403，并说明需要解决的问题。

这些工具共同为 Agent 打通了完整流程：使用写入工具设置跟踪，然后通过工作区工具读取排名、变化和差距分析。

Screenshot Studio（Indie 计划）

工具	功能说明	范围
sonar_screenshot_layout_guide	布局格式参考；编写布局前阅读一次	无
sonar_screenshot_devices	支持的设备尺寸及其画布尺寸	读取
sonar_list_screenshot_sets	产品的截图集（仅元数据）	读取
sonar_get_screenshot_set	完整截图集：每个屏幕的布局及翻译覆盖项	读取
sonar_create_screenshot_set	为产品创建截图集	写入
sonar_update_screenshot_set	重命名截图集、替换其区域设置，或调整屏幕顺序	写入
sonar_delete_screenshot_set	删除截图集及其中的所有内容	写入
sonar_add_screenshot	向截图集追加一个屏幕	写入
sonar_update_screenshot	替换一个屏幕的布局	写入
sonar_delete_screenshot	删除一个屏幕（截图集至少保留一个）	写入
sonar_set_screenshot_translations	写入某个区域设置的翻译覆盖项	写入
sonar_export_screenshots	将适用于商店的 PNG 渲染到每个区域设置对应的本地 ZIP 文件中	读取

Agent 以布局 JSON 编写截图集；人类可在 Screenshot Studio 中查看并微调相同的截图集。布局指南已嵌入服务，无需密钥。sonar_export_screenshots 会在运行服务的机器上写入文件，因此仅可通过 stdio 使用，托管端点不支持此功能。

托管端点 — 无需安装，也无需 API 密钥

支持 OAuth 的 MCP 客户端（Claude Code、claude.ai 自定义连接器）可以完全跳过 npm 安装和 API 密钥：

claude mcp add --transport http sonar https://trysonar.app/mcp

首次调用需要访问账户的工具时，会打开浏览器登录页面；使用 Sonar 登录并授权后，Agent 即可完全访问你拥有的工作区（读写）。不支持 OAuth 的客户端可以改用 API 密钥：--header "Authorization: Bearer aso_..."。

ChatGPT 提交与托管行为

将 https://trysonar.app/mcp/chatgpt 提交给 OpenAI。此端点会返回工具级登录挑战；/mcp 则保留 HTTP 401 挑战，供 Claude 和其他 MCP 客户端使用。两者都会按工具声明 OAuth。匿名商店查询无需关联账户即可运行；缺少授权或授权已过期时，工作区工具会返回原生登录挑战。关联现有 Sonar 账户，并批准访问你拥有的工作区。现有账户的权限和权益仍然适用。

ChatGPT 端点要求使用绑定到资源、面向其规范 /mcp/chatgpt 受众的 JWT 访问令牌；现有 /mcp 端点仍支持 Clerk 不透明令牌。提交 ChatGPT 端点前，必须验证提供方配置和端到端登录流程。

托管目录不包含 sonar_export_screenshots，因为它会将 ZIP 文件写入本地 MCP 主机。此工具仍可通过 stdio 使用。原生目录列表需要单独接受 OpenAI 审核并发布；托管 MCP 端点本身不会自动创建目录列表。

免费试用 — 无需 API 密钥

服务无需密钥即可在免费模式下运行：sonar_app_search、sonar_app_lookup、sonar_app_aso_score、sonar_app_extract_keywords、sonar_keyword_suggestions 和 sonar_top_charts 共用每日每 IP 30 次请求的免费额度；sonar_keyword_metrics（关键词难度 + 热度）每天可查询 5 个关键词。无需配置 env 块，直接安装并向 Agent 询问 ASO 信息即可。达到限额后，错误消息会告知你如何注册。

获取 API 密钥

其他所有功能（跟踪、排名、竞争对手、更高限额）都需要 Sonar API 密钥，可在 trysonar.app/developers 获取。

最经济的选择是预付费 API 点数——套餐起价为 10 美元（1,000 点），注册可获 50 点免费额度，且无需订阅。此方案专为这种使用场景打造。请参阅定价。

安装

Claude Desktop

添加到你的配置文件（macOS 上为 ~/Library/Application Support/Claude/claude_desktop_config.json，Windows 上为 %APPDATA%\Claude\claude_desktop_config.json）：

{
  "mcpServers": {
    "sonar": {
      "command": "npx",
      "args": ["-y", "@sonarapp/mcp"],
      "env": {
        "SONAR_API_KEY": "aso_your_key_here"
      }
    }
  }
}

重启 Claude Desktop。sonar_* 工具将显示在工具选择器中。

Claude Code

claude mcp add sonar -e SONAR_API_KEY=aso_your_key_here -- npx -y @sonarapp/mcp

Cursor

添加到 ~/.cursor/mcp.json（或项目的 .cursor/mcp.json）：

{
  "mcpServers": {
    "sonar": {
      "command": "npx",
      "args": ["-y", "@sonarapp/mcp"],
      "env": {
        "SONAR_API_KEY": "aso_your_key_here"
      }
    }
  }
}

Cline / 其他 MCP 客户端

大多数客户端使用与上述相同的 command + args + env 结构。将命令指向 npx -y @sonarapp/mcp，并在 env 中传入 SONAR_API_KEY。

配置

变量	必填	默认值	描述
SONAR_API_KEY	否（不设置即可使用免费模式）	—	你的 Sonar API 密钥（aso_...）
SONAR_API_URL	否	https://api.trysonar.app	覆盖 API 基础 URL（仅用于自托管 / 预发布环境）

示例提示词

“使用 Sonar 查询美国商店中 iOS 版 Spotify，并报告其评分、评论数和类别。”

“对 Android 上的 com.duolingo 进行 ASO 审核，并告诉我需要改进什么。”

“研究 iOS 上的关键词 ‘habit tracker’——提供难度、热度，以及 5 个难度较低、值得考虑的相关词。”

“获取美国 iOS 上 1517783697 最近的 50 条 1 星和 2 星评论，并按主题归类投诉。”

“在 App Store 中搜索 ‘meditation’，并估算排名前 5 个结果的月收入。”

隐私政策

完整政策：https://trysonar.app/privacy

此 MCP 服务是 Sonar REST API 的轻量客户端，不会在本地存储任何内容，此软件包本身也不会记录数据。

• **收集的数据：**工具输入（应用 ID、关键词、国家/地区代码）会通过 HTTPS 发送至 Sonar API，以生成结果；经过身份验证的请求会将你的 API 密钥作为 Bearer 令牌传入。Sonar 会记录 API 请求（端点、状态、耗时），用于速率限制和防止滥用。
• **数据用途：**输入仅用于处理请求（关键词指标、应用查询等）；生成的 JSON 会返回给你的 AI 客户端。
• **存储与保留：**此软件包不会在磁盘上保留状态。服务器端请求日志会保留 90 天；工作区数据（已跟踪的应用 / 关键词）会一直保留在你的 Sonar 账户中，直到你将其删除。
• **第三方共享：**不会出售或与第三方共享用户数据；对公开应用商店数据（Apple、Google）的查询不包含个人信息。
• 联系：[email protected]

故障排查

“SONAR_API_KEY is not set — running in free mode” — 如果你尚未配置密钥，这是正常提示：免费工具仍可使用，但受每日 IP 限额限制。如果你确实配置了密钥，则表示 MCP 客户端没有传递环境变量——请检查客户端配置文件中的 env 部分。某些客户端需要 npx 的绝对路径——尝试运行 which npx 并使用其输出路径。

“Authentication failed” — 你的密钥无效、已过期，或订阅已失效。访问 trysonar.app/developers 查看。

“Access denied. This endpoint may require an Indie plan subscription” — 10 个无状态读取工具在任何包含额度的套餐中均可使用。工作区读取、写入和 Screenshot Studio 工具需要 Indie 套餐或更高级别的套餐（有效试用也算）；写入工具还需要使用 write 作用域创建的 API 密钥。sonar_portfolio、sonar_app_sales 和 sonar_app_engagement 需要 Agency 套餐，两个 AI 生成工具则需要付费套餐（试用套餐不适用）。如果你使用的是 setup 套餐或试用已过期的套餐，请先重新激活。

配套工具：CLI

更喜欢使用终端？请使用 @sonarapp/cli（sonar 二进制文件）——数据和 API 密钥相同。

许可证

MIT © Peter Sutarik