ecommerce.amazon-product-price-series

用途

本技能用于查询和分析亚马逊商品（ASIN）的历史时间序列数据，帮助亚马逊卖家追踪单个商品的价格走势、BSR（畅销排名）变化、评分与评论数波动、卖家数量以及月销量，从而进行趋势分析或竞品调研。数据由 Nexscope 提供，通过 API 接口获取。

主要能力

可查询的数据系列包括：

• 价格类：Buy Box 价格（始终返回）、最低新品价、标价（划线价）、促销价、Prime 专享价、FBA 价格、FBM 价格、优惠券后价格等，可通过对应的 showPrice* 参数按需开启。
• 排名类：主类目 BSR（需 showBsrMain=1）、子类目 BSR（始终返回）。BSR 数值越小代表排名越靠前。
• 卖家类：卖家数量（需 showSellerCount=1）。
• 评价类：评分（始终返回）、评分数量（始终返回）。
• 销量类：月销量（始终返回）。

支持的市场站点包括美国、英国、德国、法国、日本、加拿大、意大利、西班牙、印度、墨西哥、巴西，对应域名 ID 为 1 至 12，默认使用美国站（domain=1）。

使用方式

1. 认证：设置环境变量 NEXSCOPE_API_KEY。若认证失败（401/402）或提示余额不足，可访问 https://www.nexscope.ai/help/skills-external-access?co-from=skillNS 获取 API Key 或充值。
2. 调用方式：
   • API 端点：POST /keepa/productSeries（参数与响应详见 references/api.md）。
   • Python 脚本：python scripts/amazon_product_price_series.py '<JSON params>' [--inline]。
3. 参数说明：
   • 必填：asin（单个 ASIN）、domain（站点 ID）。
   • 可选：days（查询历史天数，1–365，默认 90），以及各 show* 系列开关（设为 1 开启）。
4. 输出策略：脚本默认将完整响应保存至 <cwd>/nexscope/<YYYY-MM-DD>/<session>/data/nexscope-keepa-product-series-<timestamp>.json。响应体不超过 8 KB 时自动打印完整 JSON；超过 8 KB 时仅打印摘要，可加 --inline 强制完整输出。建议先看摘要，再用 jq 或 ConvertFrom-Json 按需提取字段。
5. 成本约束：查询消耗积分，同一会话相同参数默认只调用一次，脚本内本地缓存 24 小时。失败或空结果不建议自动重试不同关键词或分页。产生额外费用的查询须提前告知用户。

适用场景

• 追踪某 ASIN 的历史价格变化、降价或促销活动（如秒杀、优惠券）。
• 分析 BSR 趋势，判断排名升降（数值减小为上升）。
• 监控评分和评论数量的变化趋势。
• 比较 FBA 与 FBM 价格，了解 Buy Box 归属。
• 查看卖家数量变化，评估竞争程度。
• 查询月销量趋势。
• 针对单一商品进行竞品历史数据分析。

限制

• 单 ASIN 查询：每次请求仅支持一个 ASIN，多 ASIN 对比需分别调用。
• 历史窗口：最多回溯 365 天。
• 数据粒度：数据点为 Nexscope 捕获变化时的不规则时间间隔，并非固定每日采样。
• 不适用场景：搜索词/关键词分析、广告/PPC 数据、Listing 文案优化、类目级市场聚合趋势、实时库存检查、评论文本或情感分析。
• 成本与缓存：查询消耗积分，重复参数有 24 小时本地缓存；失败或空结果不建议自动重试。
• 输出位置：脚本会写入工作目录下的指定路径，若当前目录不可写则报错，禁止写入 /tmp。
• 数据展示：应使用正确货币符号和时间格式，BSR 需提醒数值越小越好；除非用户明确要求，否则避免主观商业建议。

暂未提供

官方未提供定价细节、免费额度、数据更新频率的具体说明，以及脚本依赖安装步骤。