【用途】 该技能用于抓取并分析指定 Amazon ASIN 的真实买家评论,帮助卖家从顾客反馈中提炼可执行的洞察,覆盖包括美国站在内的 15 个市场站点。
【主要能力】
- 按 ASIN 获取评论,一次仅支持一个 ASIN,多个 ASIN 需分别调用。
- 按星级控制抓取量:star1Num 至 star5Num 分别设置 1 至 5 星评论数,每档 0-100,默认各 10 条;若指定了任一星级数量,未指定的星级默认为 0。
- 排序方式:sortBy 可选 recent(最新)或 helpful(最有帮助)。
- 过滤条件:filterByKeyword 按关键词过滤(最长 1000 字符);reviewerType 可选 all_reviews 或 avp_only_reviews(仅已验证购买);mediaType 可选 all_contents 或 media_reviews_only;formatType 可选 all_formats 或 current_format。
- 站点选择:通过 domainCode 指定,支持 com(美国)、ca、co.uk、de、fr、it、es、co.jp、in、com.au、com.br、com.mx、nl、se、ae。
【使用方式】
- API 端点:POST /amazon/reviews/list,完整参数、响应与错误码见 references/api.md。
- Python 脚本:python scripts/amazon_reviews.py '<JSON params>' [--inline]。
- 认证:需设置 NEXSCOPE_API_KEY 环境变量;若出现 401/402 或余额不足,可前往 https://www.nexscope.ai/help/skills-external-access?co-from=skillNS 获取 API Key 或充值。
- 输出策略:脚本默认将完整响应写入 <cwd>/nexscope/<YYYY-MM-DD>/<session>/data/nexscope-amazon-reviews-list-<timestamp>.json;响应不超过 8 KB 时在保存后完整打印 JSON,超过 8 KB 时仅打印摘要(顶层字段、total/costToken 等常见计数、最大列表字段长度及前 3 个样本);加 --inline 可强制完整输出。当前目录不可写时报错,不写入 /tmp。建议先看摘要,需要具体字段时再用 jq 或 ConvertFrom-Json 从保存文件按需提取。
- 成本约束:工具消耗积分;同一会话中相同参数组合默认只调用一次,脚本含 24 小时本地缓存;失败或空结果不应自动更换关键词、分页或邮编重试;产生额外费用的查询应先告知用户。
【参数示例】
- 美国站评论:{"asin": "B08N5WRWNW", "domainCode": "com", "star1Num": 10, "star2Num": 10, "star3Num": 10, "star4Num": 10, "star5Num": 10, "sortBy": "recent"}
- 德国站差评加关键词:{"asin": "B08N5WRWNW", "domainCode": "de", "star1Num": 30, "star2Num": 30, "filterByKeyword": "quality", "reviewerType": "avp_only_reviews"}
- 日本站带媒体五星评论:{"asin": "B08N5WRWNW", "domainCode": "co.jp", "star5Num": 50, "star1Num": 0, "star2Num": 0, "star3Num": 0, "star4Num": 0, "sortBy": "helpful", "mediaType": "media_reviews_only"}
- 仅三星评论:{"asin": "B0FP5C63HZ", "domainCode": "com", "star3Num": 100}
【展示建议】 按星级分组展示评分、标题、正文、日期、验证状态、有帮助数;评论较多时先给主题或痛点总结;突出差评中的重复抱怨与好评中的称赞点;标明 Vine Voice 与已验证购买状态;注明是否含图片或视频;对市场站特有的文本格式做归一化;失败时依据响应信息说明原因并建议调整参数。
【适用场景】 查看某 ASIN 评论、按站点查询评论、分析差评痛点、抓取全部一星评论、挖掘好评卖点、按关键词找评论、筛选带图评论、仅看已验证购买评论、分析竞品评论、从评论提炼改进建议。若需求涉及 ABA 搜索词数据、关键词研究、销量估算、Listing 文案、A+ 内容、广告策略或定价利润计算,则不适用。
【限制】 一次仅一个 ASIN;每星级每次最多 100 条;评论实时抓取,无历史快照;评论以原始发布语言返回;消耗积分且受缓存与重试约束。