amazon-competitor-listing-gaplisted
Install: claude install-skill funewa/AMZ-VOC
# Amazon 竞品 Listing 差距
## 本 Skill 的固定运营入口
- 本入口只执行 `page_compare/listing_gap`,输出模板固定为 `ops_page_compare`。
- 先读 `skill-defaults.json` 与 `references/operation-workflow.md`,再调用 CLI。
- 接受自然语言需求,自动提取 ASIN 和站点;workflow/focus 从固定配置读取,不要求用户填写。
- 本专属入口只处理本场景:不切换到其他工作流,也不接收任意 prompt。
- 必须先报价;只有用户明确确认才可运行并扣点。评论不足只建议独立采集。
- 不虚构广告、库存、订单、利润或实时店铺数据。
## 自然语言入口与输出
- 用户只需表达目标,例如“对照主 ASIN 与竞品商品页,整理 Listing 表达差距和改进项。商品 B0XXXXXXXX(美国站)。”
- 从对话中提取 ASIN、站点、范围与输出长度;无站点信息时默认美国站并说明。
- 简短问题优先输出:数据范围、主要发现与评论依据、结论;证据不足时说明缺口,不把缺失数据补成结论。
- 用户未要求技术细节时,不展示内部任务标识、参数清单或命令日志。
## 固定 CLI 入口
```bash
python scripts/ari.py operations capabilities
python scripts/ari.py operations profile --asin <ASIN> --site amz_us
python scripts/ari.py operations quote --asin <ASIN> --site amz_us
# 用户明确确认后,复用报价返回的 requestId:
python scripts/ari.py operations run --asin <ASIN> --site amz_us --request-id <requestId> --confirm
python scripts/ari.py operations status --request-id <原requestId>
```
评论不足时先单独使用 `collect`;本 Skill 不会隐式采集。流中断后只运行
`operations status --request-id <原值>`,不要直接重跑。
## 计费与数据边界
- 采集按页扣点、分析按次扣点;先报价,用户明确确认后才执行。
- `capabilities` 与 `profile` 是确定性读取,不扣分析积点。
- 结论只基于已采集样本,不承诺实时价格、销量、库存或广告数据。
## 基础命令
除本场景入口外,包内 CLI 只提供授权、自检与版本,以及评论不足时的单独采集:
```bash
python scripts/ari.py setup # 首次使用:浏览器授权并保存 Key
python scripts/ari.py configure # 隐藏输入并手动保存 ARI API Key
python scripts/ari.py check # 验证 Key、账户和积点余额
python scripts/ari.py version # 显示版本与分发渠道(无需 Key)
python scripts/ari.py collect --asin <ASIN> --site