SuperAPI AI 工具集

ecommerce.price-history-analyzer

营销与增长

查看项目

更新于 10-16 01:36

技能介绍

用途:在进入某市场前评估定价稳定性、价格战风险与 Buy Box 竞争,分析历史价格趋势。适用于历史价格趋势、波动、价格战与 Buy Box 稳定性分析;近期价格提醒用 price-monitor,更广的竞品指标用 competitor-analyzer。

主要能力:通过 Keepa 的 /api/v1/tools/research/keepa/productSeries 获取 Buy Box 历史、BSR、评分、月销量,经 NexScope 代理 /api/v1/tools/research/amazon/search 获取当前商品列表。核心指标包括价格战评分(0-100,<25 LOW、25-50 MODERATE、50-75 HIGH、>75 SEVERE)、PVI 价格波动指数(标准差/均值×100,<5% LOW、5-10% MEDIUM、10-20% HIGH、>20% EXTREME)、Buy Box 稳定性(每日变化次数)与价格趋势(RISING/STABLE/DECLINING/CRASHED)。价格战评分由波动率35%、趋势25%、降价频率25%、Buy Box 不稳定15%加权。

使用方式:所有脚本必须在包含 SKILL.md 的技能根目录绝对路径下执行,先 cd 进入该目录,不要用相对路径或 ~。示例:python3 scripts/price_history_analyzer.py '{"keyword": "face wash"}';指定 ASIN:'{"asin": "B07RL88DD2"}';指定市场:'{"keyword": "yoga mat", "market": "UK"}';加图表:--chart /tmp/output。参数含 keyword、asin、market(US/UK/DE/FR/CA/JP)。需设置环境变量 NEXSCOPE_PROXY_BASE 与 NEXSCOPE_API_KEY。默认生成价格历史、价格战评分、波动与 Buy Box 三张 PNG 图表,样式由 ecommerce_chart_helpers.py 读取 chart_style.json 控制,不要硬编码颜色。

限制:Keepa 数据可用性因 ASIN 而异,历史数据通常约 90 天,API 调用消耗 Keepa token,分类清洗可能减少样本量;缺少 ASIN 时需先解析,不能仅用关键词做历史价格分析。