用途:借助 Crawlora 的 Google Trends 端点,生成带明确关键词、地区、时间范围和搜索属性的搜索热度比较,用于主题需求简报与关键词研究。Trends 衡量的是相对搜索热度,不代表销量、人群观点或绝对搜索量。
主要能力:提供十一个 Trends 工具,涵盖兴趣随时间变化、地区兴趣、热门查询、上升查询、相关主题、Trending Now 及其详情等。可用 /google/trends/enums、/locations、/categories 发现支持的取值;探索类别与 Trending Now 类别是不同集合,不可混用 ID。
使用方式:设置环境变量 CRAWLORA_API_KEY(来自 crawlora.net),运行本技能目录下的 scripts/crawlora.sh 或使用绝对路径,脚本会向 https://api.crawlora.net/api/v1 发送 x-api-key 并输出 JSON。比较时向 /google/trends/explore/interest-over-time 发送扁平字段 keywords(1–5 个字符串)、geo、time_range、type,不要嵌套在 catalog 的 request body 标签内;优先用 type(web、image、news、youtube、shopping)而非旧版 property。示例: scripts/crawlora.sh /google/trends/enums scripts/crawlora.sh -X POST /google/trends/explore/interest-over-time '{"keywords":["coffee","tea"],"geo":"US","time_range":"today 12-m","type":"web"}'
解读与限制:兴趣分数在查询上下文内归一化为 0–100,独立缩放的请求之间不可直接比较;超过五个词应分面板或使用共享锚点方法并说明局限。零值或 has_data=false 可能表示数据不足,应保留缺失标记,不要替换为零或断言无需求。地区分数相等不代表搜索量相等。区分字面关键词与相关主题实体,保留 Breakout 标签而非编造增长率。声称季节性需足够长的序列,单一尖峰不能确立规律。报告应含术语、筛选条件、采集时间、查询/来源 URL、解读与缺失组件,坐标轴标注为相对指数。服务已对限流组件重试;遇 503/429 遵循 Retry-After 并做有界重试,避免快速重复调用或并发扇出;遇 401/403 停止并检查应用代码。缺失结果应如实报告,不得编造完整比较。