技能介绍

要解决什么问题

在亚马逊上选品、改 Listing 或做广告投放时，你往往只有销量和广告报表，很难从评论里系统看出买家是谁、在抱怨什么、和竞品差在哪。手工翻评论既慢，又容易把个别差评当成整体趋势。本技能通过 Skill 目录内的 scripts/ari.py 对接 ARI 服务，把已采集评论样本上的 VOC、图表和竞品对比做成可归档报告，并把「数据直读」「推理」「策略建议」分开写，避免把猜测当成事实。

技能如何工作

标准路径是：每次会话先跑 python scripts/ari.py check，核对账户、邮箱验证和可用积点；需要 VOC / 评论分析报告时，默认用 voc --site <站点> --asin <ASIN> 先拿总报价（采集 + VOC），用户明确确认后再加 --confirm，命令会串联采集、等待、分析、归档，并返回正文与 reportUrl。单独采集、免费图表或其它分析类型才走 collect / charts / deepdive / analyze；竞品对比要求双方在库内各 ≥10 条评论，同样先 analyze --type compare 报价再 --confirm。已生成内容用 reports / report --id 读取；字段与错误码以 references/reference.md 为准。

适用边界与注意点

计费与安全：缺 Key 即停；401 引导重建 Key，402 保留已有结果并引导充值；付费命令中断后不要直接重试 --confirm，先用 reports --asin ... --limit 1 确认是否已扣点归档。非美国站采集只能用付费积点，以报价里的 sufficient / usableBalance 判断。
数据范围：reviewCount 等统计基于 ARI 当前样本与查询时间，小样本或 --days 窗口有限时结论需交叉验证；图表/深度分析传非零 --days 时，解读必须说明统计窗口。
版本：出现 426 / ARI_SKILL_TOO_OLD 时停止付费操作并提示用户通过原安装渠道升级；不要自行下载或执行响应里的「新版」文件。