SuperAPI AI 工具集

product-validator

数据与分析

查看项目

更新于 10-16 06:51

技能介绍

用途:在采购前验证某个已知商品或 ASIN 的数据是否可靠、能否盈利。核心问题为“这些数据可信吗”“我能赚钱吗”。

主要能力:执行 10 步验证流程,包括数据提取、BSR 历史、价格历史、Buy Box 分析、卖家历史、评论真实性评分、库存状态、季节性、综合评分与风险评估。输出 0-100 验证评分:≥80 为 VALID,60-79 为 CAUTION,<60 为 AVOID。可计算 FBA 利润、利润率、ROI、盈亏平衡价与广告缓冲。可生成 BSR 趋势、价格趋势、评分分解、利润瀑布图等图表。风险标记包括 BSR 波动、价格战、评论异常增长、频繁缺货、季节性波动。

使用方式:所有脚本必须在包含 SKILL.md 的技能根目录下执行,先 cd 进入该目录,不要用相对路径或 ~。示例:python3 scripts/product_validator.py '{"asin": "B07RL88DD2"}';带成本计算:python3 scripts/product_validator.py '{"asin": "B07RL88DD2", "cost_price": 19.99}';批量:python3 scripts/product_validator.py '{"asins": ["B0XXX", "B0YYY"]}';图表输出:python3 scripts/product_validator.py '{"asin": "B07RL88DD2"}' --chart /tmp/output。参数含 asin、asins、market、cost、price、category。需设置环境变量 NEXSCOPE_PROXY_BASE 与 NEXSCOPE_API_KEY。

适用场景:采购前验证商品、检查 BSR/销量估计是否现实、计算盈利与 ROI、识别虚假评论或被操纵数据。发现新品用 product-opportunity-finder,比较竞品用 competitor-analyzer,深度价格历史用 price-history-analyzer。

限制:BSR 历史依赖 Keepa 数据;FBA 费用为估算;评论真实性为启发式判断;季节性检测需 12 个月以上数据;基础利润未计入广告成本。图表样式由 ecommerce_chart_helpers.py 读取 chart_style.json 驱动,不应在脚本中硬编码颜色。