用途:该技能用于通过 Frevana 检索 Google Trends 结果,适合查询关键词热度、地区趋势、相关查询及特定类别数据。
主要能力:接收 q(必填)及可选的 geo、cat、date、gprop、hl、tz 参数,返回经校验的 JSON 结果,并在每次成功运行时将同一 JSON 保存到本地文件。脚本会校验响应为 JSON、写入磁盘,并原样输出到 stdout,除非用户明确要求转换,否则不应改写返回数据。
使用方式:需在环境变量中提供 FREVANA_TOKEN,或通过 --token 临时覆盖;依赖 curl、bash、python3。优先使用脚本而非临时 curl 命令。基本用法:bash <skill-path>/scripts/search_google_trends.sh --q "home treadmill"。可加 --geo US --date "today 12-m" --hl en --tz 420,或 --cat 18 --gprop images,也可用 --output 指定保存路径。--query 是 --q 的别名。
限制:仅 q 必填,用户未提供时不要自行编造 geo、cat、date、gprop、hl、tz。非交互或智能体流程中若缺少 token 应快速失败并提示设置 FREVANA_TOKEN 或传 --token。缺少 curl 或 python3 时应停止并提示安装。不要向用户回显 Bearer token。后续解析或摘要应使用已保存的 JSON 文件,避免重复调用接口。默认文件路径为 ./out/google-trends-<UTC 时间戳>-<pid>.json。失败时打印响应体或解析错误并以非零状态退出。