mcpField
G
google-play

google-play

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

关于 google-play

google-play 提供 Google Play 应用商店数据,适用于需要查询应用、评论及开发者目录的 Agent。它通过按次付费的 HTTP GET 返回应用详情、权限和数据安全披露,也支持 MCP 调用。

主要功能

  1. 01按关键词搜索应用并筛选价格与国家
  2. 02查询应用详情和相似应用
  3. 03获取应用评论并按条件排序
  4. 04查看应用权限与数据安全披露
  5. 05读取开发者应用目录

适用场景

  1. 01比较不同国家商店中的免费或付费应用
  2. 02汇总应用评论并按评分排序
  3. 03检查应用权限及数据安全信息

MCP 相关

提供 MCP 端点,客户端可通过 fetch_data 调用各数据接口,也可使用 googleplay_apps 快捷工具;支持预付额度或 x402 按次支付。

安装

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

$npx skills add https://github.com/fetcher-sh/fetcher-skills --skill google-play

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

详细介绍

Google Play API

搜索 Google Play Store 应用,查看详情、评论、权限、数据安全信息和开发者目录——每次调用只需发送一个普通 HTTP GET 请求,按使用量付费。无需访问 Play Console,无需开发者账号,也无需抓取商店页面的 HTML。

Base URL:https://googleplay.fetcher.sh

身份验证

两种付费方式,获取相同数据——完整机制请参阅 fetcher 技能:

# 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://googleplay.fetcher.sh/api/apps?search=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 一致。

端点(7 个——全部为 GET,每次调用 $0.003)

端点返回内容
/api/apps符合关键词的应用;支持价格和国家筛选
/api/apps/{appId}应用的完整详情
/api/apps/{appId}/reviews应用的评论
/api/apps/{appId}/similar与指定应用相似的应用
/api/apps/{appId}/permissions应用请求的权限
/api/apps/{appId}/datasafety应用的数据安全披露信息
/api/developers/{developerId}开发者的完整应用目录

搜索时必须提供:search。可选参数:price(all、free、paid)、country、lang。评论查询必须提供 country;可选参数 sort(NEWEST、RATING、HELPFULNESS)。

使用场景

仅限免费应用:

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "search=meditation" -G \
  --data-urlencode "price=free" \
  "https://googleplay.fetcher.sh/api/apps"

付费应用,德国商店:

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "search=photo editor" -G \
  --data-urlencode "price=paid" \
  --data-urlencode "country=de" \
  "https://googleplay.fetcher.sh/api/apps"

获取应用完整详情,然后按评分排序查看评论:

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://googleplay.fetcher.sh/api/apps/com.spotify.music"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "country=us" -G \
  --data-urlencode "sort=RATING" \
  "https://googleplay.fetcher.sh/api/apps/com.spotify.music/reviews"

查看权限和数据安全披露信息:

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://googleplay.fetcher.sh/api/apps/com.spotify.music/permissions"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://googleplay.fetcher.sh/api/apps/com.spotify.music/datasafety"

查看与指定应用相似的应用,以及开发者的完整应用目录:

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://googleplay.fetcher.sh/api/apps/com.spotify.music/similar"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "country=us" -G \
  "https://googleplay.fetcher.sh/api/developers/Spotify+AB"

MCP

{
  "mcpServers": {
    "google-play": {
      "url": "https://googleplay.fetcher.sh/mcp",
      "headers": { "Authorization": "Bearer bby_live_..." }
    }
  }
}

免费:search_endpoints、describe_endpoint、check_balance。付费:fetch_data(上述任意端点)、topup_credits,以及名为 googleplay_apps 的快捷工具。移除 headers 代码块即可改用 x402 按次付费——完整流程请参阅 fetcher 技能。

错误

  • 400 — 缺少或参数无效(消息中会指出具体参数)
  • 401 — 未知密钥或密钥已轮换
  • 402 — 需要付款(x402 挑战)或 topup_required(余额已用尽)
  • 404 — 不是计价路径
  • 无速率限制;上游请求失败不退款(结算先于交付)

参考资料

评论

支持 Markdown