用途：通过 Nexscope 数据源查询 Amazon 关键词的精确匹配历史搜索量，按周（7 天）粒度返回指定日期区间内的搜索量数据点，覆盖 10 个 Amazon 站点（us、uk、de、in、ca、fr、it、es、mx、jp），默认站点为 us。适合分析关键词季节性、趋势方向（上升/下降/平稳）、需求波动、节假日与大促期间的搜索量峰值。
主要能力与输出字段：返回 Period ID（id）、周期开始日期（estimateStartDate）、周期结束日期（estimateEndDate）、精确搜索量（estimatedExactSearchVolume，单位：次/周）、资源类型（type，固定为 historical_keyword_search_volume）与消耗令牌（costToken）。数据粒度为周，非日度；搜索量类型为精确匹配，非广泛匹配。
使用方式：调用 API 端点 POST /tool-jungle-scout/keywords/historical-search-volume，或运行 python scripts/amazon_keyword_search_history.py '<JSON params>' [--inline]。四个参数均为必填：marketplace、keyword、startDate、endDate；日期格式必须为 YYYY-MM-DD。需设置 NEXSCOPE_API_KEY 环境变量；若凭证缺失或过期，可访问 https://www.nexscope.ai/help/skills-external-access?co-from=skillNS 充值额度。
查询构建：单次查询时间跨度最大 366 天，超出需拆分为多次请求；关键词按用户提供原样传入（建议小写英文）。常见场景包括近半年趋势、全年季节性、旺季与淡季对比（分两次调用）、多站点对比、需求增长验证。展示上建议用折线/时间线图，X 轴为日期周期、Y 轴为搜索量，并配数据表与趋势总结，标注峰值与低谷周期。
成本与输出策略：该工具消耗额度，同一会话与参数组合默认仅调用一次，脚本内置 24 小时本地缓存。失败或结果为空时，不要自动改关键词、翻页或换邮编重试；继续搜索前应告知用户额外消耗。脚本默认将完整响应写入 <cwd>/nexscope/<YYYY-MM-DD>/<session>/data/nexscope-junglescout-keyword-history-<timestamp>.json；响应体不超过 8 KB 时保存后在标准输出打印完整 JSON，超过 8 KB 时仅打印摘要；加 --inline 可强制完整输出。建议先看摘要，再按需用 jq 或 ConvertFrom-Json 从保存的 JSON 中提取字段。
限制：单次时间跨度上限 366 天；数据为周粒度；仅返回精确匹配搜索量；四参数必填。不适用于关键词建议/拓展、实时或当前搜索量排名、关键词竞争与 CPC 出价、商品销量与 listing 分析、非 Amazon 平台搜索量。当用户想了解某关键词搜索量在某一时间段内的历史变化趋势时适用；若需要当前排名或热门关键词列表则不适用。其余如具体定价、速率限制等信息资料暂未提供。