Amazon Review Reveyes

---

name: amazon-review-reveyes version: "1.0.0" author: reveyes description: > 使用 Reveyes API 批量抓取亚马逊商品评论，支持 20 个站点。 输出评论列表、星级分布统计和差评摘要。 Use when: 用户提到抓评论、查差评、分析竞品口碑、给出 ASIN 编号需要评论数据。 NOT for: 分析已经抓好的本地评论文件，或查询亚马逊商品价格/销量。 tags: - amazon - ecommerce - review - scraping - cross-border requires: env: - REVEYES_API_KEY

---

When to Run

用户发送 ASIN 编号并要求抓取评论（如「帮我抓 B08N5WRWNW 的评论」）

用户说「帮我看看这个竞品的差评」「分析一下这款产品的用户反馈」

用户要对比同一商品在多个亚马逊站点的口碑

用户要导出评论数据做分析

Parameters

从用户消息中提取以下信息：

| 参数 | 说明 | 默认值 | |------|------|--------| | asin | 亚马逊 ASIN，10 位字母数字（必须） | — | | marketplace | 站点代码，见下方列表 | US | | pages | 抓取页数（1-10），1 页约 10 条评论 | 2 | | filter_star | 星级筛选：all_stars positive critical five_star…one_star | all_stars |

支持的站点代码： US CA MX UK DE FR IT ES NL SE PL BE IE JP IN SG AE SA AU BR

Workflow

1. 提取参数：从用户消息中识别 ASIN（10 位）、站点代码、页数、星级筛选 - 若用户只给 ASIN，其余使用默认值 - 若用户说「差评」自动设置 filter_star=critical - 若用户说「好评」自动设置 filter_star=positive

2. 执行抓取：调用 scripts/fetch.py，传入参数

   python scripts/fetch.py    
   

3. 等待完成：脚本内部自动轮询（最多 5 分钟），完成后输出 JSON 结果

4. 格式化输出： - 汇总：总评论数、平均评分、各星级占比 - Top 5 差评（如请求的是 critical 或 all_stars）：标题 + 正文前 150 字 - 如评论数 > 20，额外输出高频关键词（从差评标题提取）

5. 错误处理： - AuthenticationError → 提示用户检查 REVEYES_API_KEY - InsufficientCreditsError → 提示前往 https://www.reveyes.cn 充值 - BadParamsError → 提示检查 ASIN 或站点代码是否正确 - TimeoutError → 告知任务仍在运行，提供 task_id 供后续查询

Output Format

📦 ASIN: B08N5WRWNW  |  站点: US  |  共 87 条评论
⭐ 评分分布：
  ★★★★★  42 条 (48%)  ████████████
  ★★★★☆  18 条 (21%)  █████
  ★★★☆☆   8 条  (9%)  ██
  ★★☆☆☆   5 条  (6%)  █
  ★☆☆☆☆  14 条 (16%)  ████
📝 典型差评（最近 5 条）：
1. ★★ "Stopped working after 2 weeks"
   Bought this expecting quality but it broke down...
2. ★★ "Not as described"
   The color is completely different from the photos...
[查看完整结果或导出 CSV，请告诉我]