mcpField
G
google-trends-mcp

google-trends-mcp

本地服务
github.com/purahmanian数据与分析221 周前更新

关于 google-trends-mcp

google-trends-mcp 是向兼容 MCP 的 AI 客户端提供 Google Trends 搜索热度数据的 MCP 服务,支持比较词条、相关查询、地区分布和当前热门搜索,无需 API 密钥。

主要功能

  1. 01查询最多五个词条的热度变化
  2. 02比较不同词条的搜索热度
  3. 03查找热门及上升相关查询
  4. 04查看每日实时热门搜索
  5. 05按地区查看搜索热度

适用场景

  1. 01比较不同市场的关键词热度
  2. 02追踪搜索的季节性变化
  3. 03发现主题相关的上升查询
  4. 04识别搜索热度的地区差异

MCP 相关

向兼容 MCP 的客户端提供五种 Google Trends 数据工具。无需 API 密钥,数据请求使用 Google Trends 网站所用的未公开端点。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"purahmanian-google-trends": {
"command": "npx",
"args": [
"-y",
"google-trends-mcp"
]
}
}
}
启动命令npx -y google-trends-mcp

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npmgoogle-trends-mcp0.1.1

工具

5

收录的工具列表 · 更新于 2 周前

参数类型必填说明
geostring否两位字母的国家/地区代码(例如 "US"),或留空表示全球。
termsarray是搜索词(1-5 个)。
timeframestring否Trends 时间范围字符串,例如 "today 12-m"、"today 5-y"、"now 7-d"。

详细介绍

google-trends-mcp

在任何兼容 MCP 的 AI 客户端中免费获取 Google Trends 数据。无需 API 密钥。

CI npm


非官方接口免责声明

此服务会与 trends.google.com 前端使用的相同内部接口通信。这些接口未公开文档,且未经官方认可。Google 可随时更改、限制其速率或移除这些接口,恕不另行通知。本项目与 Google LLC 无关联,也未获其认可或赞助。“Google Trends”是 Google LLC 的商标。

如果请求开始失败,请提交问题。通常只需调整 URL 或参数即可修复。


功能

工具说明提示词示例
interest_over_time最多 5 个搜索词的每周兴趣分数(0-100)“显示过去一年美国对‘matcha latte’的兴趣”
compare_terms对 2-5 个搜索词进行标准化比较,并指出胜出者“比较加拿大的‘coffee’、‘tea’和‘matcha’”
related_queries某个搜索词的热门及上升相关搜索词“‘cold plunge’有哪些正在上升的相关搜索词?”
trending_now某个国家/地区今日的每日热门搜索“现在英国的 Google 热搜是什么?”
interest_by_region兴趣度的区域细分(国家/地区或次级区域)“美国哪些州搜索‘pickleball’最多?”

快速开始

无需 API 密钥。通过 npx 安装并运行。

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)或 %APPDATA%\Claude\claude_desktop_config.json(Windows):

{
  "mcpServers": {
    "google-trends": {
      "command": "npx",
      "args": ["-y", "google-trends-mcp"]
    }
  }
}
Claude Code
claude mcp add google-trends -- npx -y google-trends-mcp
OpenAI Codex CLI

添加到 ~/.codex/config.toml:

[mcp_servers.google-trends]
command = "npx"
args = ["-y", "google-trends-mcp"]

对话示例

发现季节性趋势:

“使用 Google Trends 显示过去 5 年全球对‘pumpkin spice’的兴趣。”

模型调用 interest_over_time,参数为 terms=["pumpkin spice"]、timeframe="today 5-y",并描述每年 9 月至 10 月明显的峰值。

关键词竞争:

“比较今年美国对‘Notion’、‘Obsidian’和‘Roam Research’的搜索兴趣。”

模型调用 compare_terms,读取平均值,并根据时间序列数据找出胜出者。

发现机会:

“目前‘sourdough bread’的相关搜索词中,哪些上升最快?”

模型调用 related_queries 并展示上升中的搜索词,通常能揭示相邻细分领域和热门子主题。


开发

# Clone and install
git clone https://github.com/purahmanian/google-trends-mcp.git
cd google-trends-mcp
npm install

# Run tests (no network calls; all HTTP is mocked)
npm test

# Build TypeScript to dist/
npm run build

# Run the server locally (stdio mode)
node dist/index.js
速率限制与封锁

Google 未公布这些接口的速率限制。实际上,每分钟发出几次请求通常都能稳定运行。如果遇到 HTTP 429 或被封锁,服务会返回一条描述性错误消息。等待 2-5 分钟通常即可解决问题。


开发者

由 Puya Ventures LLC 构建。我为产品团队和研究人员打造定制 MCP 服务和 AI 集成。欢迎联系: [email protected] | 作品集:puyarahmanian.com

属于 Product-Research MCP Suite: keepa-mcp · google-trends-mcp · junglescout-mcp


隐私

此服务完全在你的计算机上运行。它不会收集遥测数据,也不会存储任何数据。它唯一进行的网络请求是访问 Google Trends 接口(trends.google.com),并发送你查询的搜索词和区域代码。无需账户或 API 密钥。请参阅 Google 的隐私政策: https://policies.google.com/privacy

许可证

MIT。请参阅 LICENSE。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。