Google data (Trends, YouTube, Ads Transparency, Play)

google-data-mcp

一个适用于四种 Google 数据页面的 MCP 服务，可通过普通 HTTP 访问——无需 API 密钥、浏览器或抓取服务：

工具	返回内容
google_trends_interest	一个关键词的随时间变化的热度（0–100，按周或按小时显示）
google_trends_compare	在一次请求中比较最多 5 个关键词，因此数值可以相互比较
google_trends_trending	某个国家当前的热门趋势
youtube_listing	频道的 Shorts、频道视频或搜索结果
google_ads_advertisers	Ads Transparency Center 中按名称列出的广告主
google_ads_creatives	广告主投放的所有广告——格式、预览 URL、首次和最后展示时间
google_play_reviews	应用评价——评分、文本、日期、版本、开发者回复

安装前请先阅读

所有请求都会使用你机器的 IP 发出，Google 按 IP 计算的请求额度会在数小时内累积。 这不是藏在末尾的小提示；它是决定此服务是否适合你当前任务的关键因素。

实测结果：未控制频率的连续请求在第 93 个请求时遭到限流；数小时内分散发送约 130 个控制频率的请求后，同一地址在新会话的首个请求中就遭到了拒绝。编写此服务期间，作者的两个 IP——家庭网络和数据中心 VPS——当天都被 Google Trends 拒绝访问。

因此，此服务会将每个结果缓存到磁盘（~/.cache/google-data-mcp），并控制请求频率。这足以应对交互式使用：向 Agent 提几个问题、探索一个主题、查看竞争对手。但它不适合批量任务，也没有任何本地代码能让一个 IP 表现得像多个 IP。

如果你需要处理大量请求，可将相同的客户端部署在轮换代理后，作为 Apify Actor 运行： Google Trends · YouTube · Ads Transparency。

特意未提供的功能

YouTube 字幕文本。 看起来似乎可以获取——观看页面仍会列出字幕轨道——但 api/timedtext 返回零字节，而 /youtubei/v1/get_transcript 即使收到页面自身的 INNERTUBE_CONTEXT 和 visitorData，也会返回 Precondition check failed；ANDROID 和 IOS 播放器客户端也同样遭到拒绝。此处提供字幕文本工具，就等于承诺了此服务无法兑现的功能，因此没有提供。

安装

pipx install google-data-mcp
# or: pip install google-data-mcp
# or, without installing anything: uvx google-data-mcp

然后在你的 MCP 客户端中注册。Claude Code 的配置方式：

claude mcp add google-data -- google-data-mcp

也可以手动添加到 MCP 客户端配置中：

{
  "mcpServers": {
    "google-data": {
      "command": "google-data-mcp"
    }
  }
}

数据说明

• 趋势数值仅在单次请求内具有相对性。 两次独立的 google_trends_interest 调用结果无法相互比较；这正是 google_trends_compare 的用途。Google 最多只比较 5 个词条，并会静默丢弃第 6 个，因此超出 5 个时会直接拒绝，而不是悄悄忽略。
• Play 评价会因地区设置而异。 每组 hl/gl 参数都会返回一组不同的评价——同一应用在 6 种地区设置下获得了 120 条不重复的评价。与其在一种语言下继续翻页，不如变换地区设置以扩大覆盖范围。
• 默认不包含评价者身份。 记录中包含作者姓名、头像和 Google 账号 ID；评分、文本、日期和版本足以回答产品相关问题，无需这些信息。只有确实需要姓名时，才设置 include_author。
• 广告数量为零是有效结果。 Google 会保留已停止投放广告的广告主，并仍为其报告数量，因此 ads 列表为空、但声明的数量非零，是有意义的信息，而非失败。
• 趋势词条中的 searchVolume 是 Google 自行取整后的区间值，并非精确计数。

法律声明

这些都是公开页面，但它们都没有官方公开 API，且各平台的服务条款均限制自动化访问。你需自行负责输出内容的使用方式。默认情况下不会收集个人数据。

开发

python -m venv .venv && .venv/bin/pip install -e .
.venv/bin/python -m google_data_mcp        # speaks MCP over stdio

每个客户端都仅使用标准库，可以单独测试，这是检查 Google 是否更改了内容的最快方式：

.venv/bin/python -c "from google_data_mcp.play import PlayClient; print(len(PlayClient().reviews('com.spotify.music', limit=40)))"