mcp-google-trends-scraper

Google Trends Scraper MCP 服务

适用于 Apify 上 Mamba Labs Google Trends Scraper actor 的 MCP 服务。读取搜索词的 Google Trends 数据，并为每个词返回一行汇总数据以及扁平的详细数据行。

内容一览

• 功能介绍
• 快速开始
• 前提条件
• 提示词示例
• 工具
• 输入项
• 定价
• actor 完整文档
• 许可证

功能介绍

提供搜索词，还可按需指定地理区域、时间范围、类别或搜索属性。每个搜索词都会返回一行汇总数据（平均、最新和峰值热度、近期变化、热门地区、热门和上升搜索词），以及热度随时间变化、地区和相关搜索词的扁平数据行。搜索词可以按每组 5 个进行比较，并使用同一刻度。数值是相对于图表的，并非搜索次数。

所有工作都在 Apify 上运行。此软件包是一个精简客户端，用于启动 actor 运行、等待运行完成，并返回数据集行。

快速开始

你需要 Node.js 18 或更高版本，以及一个带有 API 令牌的 Apify 账户。

将以下内容添加到 Claude Desktop 配置文件（claude_desktop_config.json）、Cursor 或任何 MCP 客户端中：

{
  "mcpServers": {
    "mamba-google-trends-scraper": {
      "command": "npx",
      "args": [
        "-y",
        "@mambalabsdev/mcp-google-trends-scraper"
      ],
      "env": {
        "APIFY_TOKEN": "your-apify-token"
      }
    }
  }
}

重启客户端。随后会显示 get_google_trends 工具。

前提条件

• Node.js 18 或更高版本。
• 从 console.apify.com/account/integrations 获取 Apify API 令牌，并将其设为 APIFY_TOKEN。即使没有令牌，服务也会列出其工具；但调用工具时需要令牌。

提示词示例

• “过去 12 个月，美国对抹茶的关注度有什么变化？”
• “比较美国都会区对咖啡和茶的关注度。”
• “Ozempic 相关的上升搜索词有哪些？”

工具

get_google_trends。只有一个工具。参数示例：

{
  "terms": [
    "coffee",
    "matcha"
  ],
  "geo": "US",
  "timeframe": "today 12-m"
}

输入项

actor 面向买家的所有输入项。省略的输入项将使用 actor 自身的默认值。

输入项	类型	必填	说明
terms	array	否	搜索词，每次运行最多 200 个。Google 主题 ID（如 /m/0j6n6s8）也可使用。
geo	string	否	留空表示全球范围；也可填写 Google 地理区域代码，如 US、DE 或 US-CA。
timeframe	string	否	now 1-H、now 4-H、now 1-d、now 7-d、today 1-m、today 3-m、today 12-m、today 5-y、all，或两个日期，格式为 YYYY-MM-DD YYYY-MM-DD。
category	string	否	Google Trends 类别编号。0 表示所有类别。该编号位于 Trends URL 的 cat= 部分。
property	string	否	要读取的 Google 搜索类型：web、news、images、youtube 或 shopping。
compare	boolean	否	true：每组 5 个搜索词一起绘制在同一图表上，并使用同一刻度。false：每个搜索词使用单独的图表。无论哪种情况，每个搜索词都会计费。
outputs	array	否	可选值：interest_over_time、interest_by_region、related_queries、related_topics。默认使用前三项。关于 related_topics，请参阅“限制”。
region_resolution	string	否	auto：全球范围按国家划分，单个国家内按地区划分。DMA 表示美国都会区。CITY 需要指定 geo。COUNTRY 需要 geo 留空。
max_charge_usd	string	否	可选。若某笔费用会超过此金额，则运行会在产生该费用前停止。始终会返回汇总行。
proxy_mode	string	否	auto（默认）：请求通过 Apify 代理池发送；若代理池无法完成请求，则会改用住宅地址重试。residential：每个请求都使用住宅地址。此项仅用于设置可靠性，不会改变费用。

定价

在 Apify 上按事件计费，费用记入你的 Apify 账户。价格以美元计。

事件	免费计划	Bronze	Silver	Gold
term-report，包含数据的一个搜索词，包含汇总行和最多 170 条详情行	$0.0065	$0.006175	$0.00585	$0.005525
extra-rows，单个搜索词超过前 170 条后，每增加 100 条详情行	$0.0035	$0.003325	$0.00315	$0.002975
apify-actor-start，每次运行启动	$0.002	$0.002	$0.002	$0.002

没有数据的搜索词、被 Google 拒绝的搜索词，以及被拒绝的输入均免费。Mamba Labs 支付运行的平台费用，包括 Apify 代理流量。

Actor 完整文档

apify.com/mambalabs/google-trends-scraper

许可证

MIT。参见 LICENSE。