HasData Google Trends

Google Trends MCP 服务

托管式 Model Context Protocol（MCP）服务，为 Claude、Cursor、Windsurf 及其他 MCP 客户端提供一个 Google Trends 工具。查询任意词条的热度随时间变化、各地区热度，以及相关查询和主题的上升趋势与热门内容，所有结果均为结构化 JSON；无需维护抓取库，也无需 Google 账号。

每月可免费使用 1,000 个点数，无需绑定银行卡，相当于调用 Google Trends 100 次。

https://mcp.hasdata.com/mcp?apis=google_trends

• 提示词和资源

目录

• 所需条件
• 快速开始
• 示例提示词
• 工具
• 错误和失败路径
• 定价、免费额度和限制
• 工具选择
• 比较
• 常见问题
• HasData 链接
• 开发
• 贡献
• 许可证

所需条件

一个 MCP 客户端，以及从控制面板获取的 HasData API 密钥。注册免费，无需绑定银行卡；免费额度按每次调用 10 个点数计算，每月约可调用 100 次。这是一个远程服务，因此最简单的接入方式是使用 URL 和 x-api-key 标头，无需运行容器，整个流程也不需要 Google 账号。仅支持 stdio 的客户端可通过轻量启动器访问该服务；启动器发布于 npm，包名为 @hasdata/google-trends-mcp，也发布于 PyPI，包名为 hasdata-google-trends-mcp，如下所示。

快速开始

所有客户端使用的服务 URL 都相同。我们会在 Claude Code 和 Claude Desktop 中手动运行。其他代码块遵循各客户端针对远程服务所记录的格式。

支持 OAuth 的客户端可以将同一 URL 添加为连接器，然后登录，无需在配置文件中填写密钥。

claude mcp add --transport http google-trends "https://mcp.hasdata.com/mcp?apis=google_trends" \
  --header "x-api-key: HASDATA_API_KEY"

{
  "mcpServers": {
    "google-trends": {
      "command": "npx",
      "args": ["-y", "@hasdata/google-trends-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

{
  "mcpServers": {
    "google-trends": {
      "command": "uvx",
      "args": ["hasdata-google-trends-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

{
  "mcpServers": {
    "google-trends": {
      "url": "https://mcp.hasdata.com/mcp?apis=google_trends",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

{
  "mcpServers": {
    "google-trends": {
      "serverUrl": "https://mcp.hasdata.com/mcp?apis=google_trends",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

{
  "servers": {
    "google-trends": {
      "type": "http",
      "url": "https://mcp.hasdata.com/mcp?apis=google_trends",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

示例提示词

用提示词，而不是代码。粘贴一条提示词，Agent 就会自行选择工具。每条例子都标注了所需的调用次数，因为每次成功调用需消耗 10 个积分。

绘制美国过去 12 个月“cold brew coffee”的关注度图表，并告诉我关注度在哪几周达到峰值。

调用一次，10 个积分。周度序列会在单个请求中返回。

给出美国“cold brew coffee”的上升相关查询，并标出其中标记为 Breakout 的查询。

调用一次，10 个积分。

对比过去五年全球“cold brew”和“iced coffee”的关注度，并说明哪一种正在增长。

调用一次，10 个积分。该工具可在一次时间序列请求中处理多个词条。

展示过去 90 天美国各州对“sunscreen”的关注度，以便查看需求最高的地区。

调用一次，10 个积分。这是按州粒度显示的地区关注度视图。

多个词条的比较通过一次 timeseries 调用完成。地区细分、相关查询和相关主题各自属于独立的 dataType，因此，既要图表又要上升相关查询的提示词需要调用两次。

工具

这是一个只读工具。下面的示例摘自真实调用，但数字会随着趋势变化。请将其视为趋势轮廓。工具名称链接到其端点参考，其中列出了完整的参数清单。

示例展示的是载荷，而非完整响应。tools/call 结果包含一个文本块，该文本本身是一个包含 url、status、text 和 json 的 JSON 对象，抓取的数据位于 json 下。对于原始 JSON-RPC 响应，路径为 result.content[0].text，解析后再取 .json。聊天客户端会为你解包，而直接与端点交互的代码则不会。

获取 Google Trends 数据

hasdata_google_trends_search_getTrendsData

查询某个词的关注度趋势、区域分布或相关查询和主题。

响应键取决于 dataType。timeseries 返回 interestOverTime.timelineData，geoMap 返回各区域的关注度，相关类型则返回 relatedQueries 或 relatedTopics，每种类型都分为 rising 和 top。请读取与所请求类型对应的键。

timeseries（默认类型）会为每个数据点返回一个 0 到 100 之间的值，既以字符串形式返回，也会预先解析到 extractedValue 中。最新的数据点通常带有 isPartial: true，表示该周的数据仍在汇总。计算趋势前请将其剔除，否则最后一个柱形会呈现一个并非真实的下跌。

{
  "interestOverTime": {
    "timelineData": [
      { "date": "Apr 12 – 18, 2026", "timestamp": "1775952000", "isPartial": false,
        "values": [{ "query": "cold brew coffee", "value": "100", "extractedValue": 100, "hasData": true }] },
      { "date": "Aug 23 – 29, 2026", "timestamp": "1787443200", "isPartial": true,
        "values": [{ "query": "cold brew coffee", "value": "44", "extractedValue": 44, "hasData": true }] }
    ]
  }
}

relatedQueries 分为 rising 和 top。上升条目的值以百分比形式显示，例如 +300%；如果增幅过大而无法计算，则显示 Breakout，extractedValue 会给出对应的数值。Breakout 返回的 extractedValue 是一个远高于任何真实百分比的哨兵值，因此应根据字符串标签排序，而不是根据原始数值排序。

{
  "relatedQueries": {
    "rising": [
      { "query": "organic cold brew coffee", "value": "+300%", "extractedValue": 300, "link": "https://trends.google.com/trends/explore?q=organic+cold+brew+coffee&date=today+12-m&geo=US" }
    ],
    "top": [
      { "query": "how to cold brew coffee", "value": "100", "extractedValue": 100, "link": "https://trends.google.com/trends/explore?q=how+to+cold+brew+coffee&date=today+12-m&geo=US" }
    ]
  }
}

端点参考列出了该工具接受的所有 geo、cat 和日期格式。

提示词和资源

该服务提供一个提示词，即现成的工作流，客户端可以直接提供给用户，而不必让用户自行编写工具调用。

此外，该服务还提供 5 个资源，每个资源对应一个可接受值为固定列表的参数。读取资源比从一次被拒绝的调用中了解相关词汇更省事，而且不消耗积分。每个 URI 的格式为 hasdata://google_trends/<parameter>。

两个列表都无需 API 密钥即可获取，因此客户端可以在用户注册前读取这些列表。

错误和故障路径

客户端几乎不会从工具调用中看到 HTTP 错误代码。MCP 层会返回 200，并将故障放在结果中，设置 isError 为 true，并以文本形式给出原因。Agent 读取的是一条消息，而不是你可能预期的状态行。

错误的密钥会显示为工具输出，而不是连接失败。 tools/list 接受任意非空密钥并返回工具，因此客户端可以完成握手并显示绿色状态。随后，首次工具调用会返回 isError: true，文本为 HasData API error: 401 Unauthorized。请留意这段字符串，因为流程前面的任何步骤都不会报告此问题。

缺少密钥才会导致真正的 HTTP 错误。 授权检查会在执行任何工具前运行，连接本身会以 401 失败。响应中包含 CORS 标头，浏览器客户端可以读取状态，而不会只收到不透明的网络失败。

不符合工具架构的参数会在开始抓取前被拒绝。 服务会返回 isError: true，文本为 MCP error -32602: Input validation error，并指出有问题的字段。不会获取任何数据，也不会扣除任何积分。

搜索量过低的词条会返回成功结果，但数据数组为空，不会报错。对于罕见词条，Google Trends 没有数据可显示，而 requestMetadata.status 仍为 ok。绘制图表前，请先检查是否有数据点。

不在文档列表中的标识符会在抓取前被拒绝。 geo 和 cat 都是枚举类型，因此未知值会返回 422，指出相关字段并列出可接受的选项，而不是悄无声息地返回空结果。

包含数据的结果也会包含 requestMetadata.id，你可以在联系支持时引用它。

定价、免费额度和限制

每次 Google Trends 调用成功后都会消耗 10 个额度点。响应大小不会影响价格。五年的每周数据序列与单周数据的价格相同。

免费额度为每月 1,000 个额度点，无需绑定银行卡，可调用 Google Trends 100 次。额度会随计费周期续订，因此低调用量的 Agent 可以一直使用免费额度。

付费方案起价为每月 $59，包含 200,000 个额度点，即 20,000 次调用。调用量越大，单价越低：入门方案每 1,000 次调用 $1.48，Basic 方案为 $0.60，Growth 各档方案为 $0.41。当前价格请见定价页面。

方案还决定并发数。免费额度允许同时处理 1 个请求，Startup 为 5 个，Basic 为 15 个，Growth 各档为 50 到 500 个。在任何无人值守的场景中，都应谨慎处理超出限制的情况。

未返回 200 状态码的请求不会计费。成功但未找到任何结果的调用仍会计费。

工具选择

apis 查询参数决定 Agent 能看到哪些工具。工具越少，工具定义占用的上下文就越少，模型选错工具的可能性也越低。

?apis=google_trends              the one tool in this repo
?apis=google_trends,google_serp  add Google search
?apis=google_trends,youtube      trends plus YouTube

此参数接受 google_trends 这样的提供方名称，也接受单个 API 名称。拼写错误的名称会被忽略。如果所有名称都无效，请求会以 400 错误失败，响应正文会列出无法识别的名称以及所有有效值。移除该参数后，同一端点会公开全部 57 个 HasData 工具。

对比

Google 没有发布公开的 Trends API。常见的两种做法是使用非官方的 pytrends 库（它对相同的内部端点进行逆向工程，在 Google 更改端点或限制调用方速率时就会失效），以及自行编写爬虫。此 MCP 服务在稳定的架构下完成了这些工作。

如果你已经以较低调用量运行 pytrends，并且不介意在它出故障时进行修复，那么它仍然是免费的选择。此 MCP 服务适用于需要每次都以相同格式获取数据的 Agent 和流水线。

常见问题

有官方的 Google Trends API 吗？

没有。Google 从未发布过公开的 Trends API。所有方案读取的都是 trends.google.com 网站使用的相同内部端点。此服务由 HasData 维护，并以结构化 JSON 返回结果。

什么是 Google Trends MCP 服务？

它是一个将 Google Trends 暴露为 AI 客户端可调用工具的服务。客户端通过 Model Context Protocol 发送工具调用，服务获取数据并返回结构化 JSON，模型再处理结果。此服务只暴露一个工具，并且在远程运行，因此客户端连接 URL 即可使用，无需启动本地进程。

这些数字代表绝对搜索量吗？

不代表，Google Trends 本身也不代表。对于你指定的查询、时间范围和地区，这些值表示相对热度，范围为 0 到 100。应将其用于观察趋势和进行比较，而不是当作搜索次数。

为什么最新的数据点比其他数据点低？

最新的数据区间通常尚未填满，返回结果中会带有 isPartial: true。计算趋势前应将其移除。

可以同时比较多个词条吗？

可以，在 timeseries 和 geoMap 中都可以。将词条以逗号分隔后传入 q。相关查询和相关主题类型只接受单个词条。

我可以将它与其他 HasData API 一起使用吗？

可以。apis 参数接受一个列表，?apis=google_trends,google_serp 会为你的 Agent 提供 Trends 和 Google 搜索。移除该参数（参见工具选择），即可获取全部内容。

合规与个人数据

HasData 仅访问公开可用的数据。平台的条款可能限制自动访问，你需要自行确保合规。

HasData 链接

开发

此仓库包含远程服务的配置和文档。无需构建，也无需容器化。

test/ 中的测试用于验证工具契约，也就是无需提交代码便可能发生变化的部分。它们会检查 ?apis=google_trends 是否恰好返回一个工具、该工具是否仍声明了必需参数、名称是否未发生变化，以及正在使用的密钥是否确实可用。最后一项检查会实际调用工具，耗费 10 个积分，这就是一次可能因正确原因而失败的金丝雀测试。

# macOS and Linux
HASDATA_API_KEY=your_key_here npm test

# Windows PowerShell
$env:HASDATA_API_KEY="your_key_here"; npm test

相同的测试套件会在每次推送时于 CI 中运行，也会每周定时运行一次，因为上游工具列表可能在无人改动此仓库的情况下发生变化。测试失败意味着工具列表发生了变化、密钥停止工作或端点无法访问，断言消息会指出具体原因。

贡献

修正参数表和响应示例是最有用的贡献，因为这两部分最容易过时。请附上你发出的调用和收到的响应。来自 Fork 的拉取请求会在不使用密钥的情况下运行测试套件，实时检查则会跳过，不会导致测试失败。

许可证

MIT。请参阅 LICENSE。