getappniche

GetAppNiche MCP — 面向 AI Agent 的 App Store 和 Google Play 情报

GetAppNiche 的 Model Context Protocol 接口：实时 App Store 和 Google Play 数据——应用发现（含收入和下载数据）、ASO 关键词评分、历史指标和评论动态——适用于 Claude、Cursor、Codex、Gemini CLI 及任何其他支持 MCP 的 Agent。

你可能不需要运行任何东西。 服务已托管：

https://api.getappniche.com/mcp        Streamable HTTP · JSON-RPC 2.0
Authorization: Bearer YOUR_API_KEY     app.getappniche.com → Settings → API Keys

按客户端设置

Claude Code — 一条命令，无需重启：

claude mcp add --transport http getappniche https://api.getappniche.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Cursor — .cursor/mcp.json（项目级）或 ~/.cursor/mcp.json（全局）：

{
  "mcpServers": {
    "getappniche": {
      "url": "https://api.getappniche.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Claude Desktop — claude_desktop_config.json，然后完全重启应用：

{
  "mcpServers": {
    "getappniche": {
      "command": "npx",
      "args": ["-y", "@getappniche/mcp"],
      "env": { "GETAPPNICHE_API_KEY": "YOUR_API_KEY" }
    }
  }
}

VS Code（Copilot Agent 模式） — .vscode/mcp.json：

{
  "servers": {
    "getappniche": {
      "type": "http",
      "url": "https://api.getappniche.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Windsurf — ~/.codeium/windsurf/mcp_config.json（字段为 serverUrl）：

{
  "mcpServers": {
    "getappniche": {
      "serverUrl": "https://api.getappniche.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Codex CLI — ~/.codex/config.toml，然后导出 GETAPPNICHE_API_KEY：

[mcp_servers.getappniche]
url = "https://api.getappniche.com/mcp"
bearer_token_env_var = "GETAPPNICHE_API_KEY"

Gemini CLI — ~/.gemini/settings.json（字段为 httpUrl）：

{
  "mcpServers": {
    "getappniche": {
      "httpUrl": "https://api.getappniche.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Zed、Cline、Continue 和 JetBrains AI 也都支持 — getappniche.com/mcp 提供了所有代码片段。 配套的 Agent 技能： getappniche-com/aso-skills （npx skills add getappniche-com/aso-skills）。

ChatGPT — 设置 → 连接器 → 创建自定义连接器（开发者模式），将其指向 https://api.getappniche.com/mcp，选择 API key 身份验证，然后粘贴你的密钥。

claude.ai 网页版文档介绍了请求头身份验证，但其连接器界面目前只提供 OAuth 字段 — 在此问题解决之前，请使用上面的某个客户端。

此仓库包含什么

一个零依赖的 stdio 桥接程序，供使用 stdio 进行 MCP 通信且无法发送 HTTP 请求头的客户端使用，有两种形式：bin/cli.mjs（Node 18+，发布为 @getappniche/mcp）和 server.py（Python 3.9+，仅使用标准库）。两者都会通过 TLS 将每条 JSON-RPC 消息转发到托管端点，并将响应流式传回。

# Node — one-liner, no install
GETAPPNICHE_API_KEY="getappniche_..." npx -y @getappniche/mcp

# Python — no dependencies
GETAPPNICHE_API_KEY="getappniche_..." python3 server.py

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "getappniche": {
      "command": "npx",
      "args": ["-y", "@getappniche/mcp"],
      "env": { "GETAPPNICHE_API_KEY": "getappniche_..." }
    }
  }
}

server.json 是发布到官方 MCP 注册表的清单，名称为 com.getappniche/mcp。

它只有约 150 行，易于阅读，因此也可作为网络传输内容的参考：你的 API 密钥只会放入发往 api.getappniche.com 的 TLS 请求的 Authorization 请求头中，不会用于其他任何地方。

工具

• search_apps - 按 25 多项筛选条件搜索应用：商店、类别、语言、定价模式、评分、评论、下载量、收入、发布时间和更新时效、评论增长；可按任意列排序（每返回一个应用消耗 1 个额度，默认每次调用 50 个，最多 100 个）
• get_app_detail - 根据规范 ID、纯 Apple ID、Android 包名或粘贴的商店 URL 获取一个应用的信息（1 个额度）
• get_app_historicals - 指标时间序列：评论、评分、下载量、收入（1 个额度）
• get_keyword_difficulty - 查询关键词的热度、难度、流量和机会（10 个额度）
• batch_keyword_difficulty - 为最多 10 个关键词评分，并按机会排序（每个关键词 10 个额度）
• get_app_reviews - 根据 ID、包名或 URL 获取任意应用的实时 App Store 或 Google Play 评论，或获取工作区内受监控应用的增强数据行（每返回一条评论消耗 1 个额度，默认每次调用 50 条，最多 100 条）
• get_supported_countries - 列出有效的商店国家/地区代码（免费）

GetAppNiche 套餐包含额度（Pro：每月 5,000 个），每条结果都会报告 credits_charged。速率限制：每个密钥每分钟 60 个请求。

协议说明

• 方法：initialize → notifications/initialized → tools/list / tools/call。协议错误使用标准 JSON-RPC 代码；工具级错误（ID 无效、额度不足）会作为工具结果返回，供你的 Agent 读取。
• 桥接器遵循 Mcp-Session-Id，并接受 JSON 和 SSE 帧格式的响应。
• 面向连接器界面无法设置请求头的客户端（claude.ai web）的 OAuth 功能正在开发中；ChatGPT 目前可使用 API 密钥身份验证进行连接。

许可证

MIT。由 GetAppNiche 构建 · X @getappniche · LinkedIn