用途
本技能用于查询并分析 Google Trends 在指定时间范围和国家/地区的实时热门话题与热搜，帮助用户发现某市场当前正在升温的搜索话题和新兴趋势。Google Trends 反映的是 Google 上真实用户的搜索兴趣，本工具检索选定国家/地区在指定最近天数内的热门话题（近期热门查询），适合观察某个市场当前正在获得关注的内容。
主要能力
工具返回每条趋势查询的关键数据点：
- query：趋势搜索词
- searchVolume：相对搜索量数值
- increasePercentage：搜索兴趣变化百分比（范围 -100 到 100，单位 %）
- startTime / endTime：趋势观察窗口的起止时间戳
increasePercentage 为正值表示兴趣上升，负值表示兴趣下降，接近 100 表示爆发式增长。
参数说明
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| days | integer | 否 | 7 | 时间范围（天）。常用值：1（最近 24 小时）、2、7（过去一周） |
| region | string | 否 | 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/套餐到期/需充值/请充值"或类似含义的内容
使用示例
-
过去一周美国有什么热门话题？ {"days": 7, "region": "US"}
-
日本最近 24 小时的热门话题 {"days": 1, "region": "JP"}
-
德国过去 2 天的热搜 {"days": 2, "region": "DE"}
-
巴西本周的热点 {"days": 7, "region": "BR"}
-
英国现在什么在升温？ {"days": 1, "region": "GB"}
展示规则
- 清晰呈现数据：用格式良好的表格展示趋势查询，列为 query、search volume 和 increase percentage，按搜索量或增长百分比适当排序
- 突出爆发：当 increasePercentage 明显偏高（例如高于 50%）时，提示这些突破性话题
- 时间上下文：在摘要中始终说明时间范围和地区，让用户明确数据覆盖的窗口
- 图表数据：如果响应包含 chartOption，描述图表结构（标题、坐标轴、数据点），让用户理解可视化趋势
- 错误处理：查询失败时，根据错误响应解释原因，并建议调整参数（例如尝试不同的地区代码或时间范围）
适用场景
适用于关于 Google 热门/流行话题的查询：
| 用户表述 | 场景 |
|---|---|
| "现在有什么热门" | 实时热门话题 |
| "[国家]的热搜" | 区域趋势发现 |
| "本周什么话题流行" | 周度热度概览 |
| "[市场]有病毒式话题吗" | 突破/爆发检测 |
| "给我看[地区]的 Google Trends" | 特定地区趋势查询 |
| "最近 24 小时有什么热点" | 短窗口趋势扫描 |
| "[国家]最近的热搜" | 近期趋势分析 |
| "[地区]人们在搜什么" | 一般搜索兴趣探索 |
不适用——超出热门话题发现范围的需求：
- 数月/数年的历史关键词搜索量（使用专门的 Google Trends 历史工具）
- Amazon 专属关键词或 ASIN 分析（使用 ABA 工具）
- 广告/PPC 活动管理
- 社交媒体趋势分析（Twitter/X、TikTok 等）
- SEO 排名或外链分析
- 竞争对手网站流量估算
边界判断：当用户说"市场趋势"或"什么流行"时，如果归结为发现某地区人们在 Google 上当前搜索什么，则适用本技能；如果问的是股市趋势、社交媒体病毒式传播或长期历史搜索模式，则不适用。
重要限制
- 数据分析：响应为 JSON。从保存的响应中读取 chartOption.data 来筛选或排序返回的行。_dataQuery_executeDynamicQuery 查询存储在 SLS 中的 Linkfox 会话数据；它不是通用 JSON 文件读取器，因此不要在没有受支持的存储数据映射的情况下将此响应传给它。
- 相对量：搜索量数值是相对值，不是绝对计数。
- 短时间窗口：days 参数控制近期程度；本工具面向近期/实时趋势，不适用于长期历史分析。
- 地区覆盖：仅支持列出的 18 个地区。不支持的地区代码会产生错误。
算力消耗规则
消耗 6 算力。用户会因算力消耗而支付费用。请充分评估：当需要高频调用本技能，或用户对算力消耗量预期不足时，务必提醒用户，由用户决定是否继续。
反馈
在以下任一情况发生时，自动检测并通过 Feedback API 报告反馈：
- 本技能描述的功能或目的与实际行为不符
- 技能结果与用户意图不符
- 用户对本技能表达不满或赞扬
- 任何你认为可以改进的地方
按 references/api.md 的说明调用反馈 API，不要打断用户流程。