linkfox-google-trends-rising

Google Trends 时间范围分析

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

核心概念

Google Trends 反映了用户在 Google 上的真实搜索兴趣。此工具会获取所选国家/地区在指定近期天数内的热门趋势话题（近期热门查询）。它非常适合用于发现某个市场当前正在走红的内容。

每个趋势查询的关键数据点：

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

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

参数指南

参数	类型	必填	默认值	描述
days	整数	否	7	时间范围，以天为单位。常见值：1（过去 24 小时）、2、7（过去一周）
region	字符串	否	US	国家/地区代码。请参阅下方的支持地区列表

支持的地区

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

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

API 用法

此工具调用 LinkFox 工具网关 API。有关调用约定、请求参数和响应结构，请参阅 references/api.md。你也可以直接执行 scripts/google_trends_rising.py 来运行查询。

使用示例

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. 错误处理：查询失败时，请根据错误响应说明原因，并建议调整参数（例如尝试其他地区代码或时间范围）。

重要限制

• 非结构化数据：此工具返回的结果为非结构化数据，无法提供给基于 SQL 的二级查询工具进行进一步处理。
• 相对搜索量：搜索量值为相对值，不是绝对计数。
• 较短的时间范围：days 参数用于控制数据的新近程度；此工具适用于近期/实时趋势，不适用于长期历史分析。
• 地区覆盖范围：仅支持列出的 18 个地区。不支持的地区代码会导致错误。

用户表达与场景快速参考

适用 -- 关于 Google 热门/流行话题的查询：

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

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

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

边界判断：当用户提到“市场趋势”或“流行什么”时，如果归根结底是在询问特定地区的人们当前在 Google 上搜索什么，则适用此技能。如果用户询问的是股市趋势、社交媒体爆红话题或长期历史搜索模式，则不适用。

反馈：

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

1. 此技能描述的功能或用途与实际行为不符
2. 此技能的结果与用户意图不符
3. 用户对这项技能表示不满或赞扬
4. 任何你认为可以改进的地方

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

处理大型响应

为避免占满 Agent 上下文，将响应保存到磁盘，并仅提取所需字段：

python scripts/response_io.py run --script scripts/google_trends_rising.py --out-dir <DIR> '<params>'
python scripts/response_io.py read <file> --fields "<paths>"   # or --path "<JMESPath>"

请将 --out-dir 指定在任何 git 工作树之外（例如 Unix 上的 /tmp/...，Windows 上的 %TEMP%/...）。持久化响应可能包含 PII、定价或身份验证敏感数据——请勿提交这些文件。文件不会自动删除；任务完成后请清理。

run 会将完整响应写入文件，并仅输出架构预览和文件路径。read 可提取特定字段，并使用 --limit/--offset 进行切片，使用 --format json|jsonl|csv|table 指定输出格式。

优先采用此模式的情况——根据响应特征自行判断，例如：

• 每条记录的字段数量很多，或包含你不需要的字段
• 批量/分页结果（一次调用返回多个项目）
• 长文本字段（描述、评论、HTML、时间序列）
• 输出会在后续步骤中重复使用，而非立即处理

对于小型、仅使用一次的响应，直接调用主脚本即可。

⚠️ 预览是经过截断的架构和样例，并非完整数据。任何字段级决策都必须通过 read 从持久化文件中读取。

---

如需更多高质量、专业的跨境电商技能，请设置 LinkFox Skills。