mcpField
A
app-store

app-store

github.com/fetcher-sh数据与数据库23.8k 次安装8 周前更新
代码仓库

关于 app-store

app-store 是面向应用研究人员和开发者的 Apple App Store 数据 API 技能，可跨国家店面查询应用、套装、评论及开发者目录。

主要功能

  1. 01按关键词搜索应用与套装
  2. 02获取应用和套装详情
  3. 03查询应用与套装评论
  4. 04查找相似应用与套装
  5. 05查看开发者应用目录

适用场景

  1. 01比较不同国家店面的应用
  2. 02研究应用评论与用户反馈
  3. 03查找同类应用
  4. 04浏览开发者发布的应用

MCP 相关

提供位于 https://appstore.fetcher.sh/mcp 的 MCP 服务，支持端点检索、端点说明、余额查询及付费数据获取。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/fetcher-sh/fetcher-skills --skill app-store

安装后在 Claude Code 中输入/app-store确认已加载。

详细介绍

Apple App Store API

可搜索任何国家/地区 storefront 中的 App 和 bundle，查看详情、评论、类似 App 和开发者目录——每次调用只需发送一次普通 HTTP GET，按使用量付费。无需加入 Apple Developer Program，无需访问 App Store Connect，也无需抓取 storefront HTML。

基础 URL：https://appstore.fetcher.sh

身份验证

两种付费方式，数据相同——完整机制见 fetcher skill：

# 1. Prepaid credits (recommended — get a key at https://fetcher.sh/topup
#    or via POST /api/credits/topup, see the fetcher skill)
export FETCHER_API_KEY="bby_live_xxxxxxxxxxxx"
curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://appstore.fetcher.sh/api/apps?term=meditation"

# 2. x402 pay-per-call — omit the header; a GET with no payment returns 402
#    with machine-readable payment requirements (USDC on Base, Polygon,
#    Arbitrum, Monad, or Solana). @x402/fetch signs and retries automatically.

每个响应的格式均为 { "status": number, "message": string, "data": ... }；HTTP 状态码与 status 一致。

端点（9 个，均为 GET，每次调用 $0.003）

端点返回内容
/api/apps与关键词匹配的 App；可筛选页面和国家/地区 storefront
/api/apps/{appId}App 的完整详情
/api/apps/{appId}/reviewsApp 的评论
/api/apps/{appId}/similar与指定 App 类似的 App
/api/bundles与关键词匹配的 App bundle
/api/bundles/{bundleId}bundle 的完整详情
/api/bundles/{bundleId}/reviewsbundle 的评论
/api/bundles/{bundleId}/similar与指定 bundle 类似的 bundle
/api/developers/{developerId}开发者的完整 App 目录

/api/apps 和 /api/bundles 必须提供：term。所有端点均可选： country（storefront，例如 us、jp、de）、lang、page。评论 支持 sort（recent、helpful）。

使用场景

搜索美国 storefront：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "term=habit tracker" -G \
  --data-urlencode "country=us" \
  "https://appstore.fetcher.sh/api/apps"

搜索日本 storefront：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "term=camera" -G \
  --data-urlencode "country=jp" \
  "https://appstore.fetcher.sh/api/apps"

查看 App 完整详情，然后按有用程度排序评论：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "country=us" -G \
  "https://appstore.fetcher.sh/api/apps/324684580"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "country=us" -G \
  --data-urlencode "sort=helpful" \
  "https://appstore.fetcher.sh/api/apps/324684580/reviews"

查找与指定 App 类似的 App：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "country=us" -G \
  "https://appstore.fetcher.sh/api/apps/324684580/similar"

搜索并获取 App bundle：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "term=photo editing suite" -G \
  "https://appstore.fetcher.sh/api/bundles"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "country=us" -G \
  "https://appstore.fetcher.sh/api/bundles/1234567890"

查看开发者的完整 App 目录：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://appstore.fetcher.sh/api/developers/284882218"

MCP

{
  "mcpServers": {
    "app-store": {
      "url": "https://appstore.fetcher.sh/mcp",
      "headers": { "Authorization": "Bearer bby_live_..." }
    }
  }
}

免费工具：search_endpoints、describe_endpoint、check_balance。付费工具： fetch_data（上述任意端点）、topup_credits，以及命名快捷工具 appstore_apps。移除 headers 块即可改用 x402 按次付费——完整流程见 fetcher skill。

错误

  • 400 — 缺少或无效的参数（消息会指出参数名称）
  • 401 — 未知或已轮换的密钥
  • 402 — 需要付款（x402 挑战）或 topup_required（额度已用尽）
  • 404 — 路径未定价
  • 无速率限制；上游故障不予退款（先结算，再交付）

参考

评论

支持 Markdown