| 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)
- Get your free API key at apps.voc.ai/openapi
- Create a key at API Keys page
- Set it:
export VOC_API_KEY="your-api-key"
New accounts include starter credits — enough for multiple analyses.
Usage
bash ~/.agents/skills/voc-amazon-reviews/voc.sh B08N5WRWNW
bash ~/.agents/skills/voc-amazon-reviews/voc.sh B08N5WRWNW --limit 100
bash ~/.agents/skills/voc-amazon-reviews/voc.sh B08N5WRWNW --market JP
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
