MCP 服务器和 REST API
把你的 ASO 数据接入 AI 助手
通过 Rankglass MCP 服务器,Claude Code、Cursor、Claude Desktop、Codex、ChatGPT 桌面应用和其他 MCP 客户端可以读取你的已追踪关键词、排名、竞品和商店详情评分。REST API 则为你自己的脚本提供同样的数据。
概要
- MCP 端点
https://app.rankglass.com/api/mcp- 传输方式
- Streamable HTTP
- 认证
- 工作区 API 密钥,以 Authorization: Bearer YOUR_API_KEY 发送
- 访问权限
- 只读
- 套餐
- Starter、Pro和Agency
- 速率限制
- 每个密钥每分钟 60 次请求,每天 2,000 次
支持可发送请求头的 MCP 客户端
Rankglass 在每次请求时校验 API 密钥,客户端只需把它作为请求头发送。下面提供以下客户端的配置:
- Claude Code
- Cursor
- Claude Desktop,通过 mcp-remote(需要 Node.js)
- Codex 和 ChatGPT 桌面应用
- 其他 MCP 客户端和你自己构建的智能体,使用上面的端点和请求头即可
只能通过 OAuth 登录连接的客户端无法发送密钥,因此暂时无法添加 Rankglass。
三步完成配置
第 1 步
创建 API 密钥
在 Rankglass 中打开“设置 → 工作区 → API 与 MCP”并创建密钥。密钥只显示一次,请立即复制。一个密钥读取一个工作区;建议每个助手或脚本各用一个,以便单独撤销。
第 2 步
将 Rankglass 添加到你的助手
粘贴对应客户端的配置,并把 YOUR_API_KEY 替换为你的密钥。
Claude Code
在终端中运行此命令。加上 --scope user 后,Rankglass 会出现在你的所有项目中。
claude mcp add --transport http --scope user rankglass https://app.rankglass.com/api/mcp --header "Authorization: Bearer YOUR_API_KEY"Cursor 及其他客户端
对于 Cursor,将此配置添加到 ~/.cursor/mcp.json,或项目中的 .cursor/mcp.json。其他客户端在各自的设置中管理 MCP 服务器,只需提供端点和请求头。
{ "mcpServers": { "rankglass": { "url": "https://app.rankglass.com/api/mcp", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } }Claude Desktop
将此配置添加到 claude_desktop_config.json(设置 → 开发者 → 编辑配置),然后重启 Claude。它通过 npx 运行 mcp-remote,因此需要安装 Node.js。
{ "mcpServers": { "rankglass": { "command": "npx", "args": [ "-y", "mcp-remote", "https://app.rankglass.com/api/mcp", "--header", "Authorization:${RANKGLASS_AUTH}" ], "env": { "RANKGLASS_AUTH": "Bearer YOUR_API_KEY" } } } }Codex 和 ChatGPT 桌面应用
将此配置添加到 ~/.codex/config.toml,Codex CLI、Codex IDE 扩展和 ChatGPT 桌面应用共用该文件。把你的密钥(不带 Bearer)放入名为 RANKGLASS_API_KEY 的环境变量。
[mcp_servers.rankglass] url = "https://app.rankglass.com/api/mcp" bearer_token_env_var = "RANKGLASS_API_KEY"无法设置 Authorization 请求头的客户端,可以改为发送 x-api-key: YOUR_API_KEY。
第 3 步
用自己的话提问
你的助手会自动选择合适的工具。这些工具都无法修改你工作区中的任何内容。
你的助手可以读取哪些数据
11 个只读工具,每个都在 REST API 中有对应的 GET 端点。
| MCP 工具 | 返回内容 | REST 端点 |
|---|---|---|
list_apps | 你的应用,以及它们的商店、追踪的国家/地区、关键词数量和本周核心数据。适合作为第一次调用。 | GET /v1/apps |
get_keyword_rankings | 某个应用在一个商店和国家/地区的全部已追踪关键词:排名、7 日变化、新上榜或掉榜、最佳排名、估算月搜索量、难度和竞品排名。 | GET /v1/keywords |
get_rank_changes | 最近几天所有关键词、商店和国家/地区中排名上升和下降最多的关键词,以及进入或跌出前 10 名的关键词。 | GET /v1/rank-changes |
get_competitors | 已关注的竞品及其评分、双方各自在多少关键词上排名更高,以及竞品进入前 10 名而你没有的关键词。 | GET /v1/competitors |
get_competitor_keywords | 某个竞品在一个国家/地区有排名的关键词,包括你尚未追踪的,附月搜索量、难度和双方排名。 | GET /v1/competitor-keywords |
get_competitor_insights | 竞品的商店信息、按星级的评分、榜单排名、估算月下载量和收入,以及最新的 AI 评论摘要。 | GET /v1/competitor-insights |
get_competitor_growthBeta | 竞品如何获取用户:广告、社交账号、创作者、商店搜索和网站,附估算的广告支出、广告带来的安装和社交触达,以及最新的 AI 策略分析。仅限 Pro 和 Agency。 | GET /v1/competitor-growth |
get_store_page_changes | 你和竞品商店页面的近期变更:标题、副标题、描述、截屏、版本和更新说明。 | GET /v1/store-page-changes |
get_aso_score | 你在一个商店和国家/地区的 0–100 分 ASO 评分、背后的各项检查、关键词速赢项和最新的 AI 商店详情建议。 | GET /v1/aso-score |
get_weekly_brief | 你的应用最新的每周简报:发生了什么变化、可能的原因,以及最多三件下一步要做的事。 | GET /v1/weekly-brief |
get_keyword_game_planBeta | 某个已追踪关键词的最新攻略:目标排名和最多五个达成步骤。 | GET /v1/keyword-game-plan |
REST API
同样的数据以 JSON 形式提供给你的脚本、看板和表格。所有端点都是 https://app.rankglass.com/api/v1 下的 GET 请求,使用同一个密钥。
第一个请求:最近七天排名变化最大的关键词。
curl "https://app.rankglass.com/api/v1/rank-changes?days=7" -H "Authorization: Bearer YOUR_API_KEY"限制与访问
- 只读。工具和端点只读取 Rankglass 已存储的数据,从不发起新的搜索。付费操作(例如在新的国家/地区挖掘竞品关键词)需在控制台中发起。
- 每个密钥每分钟可发送 60 次请求,每天 2,000 次,MCP 服务器和 REST API 共用此额度。超出后,请求会收到 429 响应,并带有 Retry-After 请求头。
- Starter、Pro和Agency套餐包含 API 和 MCP 访问。没有该权限时,请求会收到 403 响应。
- 一个密钥可以读取其工作区内的所有数据,请像对待密码一样保管。设置页面会显示每个密钥的最近使用时间,你也可以在那里撤销它。
可以试试这些问题
- 本周我有哪些关键词排名下降了?
- 我的应用在德国搜索“habit tracker”时排第几?排在我前面的是谁?
- 我的头号竞品有哪些我还没追踪的排名关键词?
- 这个月我的竞品在商店页面上改了什么?
- 我在英国的 ASO 评分是多少?应该先改什么?
- 为我的每个应用总结本周简报。
关于 MCP 服务器的问题
支持 ChatGPT 吗?
支持,在 ChatGPT 桌面应用中可用。它与 Codex CLI 和 Codex IDE 扩展共用 ~/.codex/config.toml 中的 MCP 服务器配置,可以从环境变量发送你的密钥(bearer_token_env_var);上面的配置示例展示了写法。网页版 ChatGPT 通过连接器添加工具,而连接器只支持 OAuth 登录,暂时无法发送密钥。任何能带请求头调用 API 的工具都可以改用 REST API。
我的助手能修改 Rankglass 中的内容吗?
不能。所有工具和端点都只读。添加应用、追踪关键词和发起搜索都在控制台中完成。
数据有多新?
与控制台相同:付费套餐中每个已追踪关键词每天检查一次,每周简报在每周一生成。工具只读取 Rankglass 已存储的数据,从不发起检查。
我的数据会发送到哪里?
只发送给请求数据的客户端,且只来自密钥所属的工作区。之后由你的助手提供方按其自身条款处理。随时删除密钥即可停止访问。
想看分步教程?阅读如何配置 Rankglass MCP 服务器。