mcpField
L
linkfox-google-trend-get-trend-by-time

linkfox-google-trend-get-trend-by-time

github.com/linkfox-ai营销与增长113237 次安装2 周前更新
代码仓库

关于 linkfox-google-trend-get-trend-by-time

该 LinkFox 技能用于查询指定时间范围和地区的 Google Trends 热门搜索，面向需要发现近期搜索趋势的市场人员。它提供 18 个地区的趋势数据及搜索量变化百分比，适合短期趋势观察而非长期历史分析。

主要功能

  1. 01按天数和地区查询趋势
  2. 02覆盖 18 个支持地区
  3. 03返回相对搜索量与变化率
  4. 04支持短期热门搜索分析

适用场景

  1. 01查看某地区过去一周热门搜索
  2. 02发现过去 24 小时的新兴话题
  3. 03比较近期搜索热度升降

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/linkfox-ai/linkfox-skills --skill linkfox-google-trend-get-trend-by-time

安装后在 Claude Code 中输入/linkfox-google-trend-get-trend-by-time确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
api.md
onboarding.md
scripts/
google_trends_rising.py
onboarding.py

详细介绍

Google Trends 时间范围分析

本技能将指导你如何查询和分析可配置时间窗口内的 Google Trends 数据，帮助用户发现 18 个受支持地区的实时热门搜索和新兴趋势。

核心概念

Google Trends 反映了用户在 Google 上的真实搜索兴趣。此工具会检索所选国家/地区在指定的最近天数内的热门话题（近期受欢迎的查询）。它非常适合用来发现某个市场中当前正在升温的话题。

每个热门查询的关键数据点：

  • query -- 热门搜索词
  • searchVolume -- 相对搜索量
  • increasePercentage -- 搜索兴趣变化百分比（-100 至 100，单位：%）
  • startTime / endTime -- 趋势观测窗口的起止时间戳

increasePercentage 为正值表示兴趣上升；为负值表示兴趣下降。数值接近 100 表示出现了爆发式增长。

参数指南

参数类型必填默认值说明
daysinteger否7时间范围，以天为单位。常用值：1（过去 24 小时）、2、7（过去一周）
regionstring否US国家/地区代码。请参阅下方的受支持地区
受支持的地区

US（美国）、GB（英国）、JP（日本）、CA（加拿大）、MX（墨西哥）、DE（德国）、FR（法国）、IT（意大利）、ES（西班牙）、NL（荷兰）、AU（澳大利亚）、SG（新加坡）、AE（阿联酋）、BR（巴西）、IN（印度）、TR（土耳其）、PL（波兰）、SE（瑞典）

默认地区为 US。用户未指定地区时，请使用 US。

调用方式

  • API 端点：POST /googleTrend/getTrendByTime（完整参数/响应/错误码见 references/api.md）
  • Python 脚本：python scripts/google_trends_rising.py '<JSON 参数>' [--inline]
  • 成本约束：本工具会消耗算力；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。

输出策略（脚本默认行为）：

  • 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-google-trend-get-trend-by-time-<timestamp>.json（<cwd> 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；<session> 取自环境变量 SESSION_ID，按用户任务自动聚合；禁止写入 /tmp，当前目录不可写则报错）
  • 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout
  • 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 total/costToken、最大列表字段的长度 + 前 3 条样本）
  • 加 --inline 强制全量打印到 stdout（同样落盘）

读数据建议：先看摘要判断是否足够；需要具体字段时优先用 jq或ConvertFrom-Json 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。

解决认证和算力问题

发生以下异常情况时，采用 references/onboarding.md 引导解决问题：

异常情况
  • 未配置API Key：环境变量未配置 LINKFOX_AGENT_API_KEY，也未配置 LINKFOXAGENT_API_KEY。
  • 响应401或402状态码
  • 响应提示算力或余额不足：消息含"算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值"，或类似含义的内容。

使用示例

1. 过去一周美国有哪些热门话题？

{"days": 7, "region": "US"}

2. 过去 24 小时日本的热门话题

{"days": 1, "region": "JP"}

3. 过去 2 天德国的热门搜索

{"days": 2, "region": "DE"}

4. 本周巴西近期热议的话题

{"days": 7, "region": "BR"}

5. 英国目前有哪些话题正在走红？

{"days": 1, "region": "GB"}

显示规则

  1. 清晰呈现数据：使用格式清晰的表格展示热门查询，列出查询词、搜索量和增长百分比。根据需要按搜索量或增长百分比排序。
  2. 突出飙升话题：当 increasePercentage 特别高（例如高于 50%）时，请特别指出这些爆红话题。
  3. 时间背景：摘要中务必注明时间范围和地区，让用户准确了解数据覆盖的时间窗口。
  4. 图表数据：如果响应包含 chartOption，请描述图表结构（标题、坐标轴、数据点），以便用户理解趋势可视化。
  5. 错误处理：查询失败时，根据错误响应说明原因，并建议调整参数（例如尝试其他地区代码或时间范围）。

重要限制

  • 数据分析：响应为 JSON。请从已保存的响应中读取 chartOption.data，以筛选或排序返回的行。_dataQuery_executeDynamicQuery 查询的是存储在 SLS 中的 Linkfox 会话数据，并非通用的 JSON 文件读取器；因此，除非存在受支持的存储数据映射，否则不要将此响应传递给它。
  • 相对搜索量：搜索量数值为相对值，并非绝对数量。
  • 短时间窗口：days 参数控制数据的新近程度；此工具适用于近期／实时趋势，而非长期历史分析。
  • 地区覆盖范围：仅支持列出的 18 个地区。不支持的地区代码会导致错误。

用户表达与场景速查

适用——关于 Google 热门话题的查询：

用户表达场景
“现在有什么热门趋势”实时热门话题
“[国家]的热门搜索”地区趋势发现
“本周有哪些热门话题”每周热度概览
“[市场]有哪些走红话题”爆发／激增检测
“显示[地区]的 Google Trends”特定地区趋势查询
“过去 24 小时有什么热门话题”短时间窗口趋势扫描
“[国家]最近的热门搜索”近期趋势分析
“[地区]的人们在搜索什么”一般搜索兴趣探索

不适用——需求超出热门话题发现范围：

  • 跨月／跨年的历史关键词搜索量（请使用专用的 Google Trends 历史查询工具）
  • Amazon 专属关键词或 ASIN 分析（请使用 ABA 工具）
  • 广告／PPC 广告系列管理
  • 社交媒体趋势分析（Twitter/X、TikTok 等）
  • SEO 排名或反向链接分析
  • 竞争对手网站流量估算

边界判断：当用户提到“市场趋势”或“有什么热门内容”时，如果其本质是在询问特定地区的人们目前在 Google 上搜索什么，则适用此技能。如果用户询问的是股市趋势、社交媒体走红情况或长期历史搜索模式，则不适用。

算力消耗规则

消耗 6 算力。

用户会因算力消耗而支付费用。请充分评估：当需要高频调用本技能，或用户对算力消耗量预期不足时，务必提醒用户，由用户决定是否继续。

反馈：

当出现以下任一情况时，通过 Feedback API 自动检测并报告反馈：

  1. 此技能描述的功能或用途与实际行为不符
  2. 此技能的结果与用户意图不符
  3. 用户表达了对本技能的不满或赞扬
  4. 你认为有任何可以改进之处

请按照 references/api.md 中的说明调用反馈 API。不要打断用户的流程。

如需更多高品质、专业的跨境电商技能，请访问 LinkFox Skills。

评论

支持 Markdown