openclaw-voc-skill/docs/voc-skills-course-plan/examples/amazon-review-voc

示例：Amazon Review VOC

实际调用对象

• Skill：voc/product-reviews-query
• 用途：按 ASIN 获取 Amazon 评论，用于差评痛点、好评喜爱点、验证购买反馈和使用场景分析。

可复制输入

1. 获取全部评论第一页

{
  "ASIN": "B0B24QJ217",
  "domain": 1,
  "PageIndex": 1
}

2. 获取 1 星差评

{
  "ASIN": "B0B24QJ217",
  "Star": "1",
  "PageIndex": 1,
  "OnlyPurchase": 1,
  "domain": 1
}

3. 获取近期验证购买评论

{
  "ASIN": "B0B24QJ217",
  "OnlyPurchase": 1,
  "QueryStartDt": "20250101",
  "PageIndex": 1,
  "domain": 1
}

预期输出

{
  "TotalCount": 1200,
  "Reviews": [
    {
      "Star": 1,
      "Title": "review title",
      "Content": "review content",
      "ConsumerName": "customer",
      "ReviewsDate": "20260204",
      "ReviewedCountry": "United States",
      "IsVP": true,
      "Helpful": 12,
      "Asin": "B0B24QJ217",
      "ReviewsLink": "https://..."
    }
  ]
}

常见错误

• ASIN 格式错误：必须是 10 位大写字母数字。
• Star 类型错误：星级要传字符串，例如 "1"，不是数字 1。
• 分页遗漏：每页约 10 条评论，课堂演示至少讲清楚 PageIndex 翻页。
• 字段名写错：使用 ReviewsDate、ReviewedCountry、IsVP、ReviewsLink，不要改成别的大小写。
• Token 问题：该 skill 需要 vocToken，课前应完成 token 预飞。

课堂讲解点

• 差评深潜：先用 1 星和 2 星评论找真实痛点，不要只看平均星级。
• 验证购买优先：OnlyPurchase=1 的评论更适合作为产品体验证据。
• 好评不是广告词：5 星评论应提炼用户主动复述的喜爱点和场景。
• 证据卡写法：每条结论要带 ASIN、Star、ReviewsDate、ReviewsLink 或评论唯一字段。