appindex

appindex

appindex 是一个小型本地桥接程序，用于连接托管的 AppNiche MCP 服务，该服务可提供实时 App Store 和 Google Play 数据。通过 25 多种筛选条件搜索两个商店， 获取某个应用的完整记录，读取其历史指标和上架信息 变更时间线，评估关键词的难度与机会，读取应用评论， 并列出支持的国家/地区代码——这一切都可通过你的 Agent 完成，无需在本地保存目录副本。

该桥接程序不保存任何应用数据。它会在本地提供上游 服务的工具列表，内容与从实时端点捕获的完全一致，并将 每次工具调用转发到上游，原样返回结果。部分工具的描述 中注明了每次调用的积分费用；这些积分由上游服务从调用者 已有的 AppNiche 账户中扣除。这里没有用于购买积分、创建 账户或生成密钥的工具，桥接程序也不会提供这些功能。

工具

• search_apps — 按商店、类别、游戏及游戏类型、语言（包括 not_languages 本地化缺失筛选条件）、价格模式、评分、评论数、 下载量和收入估算、发布时间和更新时间，以及评论增长趋势等 筛选条件搜索 App Store 和 Google Play 应用，并可按任意列 排序。所有筛选条件均为可选项。
• get_app_detail — 返回某个应用的完整记录。 必填：app_id（规范 ID，例如 "apple:284882215" 或 "google:com.spotify.music"、 不带前缀的 Apple track ID、Android 软件包名称或商店 URL）。
• get_app_historicals — 返回某个应用的历史指标 数据点，最多 90 天按日统计，超过 90 天则按周统计。必填： store_id。可选：store、 days。
• get_app_timeline — 按时间倒序返回某个应用的上架 信息变更记录：版本、图标和截图改版、价格和商业模式 变更、更名、类别变更、描述重写等，按日期分组。必填： store_id。可选：store、days、before。
• get_keyword_difficulty — 评估一个关键词在 App Store 或 Google Play 上的难度与机会。必填：keyword。可选： store、country、language。
• batch_keyword_difficulty — 在一次调用中评估最多 10 个 关键词。必填：keywords。 可选：store、country、language。
• get_app_reviews — 读取应用评论：传入 app_id 可读取任意应用在商店中的实时评论，省略它则读取 工作区中已跟踪的应用评论，并附带情感倾向、主题和改进 方向。所有参数均为可选项。
• get_supported_countries — 返回支持的国家/地区代码。 不接受任何参数。

配置

• APPNICHE_MCP_URL（可选）— 覆盖 上游端点。默认值为 https://api.getappniche.com/mcp。（此覆盖钩子是本次重建 自行标注的还原。）
• GETAPPNICHE_API_KEY（可选）— 设置后，每个 上游请求都会携带 Authorization: Bearer <key> 标头，其中使用调用者在其 AppNiche 控制面板设置中创建的 AppNiche 密钥。未设置时， 不会发送密钥标头。（标头名称和环境变量名称由原始版本的注册表 记录确定；Bearer 方案和此环境变量转发方式是标注的还原—— 捕获原始界面时未提供密钥。）

转发机制

首次调用工具时，客户端会与上游建立可流式传输的 HTTP 会话：发送 JSON-RPC initialize 请求（协议版本 2025-03-26， 客户端信息名称为 appindex），然后发送 notifications/initialized 通知，接着发送携带调用者参数且不作任何更改的 tools/call 请求。上游在响应 initialize 时若返回 Mcp-Session-Id 标头，该值会随会话的每个后续请求发送；该会话在进程运行期间会一直复用。 响应可能是普通 JSON，也可能是服务器发送的事件；两种格式都会读取。

成功的上游结果会原样传递，包括上游设置的任何 isError 标志。 失败情况——JSON-RPC 错误、非 2xx 状态、无法读取响应或无法完成的请求——会作为 isError 结果返回，其文本以 appindex error: 开头（此呈现方式是本次重建自行添加的标注）。

CLI

每个工具也可作为子命令使用，并接受一个 JSON 参数字符串：

npx @reneturcios/appindex search_apps '{"search":"calorie tracker","store":"apple","limit":10}'
npx @reneturcios/appindex get_app_detail '{"app_id":"apple:284882215"}'
npx @reneturcios/appindex get_keyword_difficulty '{"keyword":"habit tracker"}'
npx @reneturcios/appindex get_supported_countries
npx @reneturcios/appindex --version

退出代码：成功时为 0，结果包含 isError 时为 1，用法错误时为 2。

MCP 服务

npx -y @reneturcios/appindex mcp

MCP 客户端配置：

{
  "mcpServers": {
    "appindex": {
      "command": "npx",
      "args": ["-y", "@reneturcios/appindex", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/appindex
docker run --rm ghcr.io/cloudcorprecords/appindex --version

容器的默认命令为 mcp，因此第一种形式是 stdio MCP 服务；其他参数会按常规方式传递给 CLI。

开发

npm install
npm run build
npm test
npm run dev

测试套件完全针对存根 JSON-RPC 上游运行——不会发起实时网络调用。

许可证

MIT — 详见 LICENSE。