review-analyzer

name	review-analyzer
description	Review Analyzer — agent-callable e-commerce review intelligence. Input an ASIN or drag in a CSV; get sentiment + pain points + selling points + listing optimization + a black-gold HTML dashboard. Backed by Shulex VOC OpenAPI (10 markets) for Amazon ASINs, accepts any review CSV/Excel for other platforms. 6 MCP tools, agent-native. Triggers: review analysis, voc, amazon review, asin analysis, listing optimization, pain points, selling points, review insights, amazon fba, helium10 alternative, product research, review dashboard, csv review
allowed-tools	Bash
metadata	{"openclaw":{"homepage":"https://github.com/mguozhen/voc-amazon-reviews"}}

Review Analyzer — Agent-Native Voice-of-Customer

Input an ASIN or drag in a CSV, get a structured bilingual VOC report + a black-gold HTML dashboard. 6 agent-callable MCP tools. Data layer backed by Shulex VOC OpenAPI for Amazon (10 markets); CSV mode works for any platform.

Quick Setup (30 seconds)

1. Get your free API key at apps.voc.ai/openapi
2. Create a key at API Keys page
3. Set it:

export VOC_API_KEY="your-api-key"

New accounts include starter credits — enough for multiple analyses.

Usage

# Quick analysis — 8 reviews (5 credits)
bash ~/.agents/skills/voc-amazon-reviews/voc.sh B08N5WRWNW

# Deep analysis — 100 reviews (50 credits)
bash ~/.agents/skills/voc-amazon-reviews/voc.sh B08N5WRWNW --limit 100

# Japan marketplace
bash ~/.agents/skills/voc-amazon-reviews/voc.sh B08N5WRWNW --market JP

# Save report to file
bash ~/.agents/skills/voc-amazon-reviews/voc.sh B08N5WRWNW --limit 100 --output report.md

Supported Marketplaces

Code	Marketplace
US	amazon.com
CA	amazon.ca
MX	amazon.com.mx
GB	amazon.co.uk
DE	amazon.de
FR	amazon.fr
IT	amazon.it
ES	amazon.es
JP	amazon.co.jp
AU	amazon.com.au

Sample Output

╔══════════════════════════════════════════════════════════╗
║     VOC AI Analysis Report                               ║
║  ASIN: B08N5WRWNW  |  Reviews Analyzed: 100              ║
║  Market: US  |  Generated: 2026-04-18                     ║
╚══════════════════════════════════════════════════════════╝

📊 Sentiment Distribution
  Positive  ████████████████░░░░  74%
  Neutral   ███░░░░░░░░░░░░░░░░░  16%
  Negative  ██░░░░░░░░░░░░░░░░░░  10%

🔴 Top 5 Pain Points
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
1. Short battery life (28 mentions)
   "Battery drained in 2 days, very disappointed"

🟢 Top 5 Selling Points
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
1. Excellent sound quality (52 mentions)
   "Amazing bass and crystal clear highs for the price"

💡 Listing Optimization Suggestions
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
1. Add battery capacity and playtime hours to title

How It Works

① Input ASIN
      ↓
② Shulex VOC API fetches real-time Amazon reviews
      ↓
③ Structured review data (rating, body, date, verified, variant)
      ↓
④ AI deep semantic analysis (sentiment, pain points, selling points)
      ↓
⑤ Bilingual report (Chinese + English)

Cost Guide

Reviews	API Credits	Use Case
8 (default)	5 credits	Quick competitor check
50	25 credits	Product validation
100	50 credits	Deep analysis
200	100 credits	Comprehensive audit

Scripts

File	Description
voc.sh	Main entry point — orchestrates fetch + analyze
fetch.sh	Shulex VOC API client (submit task → poll → get reviews)
analyze.sh	AI analysis engine (sentiment, pain points, selling points)
scraper.sh	Legacy browser-based scraper (deprecated)

Environment Variables

Variable	Required	Description
VOC_API_KEY	Yes	Shulex VOC API key (get one free)

Resources

• Shulex VOC API Docs
• API Keys
• Buy Credits