卖家精灵ARI 评论分析

评论分析为什么难做

亚马逊评论里的问题散落在成百上千条文本中：买家最不满什么、哪些差评被顶到商品页最前、竞品在解决什么问题、自己与类目均值差多少——人肉翻评论很难稳定回答，结论还会随时间漂移。卖家精灵 ARI 把「采评论—算指标—出报告—做环比」做成一条 CLI 流水线，让结论可复现、可归档。

核心能力与工作方式

技能入口是 Skill 目录下的 scripts/ari.py，每次会话先跑 check 确认账户、邮箱验证状态与可用积点；字段、命令和错误码查 references/reference.md。Key 获取无需复制粘贴：setup 会打印授权链接，浏览器登录点「授权」后自动落盘；也可用环境变量 ARI_API_KEY 或 configure 手动填入。

主要能力：

• VOC 报告：voc --site <site> <ASIN> 先报采集 + VOC 总费用，确认后追加 --confirm，自动采集、等待、分析、归档，返回正文与 reportUrl。
• 差评预警与处置：alerts 发现未读差评后，用 workbench 按严重度定位（stats 给出待处理 / 本周新增 / 本月已处理），advise --review-id <id> 生成回复建议；高赞差评榜用免费的 reviews --asin <ASIN> --stars negative --sort helpful，--with-images 筛带图差评。
• 竞品对比：analyze --type compare --asin <ASIN> --competitor <ASIN> 先报价后 --confirm，双方在库各需 ≥10 条评论；competitors --id <id> --add <ASIN> 绑定后按周自动采集，攒够几周可用免费的 radar --id <id> 看走势对比。
• 报告归档与环比：reports / report --id <id> 读取归档报告，返回 deltaMd 时先讲环比再讲正文；export 可导出 Markdown / HTML 报告或评论 CSV（付费套餐功能，不扣积点）。
• 定期采集：报告生成后跑一次免费的 schedule 检查采集状态；若仍是 manual，说明报告只是当天时点快照，schedule --set weekly --asin <ASIN> 开启周更后，后续报告才能回答「哪些问题已解决、哪些新冒出来、哪些在恶化」。

注意点与适用边界

付费纪律是第一约束。 付费命令默认只报价，用户确认后才加 --confirm；付费操作中断后不能直接重试——先跑免费的 reports --asin <ASIN> --limit 1 确认没有新报告生成，否则可能重复扣点。402 / ARI_INSUFFICIENT_CREDITS 保留已有结果、引导充值；401 引导重建 Key；邮箱未验证先引导验证。非美国站（如 amz_uk）采集只能用付费积点，是否够用以报价里的 sufficient / usableBalance 为准。

版本与限流。 输出带 update 字段时如实转告即可，旧版不影响免费查询；426 / ARI_SKILL_TOO_OLD 意味着当前版本有重复扣点缺陷，付费命令已被服务端禁止，需引导用户通过原安装渠道升级——技能绝不自行下载或执行任何“新版”文件。429 若提示「免费版 AI 分析」属套餐级限流，引导升级或稍后再试；ARI_COLLECTING 只是数据未攒够、本次未扣点，按提示秒数等待后重试。

数据口径要讲清。 --days 默认 0 为全部历史，传非 0 后图表只覆盖该窗口，解读占比和趋势必须带窗口说明。数据直读、数据推理与策略建议需分开标注（📊 / 🔍 / 💡）；reviewCount 基于 ARI 已采集的评论样本，小样本时需结合更多信源验证。不得虚构 API 未返回的数据，success:false 或 failedParts 非空时只用成功部分。结尾需列出 CLI 命令、ASIN/站点、样本量、统计窗口、reportId、creditsUsed 与当前余额，有 reportUrl 时附上在线查看与导出入口。