用途:查询并分析指定时间窗口、指定国家/地区的 Google Trends 热门话题与趋势搜索,帮助发现近期正在升温的搜索词。
主要能力:返回每个趋势查询的 query(趋势搜索词)、searchVolume(相对搜索量)、increasePercentage(搜索热度变化百分比,-100 到 100,正值上升、负值下降,接近 100 表示爆发式增长)、startTime / endTime(趋势观察窗口时间戳)。支持 18 个地区:US、GB、JP、CA、MX、DE、FR、IT、ES、NL、AU、SG、AE、BR、IN、TR、PL、SE,默认 US。
参数:days(整数,可选,默认 7,常用 1 表示最近 24 小时、2、7 表示过去一周);region(字符串,可选,默认 US)。
使用方式:API 端点 POST /googleTrend/getTrendByTime;脚本命令 python scripts/google_trends_by_time.py '<JSON params>' [--inline]。需设置 NEXSCOPE_API_KEY 环境变量;若认证失败(401/402)或余额不足,可访问 https://www.nexscope.ai/help/skills-external-access?co-from=skillNS 获取 API Key 或充值。示例:{"days": 7, "region": "US"}、{"days": 1, "region": "JP"}。
输出:默认将完整响应写入 <cwd>/nexscope/<YYYY-MM-DD>/<session>/data/nexscope-google-trend-get-trend-by-time-<timestamp>.json,响应体不超过 8 KB 时打印完整 JSON,超过时仅打印摘要;--inline 可强制完整输出。建议先用摘要判断是否足够,再用 jq 或 ConvertFrom-Json 按需提取字段。
展示:以表格呈现趋势词、搜索量、涨幅百分比,按需排序;涨幅显著(如高于 50%)时重点提示;总结时说明时间范围与地区;若有 chartOption 可描述图表结构。
限制:结果为非结构化数据,不能输入二次 SQL 查询工具;搜索量为相对值而非绝对数量;days 仅控制近期窗口,适合实时/近期趋势,不用于长期历史分析;仅支持所列 18 个地区,不支持的地区代码会报错;该工具消耗额度,同一会话加相同参数默认只调用一次,脚本含 24 小时本地缓存,失败或空结果不要自动改词、翻页或换地区重试,如需再次检索应先告知用户额外成本。不适用于历史关键词搜索量、Amazon 关键词或 ASIN 分析、广告/PPC 管理、社交媒体趋势、SEO 排名或外链分析、竞品流量估算。