Google Trends MCP 服务器是一个由 HasData 维护的托管式模型上下文协议（MCP）服务器，为 Claude、Cursor、Windsurf 及其他 MCP 客户端提供访问 Google Trends 数据的工具。它通过一个单一工具，让 AI 客户端能够以结构化 JSON 的形式获取关键词的随时间兴趣度、按地区的兴趣度，以及上升和相关查询与主题。整个过程无需维护爬虫库，也无需 Google 账号。
用途 该服务器用于将 Google Trends 数据集成到 AI 工作流中。用户可以使用自然语言提示，让 AI 代理自动调用工具获取趋势数据，用于市场分析、内容规划、需求判断等场景。所有数据均来自 Google Trends 内部端点，服务器将其封装为稳定的模式并返回 JSON。
主要能力
- 单一工具
hasdata_google_trends_search_getTrendsData，支持以下dataType：timeseries（默认）：返回随时间变化的兴趣度，值为 0 到 100 的相对指数，每个数据点同时提供字符串和预解析的extractedValue。最新点常带有isPartial: true，表示该周数据尚未完整，建议在计算趋势前丢弃。geoMap：返回按地区划分的兴趣度。relatedQueries：返回相关查询，分为rising和top。rising条目显示如+300%或Breakout的百分比，extractedValue提供对应数值，Breakout的extractedValue为哨兵值，应按字符串标签排序。relatedTopics：返回相关主题，同样分为rising和top。
- 支持在
timeseries和geoMap中一次比较多个关键词（逗号分隔）。 - 提供 1 个提示（prompt）和 5 个资源（resources），资源对应固定值列表的参数，URI 格式为
hasdata://google_trends/<parameter>，无需 API 密钥即可读取。 - 错误处理：工具调用失败时 MCP 层返回 200 并将错误置于结果内，
isError为 true。常见错误包括无效 API 密钥（返回 401 文本）、缺少密钥（HTTP 401 连接失败）、输入验证错误（MCP error -32602）。搜索量过低的词会返回空数组成功结果。未知geo或cat值返回 422 并列出可接受选项。
使用方式
- 需要 MCP 客户端和 HasData API 密钥（在 HasData 仪表板免费创建，无需信用卡）。免费层提供 1,000 积分/月，约 100 次调用。
- 远程服务器 URL：
https://mcp.hasdata.com/mcp?apis=google_trends，通过x-api-key请求头传递密钥。 - 支持 OAuth 的客户端可直接添加为连接器并登录。
- 仅支持 stdio 的客户端可通过启动器连接：
- Claude Desktop：在
claude_desktop_config.json中使用@hasdata/google-trends-mcp（Node）或hasdata-google-trends-mcp（Python，uvx 运行）。 - Cursor：在
~/.cursor/mcp.json或.cursor/mcp.json中配置。 - Windsurf：在
~/.codeium/windsurf/mcp_config.json中使用serverUrl字段。 - VS Code：在工作区
.vscode/mcp.json中配置。
- Claude Desktop：在
apis查询参数可指定暴露的工具，如?apis=google_trends仅暴露该工具；省略则暴露全部 57 个 HasData 工具；错误名称被忽略，全部错误时返回 400。
适用场景
- AI 代理和自动化管道需要稳定格式的趋势数据。
- 市场研究、内容策略、需求分析等需要 Google Trends 数据的场景。
- 与其它 HasData API（如 Google SERP）组合使用，通过
apis参数指定多个。
限制
- Google 未提供公开的 Trends API，所有方案均读取同一内部端点。
- 数据为相对兴趣度（0-100），非绝对搜索量。
- 每次成功调用消耗 10 积分，响应大小不影响价格。免费层允许 1 个并发请求，付费层并发更高（Startup 5、Basic 15、Growth 50-500）。
- 非 200 响应不计费，但成功但无数据仍计费。
- 仅访问公开数据，用户需自行遵守平台条款。
