技能介绍

要解决的问题

亚马逊新品上架前，判断一个品值不值得做，往往靠感觉。评论数量、评分分布、竞品的销量信号分散在不同页面，人工翻一遍耗时且容易漏掉关键信号。更麻烦的是，测算依据说不清——「我觉得需求不错」这类结论经不起复盘。本技能把需求测算收敛成一次可复现的 VOC（Voice of Customer）分析：输入 ASIN 和站点，输出评论样本的直读数据、推理判断和策略建议，三者明确区分。

核心能力与工作方式

多站点评论采集：支持 amz_us、amz_uk、amz_de、amz_jp 等 8 个站点，voc 命令一次报出采集 + VOC 分析的总费用。
先报价后执行：付费操作默认不执行，用户确认后才追加 --confirm；若用户已在当前请求中明确授权，可直接执行。
标准工作流：

1. python scripts/ari.py check 确认账户、邮箱验证状态和积点余额。
2. voc --site <site> <asin> 获取总报价。
3. 用户确认后执行 voc --site <site> <asin> --confirm，自动完成采集、等待、分析和归档。
4. 用 reports --asin 或 report --id 读取已归档报告。

竞品对比：双方 ASIN 在库内各需 ≥10 条评论，先 analyze --type compare 报价再确认。
付费保护：中断后不直接重试——先跑免费的 reports --asin 确认服务端是否已扣点归档；ARI_INSUFFICIENT_CREDITS 时保留已有结果引导充值，不自动重试。

适用边界与注意点

reviewCount 基于 ARI 已采集的评论样本，小样本或采集窗口有限时应结合更多信源验证。
图表的 --days 传非 0 时只覆盖该窗口，解读占比和趋势必须带上窗口说明。
返回 success:false 时只能使用成功部分，不得虚构 API 未返回的数据。
版本过旧可能被服务端拒绝付费操作（426），免费查询不受影响，升级须由用户通过原安装渠道完成。
报告正文结尾需列出所用命令、ASIN/站点、样本量、统计窗口、reportId、creditsUsed 与余额；含 reportUrl 时附上在线查看入口。