App Store + Google Play Data

appstore-data-mcp

MCP 服务，为 Claude、Cursor、VS Code、Codex 和任何其他 MCP 客户端提供 Apple App Store 和 Google Play 的实时数据，包括应用详情、评论、关键词搜索、排行榜和类别分类，覆盖 175 多个国家/地区的商店。

由 App Store Google Play Data API 提供支持（免费套餐：每月 500 次调用）。

工具

工具	功能
search_apps	使用商店自身的相关性排名进行关键词搜索；返回供其他工具使用的 ID
get_app	单个应用的完整元数据——名称、开发者、评分、价格、版本、大小、屏幕截图、商店 URL
get_app_reviews	分页评论，可按最新或最有帮助排序，并包含开发者回复
top_charts	免费 / 付费 / 总收入 / 新品排行榜，按国家/地区和类别筛选
list_categories	商店类别 ID 和名称，用于筛选和解析 top_charts 类别

两个商店的数据均已规范化为相同的字段名（id、name、developer、rating 等），因此模型无需学习两套架构。

设置

1. 获取免费的 RapidAPI 密钥：https://rapidapi.com/TheValkDokk/api/app-store-google-play-data-api → 订阅 BASIC → 从代码片段中复制 X-RapidAPI-Key。
2. 在客户端中添加此服务，并在环境中设置 RAPIDAPI_KEY。

Claude Desktop / Claude Code

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "appstore-data": {
      "command": "npx",
      "args": ["-y", "appstore-data-mcp"],
      "env": { "RAPIDAPI_KEY": "your-rapidapi-key" }
    }
  }
}

Cursor

~/.cursor/mcp.json（全局）或 .cursor/mcp.json（项目级）——使用与上文相同的 mcpServers 配置块。

VS Code（Copilot Agent 模式）

.vscode/mcp.json：

{
  "servers": {
    "appstore-data": {
      "command": "npx",
      "args": ["-y", "appstore-data-mcp"],
      "env": { "RAPIDAPI_KEY": "your-rapidapi-key" }
    }
  }
}

示例提示词

• “找出美国排名前 5 的冥想应用，并比较它们的评分和评论数。”
• “过去 200 条 Instagram 的 iOS 评论有哪些变化？有没有针对新更新的一星差评？”
• “目前日本哪些摄影应用的总收入排名最高？”
• “提取英国 com.spotify.music 最近的 25 条评论，并总结其中的抱怨。”

托管端点（无需安装）

远程副本运行于 https://appstore-mcp-623314400722.us-central1.run.app/mcp（可流式传输的 HTTP，无状态）。 请将自己的 RapidAPI 密钥作为请求头发送——服务器端不会共享或存储任何内容：

{
  "mcpServers": {
    "appstore-data": {
      "type": "http",
      "url": "https://appstore-mcp-623314400722.us-central1.run.app/mcp",
      "headers": { "X-RapidAPI-Key": "your-rapidapi-key" }
    }
  }
}

Authorization: Bearer <key> 和 ?key=<key> 也可使用。无需密钥即可获取工具列表，因此目录爬虫可以为此服务编制索引；不带密钥调用工具会返回 MISSING_CREDENTIALS，并附上注册链接。

配置

变量	必需	用途
RAPIDAPI_KEY	是（自托管时除外）	市场身份验证：作为 X-RapidAPI-Key + X-RapidAPI-Host 发送
APPSTORE_API_BASE_URL	否	指向自己的部署，而非市场
APPSTORE_API_HOST	否	覆盖 X-RapidAPI-Host 的值
APPSTORE_PROXY_SECRET	否	自托管来源身份验证（X-RapidAPI-Proxy-Secret）

配额和费用

调用次数计入你的 RapidAPI 套餐：BASIC 免费（每月 500 次调用），付费套餐起价为 $9.99。每次工具调用对应一次请求。limit 每次调用最多为 50，这是有意设置的——较大的页面可能超过 MCP 客户端的响应大小限制，导致内容被截断。

开发

npm install
npm run build
RAPIDAPI_KEY=xxx npm run smoke   # 26 end-to-end checks against the live API

许可证

MIT

注册目录

• npm：appstore-data-mcp
• 官方 MCP 注册表：io.github.thevalkdokk/appstore-data
• Smithery / Glama / mcp.so：已通过此仓库和 npm 包列出

每次发布时，都会通过 .github/workflows/mcp-registry.yml 自动发布到 MCP 注册表。