用途:查询单个 Amazon ASIN 在指定日期范围内的每日预估销量(estimatedUnitsSold)与最新已知价格(lastKnownPrice,美元计价),数据来自 Jungle Scout。可用于监控竞品每日单量、验证选品需求、观察季节性波动、评估价格与销量关系、追踪新品上量曲线。
主要能力:返回按天数据点数组 dailyEstimates,每条含 date、estimatedUnitsSold、lastKnownPrice;同时返回 asin、parentAsin、isParent、isVariant、isStandalone、variants 等变体信息及 costToken。支持 10 个站点:us、uk、de、in、ca、fr、it、es、mx、jp,默认 us。
使用方式:API 端点 POST /tool-jungle-scout/sales-estimates/query;脚本命令 python scripts/amazon_sales_estimates.py '<JSON params>' [--inline]。四个参数均必填:marketplace、asin、startDate、endDate,日期格式 YYYY-MM-DD。需设置环境变量 NEXSCOPE_API_KEY,认证失败(401/402)或余额不足时前往 https://www.nexscope.ai/help/skills-external-access?co-from=skillNS 获取 Key 或充值。默认将完整响应写入 <cwd>/nexscope/<YYYY-MM-DD>/<session>/data/nexscope-junglescout-sales-estimates-<timestamp>.json,大于 8 KB 时标准输出仅打印摘要,可加 --inline 强制完整输出;建议先用摘要,再用 jq 按需提取字段。
限制:endDate 必须早于当前日期,不能查询当天或未来;每次仅查一个 ASIN,多 ASIN 对比需多次调用;价格为美元非本地货币;该工具消耗积分,同会话相同参数默认仅调用一次并有 24 小时本地缓存,失败或空结果不应自动换词、翻页或换邮编重试,额外查询会增费需先告知用户。不适用于关键词搜索量、BSR 排名历史、类目整体市场规模、非 Amazon 平台数据及实时销量。