黑色星期五按月套餐首月优惠 25% 领取优惠

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. 第 1 步

    创建 API 密钥

    在 Rankglass 中打开“设置 → 工作区 → API 与 MCP”并创建密钥。密钥只显示一次,请立即复制。一个密钥读取一个工作区;建议每个助手或脚本各用一个,以便单独撤销。

  2. 第 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. 第 3 步

    用自己的话提问

    你的助手会自动选择合适的工具。这些工具都无法修改你工作区中的任何内容。

你的助手可以读取哪些数据

11 个只读工具,每个都在 REST API 中有对应的 GET 端点。

MCP 工具及其 REST 端点
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 服务器。

看看你的应用下一步该做什么

用一个商店链接添加应用,马上看到你今天的排名。

免费开始

免费版 · 无需信用卡 · 可随时取消