用途：查询并分析 Google Trends 关键词搜索热度数据，了解某关键词在不同地区随时间变化的流行程度。
主要能力：提供 0-100 归一化搜索热度（100 为所选范围内峰值，50 为峰值一半，0 表示数据不足）；支持区域包括 US、GB、JP、CA、MX、DE、FR、IT、ES、NL、AU、SG、AE、BR、IN、TR、PL、SE，默认 US；支持自定义时间段，日期格式 YYYY-MM-DD，从 2004 年起，同时提供起止日期时自定义范围优先；单次调用仅处理一个关键词，多关键词需分别调用后比较。
使用方式：设置 NEXSCOPE_API_KEY 环境变量；调用接口 POST /googleTrend/getTrendByKeys，或运行脚本 python scripts/google_trends_by_keywords.py '<JSON params>' [--inline]。参数含 keyword（必填，最长 100 字符）、region、dayRangeStart、dayRangeEnd。关键词须使用目标国家语言，如美国用英语、德国用德语、日本用日语，语言不符需先翻译。
输出与成本：默认将完整响应写入 <cwd>/nexscope/<YYYY-MM-DD>/<session>/data/ 下的 JSON 文件；响应体不超过 8 KB 时同时打印完整 JSON，超过则仅打印摘要，可用 --inline 强制完整输出。工具消耗积分，同一会话与参数组合默认仅调用一次，脚本含 24 小时本地缓存；失败或空结果不要改关键词、翻页或切换区域自动重试，需额外获取时应先告知用户会产生额外费用。认证失败（401/402）或余额不足错误可访问 https://www.nexscope.ai/help/skills-external-access?co-from=skillNS 获取 API Key 或充值。
适用场景：判断关键词热度升降、季节性峰值、月度规律、区域市场热度、历史趋势、节日搜索趋势等。
限制：结果为归一化相对值而非绝对搜索量；2004 年起数据可用，冷门词可能稀疏；结果非结构化，不能送入动态查询工具做二次 SQL 分析；不适用于 Google Ads 关键词规划与出价/CPC、绝对搜索量、社交媒体热搜、Amazon 专属搜索词（应使用 ABA Data Explorer）、网站流量分析及搜索引擎排名跟踪；图表数据 chartOption 可用于可视化描述。