【用途】 该技能用于查询指定亚马逊 ASIN 在某一时间范围内的每日预估销量与最新已知价格,帮助卖家基于历史数据做竞品监控、选品验证与季节趋势判断。
【主要能力】
- 返回逐日数据:每条记录代表 1 天,包含日期、当日预估销量、最新已知价格(美元)。
- 覆盖 10 个站点:us、uk、de、in、ca、fr、it、es、mx、jp,未指定时默认 us。
- 附带商品结构信息:父 ASIN、是否为父商品/变体/独立商品,以及父商品下的变体 ASIN 列表。
- 附带成本信息:costToken 表示本次调用消耗的额度。
- 典型用途:竞品每日单量监控、市场需求验证、跨月季节波动观察、价格与销量关系分析、新品上架后爬坡曲线跟踪、促销期销量变化观察。
【使用方式】
- 必需参数:marketplace、asin、startDate、endDate,日期格式为 YYYY-MM-DD;endDate 必须早于当前日期。
- 调用接口:POST /tool-jungle-scout/sales-estimates/query。
- 脚本调用:python scripts/amazon_sales_estimates.py '<JSON params>' [--inline]。
- 鉴权:设置 NEXSCOPE_API_KEY 环境变量;若出现 401/402 或余额不足,可访问 https://www.nexscope.ai/help/skills-external-access?co-from=skillNS 获取 API Key 或充值。
- 输出策略:默认将完整响应写入 <cwd>/nexscope/<YYYY-MM-DD>/<session>/data/nexscope-junglescout-sales-estimates-<timestamp>.json;响应不超过 8 KB 时向标准输出打印完整 JSON,超过 8 KB 时仅打印摘要;加 --inline 可强制完整输出,但仍会落盘。
- 结果读取:建议先看摘要,需要具体字段时再用 jq 或 ConvertFrom-Json 从已保存的 JSON 中按需提取。
【计费与缓存】 该工具消耗额度。同一会话中相同参数组合默认只调用一次,脚本内有 24 小时本地缓存。失败或空结果不应自动更换关键词、翻页或邮编重试;后续会产生额外费用的查询应先告知用户。
【常见查询场景】
- 监控竞品近 30 天销量;
- 对比 Q3 与 Q4 表现(分别两次调用);
- 查看全年销量以验证选品机会;
- 跟踪新品上架后表现;
- 观察 Prime Day 等大促期间销量。
【结果呈现】 建议以折线图展示每日销量变化(X 轴日期、Y 轴预估销量),价格数据可用第二 Y 轴叠加;同时附数据表(日期、预估销量、最新已知价格),并汇总总销量、日均销量、按均价估算的总销售额,简要说明趋势方向与峰谷日期。
【限制】
- 单次仅查询一个 ASIN,比较多个 ASIN 需多次调用。
- endDate 不能包含今天或未来日期,数据存在滞后,不含当日实时销量。
- 价格以美元计价。
- 不适用于关键词搜索量、BSR 排名历史、类目整体销量/市场规模、非亚马逊平台数据或实时销量等需求。