ASO Atlas

ASO Atlas MCP 服务

ASO Atlas 是一款面向 App Store 和 Google Play 应用的应用商店优化工具：可使用 Apple 报告的搜索热度和难度评分进行关键词研究，在 59 个店面跟踪每日排名，查找竞争对手的关键词差距，优化元数据，并查看你自己的 App Store Connect 表现。

此仓库包含其托管 MCP 服务的公开清单，因此任何 MCP 客户端都可以研究关键词，并在对话过程中操作你的 ASO Atlas 账户。

• 服务 URL： https://asoatlas.com/mcp（Streamable HTTP）
• **身份验证：**使用 OAuth 2.1、PKCE 和动态客户端注册，或为无头 Agent 使用个人访问令牌
• 文档： https://asoatlas.com/docs/connect-your-ai
• **要求：**拥有有效订阅的 ASO Atlas 账户（每月 $9，可使用不限数量的应用和关键词）

安装

Claude

Claude.ai（网页版或桌面版）：设置 → 连接器 → 添加自定义连接器 → 粘贴服务 URL 并批准授权页面。

Claude Code：

claude mcp add --transport http asoatlas https://asoatlas.com/mcp

或者将此仓库安装为插件，同时添加该服务和一项指导 Claude 如何解读热度与难度的技能：

claude plugin marketplace add asoatlas/mcp
claude plugin install aso-atlas@asoatlas-mcp

Cursor

添加到 Cursor，或在 ~/.cursor/mcp.json 中配置：

{ "mcpServers": { "asoatlas": { "url": "https://asoatlas.com/mcp" } } }

VS Code

code --add-mcp '{"name":"asoatlas","type":"http","url":"https://asoatlas.com/mcp"}'

Gemini CLI

gemini extensions install https://github.com/asoatlas/mcp

此扩展会添加该服务和同一项技能。使用 /mcp auth asoatlas 登录。

Google Antigravity

在 mcp_config.json 中（Agent 面板 → MCP 服务 → 管理 → 查看原始配置）：

{ "mcpServers": { "asoatlas": { "serverUrl": "https://asoatlas.com/mcp" } } }

或者将此仓库安装为 Antigravity 插件，同时添加该服务和技能：

agy plugin install https://github.com/asoatlas/mcp

Kiro

添加到 Kiro，或在 .kiro/settings/mcp.json 中配置：

{ "mcpServers": { "asoatlas": { "url": "https://asoatlas.com/mcp" } } }

Windsurf

在 ~/.codeium/windsurf/mcp_config.json 中配置：

{ "mcpServers": { "asoatlas": { "serverUrl": "https://asoatlas.com/mcp" } } }

Cline、Kilo Code 和 Roo Code

MCP 服务 → 远程服务 → 名称 asoatlas，URL https://asoatlas.com/mcp，传输方式为 Streamable HTTP。

Goose

goose configure → 添加扩展 → 远程扩展（Streamable HTTP）→ https://asoatlas.com/mcp。

LM Studio

添加到 LM Studio

Codex

将此仓库安装为插件，同时添加该服务和同一项技能：

codex plugin marketplace add asoatlas/mcp
codex plugin add aso-atlas@asoatlas
codex mcp login asoatlas

或者仅添加服务，在 ~/.codex/config.toml 中配置：

[mcp_servers.asoatlas]
url = "https://asoatlas.com/mcp"

然后运行 codex mcp login asoatlas，批准授权页面。

ChatGPT

设置 → 安全和登录 → 开启开发者模式，然后前往插件 → + → 粘贴服务 URL。OAuth 提示会引导你登录 ASO Atlas。

Hermes Agent、容器及其他无头客户端

OAuth 回调无法连接到在服务器上运行的客户端，因此请在 asoatlas.com 的 设置 → 连接你的 AI 下创建个人访问令牌，并将其作为请求头发送：

mcp_servers:
  asoatlas:
    url: https://asoatlas.com/mcp
    headers:
      Authorization: Bearer YOUR_TOKEN

任何其他支持通过 HTTP 使用 MCP 的客户端也可以采用相同方式：提供 URL，然后完成 OAuth 提示或配置 bearer 请求头。

工具

所有操作都仅限于已登录用户自己的账户。读取工具不会更改任何内容；写入工具只会更改 ASO Atlas 账户，不会更改 App Store 列表本身。

工具	类型	功能
list_tracked_apps	读取	你跟踪的应用，以及其他工具所需的 ID
get_dashboard	读取	每个应用的前 10 / 前 50 名数量、可见度趋势和最大变化
get_app	读取	单个应用的详细信息：包含排名、热度和难度的关键词；竞争对手；关键词差距
get_app_optimizer	读取	单个店面的元数据分析：覆盖率、缺失词和字符数限制
get_app_performance	读取	App Store Connect 摘要：漏斗、变现、健康状况和地区
get_performance_series	读取	一项 App Store Connect 指标的每日历史记录，可按维度细分
research_keywords	读取	某个店面中最多 50 个词的热度、难度和结果数量
app_ranking_keywords	读取	反向查询：任意 App Store 应用的排名关键词
keyword_suggestions	读取	根据种子词提供自动补全建议
list_keyword_lists / get_keyword_list	读取	已保存的研究合集
track_app / untrack_app	写入	开始或停止跟踪应用
add_keywords / remove_keyword	写入	按店面跟踪或移除关键词
add_competitor / remove_competitor	写入	管理关键词差距分析所涉及的竞争对手
change_app_market	写入	将应用切换到另一个店面
refresh_app	写入	排队进行新一轮排名、评分和评论检查
save_metadata_draft	写入	为优化器保存标题 / 副标题 / 关键词字段草稿
create_keyword_list / add_keyword_to_list / remove_keyword_from_list	写入	管理关键词列表

每个工具都带有 readOnlyHint、destructiveHint 和 openWorldHint 注释；具有破坏性的工具会删除排名历史，并在描述中说明这一点。

此代码库包含的内容

• server.json：作为 com.asoatlas/mcp 发布到官方 MCP 注册表的条目
• .claude-plugin/plugin.json + .claude-plugin/marketplace.json + .mcp.json + skills/aso-atlas/SKILL.md：一个捆绑了服务和技能的 Claude Code 插件
• plugin.json + mcp.json：适用于 Codex（OpenAI 设置位于 extensions.com.openai 下）、Cursor 和兼容客户端的同款 Agent 插件；.agents/plugins/marketplace.json 将此代码库设为 Codex 市场
• gemini-extension.json：一个 Gemini CLI 扩展（服务 + 技能）
• .antigravity-plugin/plugin.json + mcp_config.json：一个 Antigravity 插件（服务 + 技能）；plugins/aso-atlas/ 保存了不含技能的同款插件
• SETUP.md：安装后客户端可按此连接指南进行操作

服务本身是 ASO Atlas Web 应用的一部分，并非开源。此处的清单文件和技能采用 MIT 许可证。

隐私政策

服务只会读取和写入已登录用户自己的 ASO Atlas 数据。隐私政策：https://asoatlas.com/privacy。条款：https://asoatlas.com/terms。支持邮箱：[email protected]。