name: review-batch-collection description: 对多个ASIN批量采集Amazon评论，支持翻页和星级过滤，输出结构化评论语料库 version: 1.3.0

author: nkkj-BrainHack

评论批量采集 (Review Batch Collection)

技能名称

review-batch-collection

技能目的

对多个ASIN批量采集Amazon评论数据，支持翻页、星级过滤、去重清洗，并生成竞品VOC对比汇总（本店vs竞品均分/差评率/top产品）。

输入参数

参数	类型	必填	说明
asins	string[]	是	需要采集评论的ASIN列表（自身+竞品）
maxPagesPerAsin	integer	否	每个ASIN最大翻页数，默认5
starFilter	integer[]	否	星级过滤，如 [1,2] 只采集差评，不传则采集全部
onlyVerifiedPurchase	boolean	否	是否只采集已验证购买，默认false
domain	integer	否	Amazon站点，默认1

执行流程

对每个 ASIN 循环调用 product-reviews-query
每次请求一页（约10条评论），按 PageIndex 翻页
若指定 starFilter，使用 Star 参数按星级分别请求
对采集到的评论进行去重（按 ReviewsLink）
清洗无效评论（内容长度 < 10字符的短评论）
标准化字段名：Star, Title, Content, ConsumerName, ReviewsDate, IsVP, Helpful
统计采集概况：各ASIN评论数、星级分布、采集成功率
竞品VOC对比汇总（新增）：
- 本店 vs 竞品加权均分对比
- 各店铺差评率(1-2星占比)对比
- top5产品排名(按加权评分)
- 兼容多种数据源格式(Sorftime PascalCase / 标准 camelCase)

调用的底层 Skill

voc/product-reviews-query — 单ASIN单页评论请求

返回格式

{
  "reviews": [
    {
      "asin": "B0B24QJ217",
      "star": 5,
      "title": "Love this diffuser!",
      "content": "The scent is amazing and lasts for weeks...",
      "consumerName": "Jane D.",
      "reviewDate": "20260204",
      "isVerifiedPurchase": true,
      "helpful": 12,
      "reviewLink": "https://..."
    }
  ],
  "stats": {
    "totalReviews": 450,
    "byAsin": {
      "B0B24QJ217": { "total": 120, "stars": { "5": 65, "4": 30, "3": 12, "2": 8, "1": 5 } }
    },
    "overallStarDistribution": { "5": 45, "4": 25, "3": 15, "2": 10, "1": 5 },
    "avgRating": 4.2,
    "verifiedPurchaseRate": 78.5
  },
  "competitorVocComparison": {
    "ownBrandAvgRating": 4.3,
    "competitorAvgRating": 4.1,
    "ownNegativeRate": 12.5,
    "competitorNegativeRate": 18.3,
    "topProducts": [
      { "asin": "B0B24QJ217", "weightedScore": 4.35, "reviewCount": 120, "rank": 1 }
    ]
  }
}

核心业务场景

工作坊 Day1 晚「试捕电商 VOC」核心数据采集（自身 + 竞品 ASIN 批量评论）
差评率对比（本店 vs 竞品 1-2 星占比）
竞品 VOC 对比汇总（加权均分/差评率/Top 产品排名）

依赖

Amazon VOC API: https://server.fmode.cn/api/voc-ecom/forward（统一转发，认证已内置）
⚠️ 字段名为 PascalCase：ReviewsDate（非 ReviewDate）、ReviewedCountry、IsVP、ReviewsLink

对应工作坊环节

Day1 晚 19:00-21:30「试捕电商VOC」— 核心数据采集步骤

SKILL.md 3.2 KB Постоянная ссылка История Исходник