# Review Analyzer

> 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

- Skill: `mguozhen/review-analyzer` (Agent Skill, multi-file: 14 files)
- Install (CLI): `npx skillmds@latest add mguozhen/review-analyzer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/mguozhen/review-analyzer/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: mguozhen (https://skillmd.com/u/mguozhen)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/mguozhen/review-analyzer

---


# 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](https://apps.voc.ai/openapi?utm_source=github&utm_medium=readme&utm_campaign=launch_apr)
2. **Create a key** at [API Keys page](https://apps.voc.ai/openapi/api/keys?utm_source=github&utm_medium=readme&utm_campaign=launch_apr)
3. **Set it**:

```bash
export VOC_API_KEY="your-api-key"
```

New accounts include starter credits — enough for multiple analyses.

## Usage

```bash
# 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](https://apps.voc.ai/openapi/api/keys?utm_source=github&utm_medium=readme&utm_campaign=launch_apr)) |

## Resources

- [Shulex VOC API Docs](https://apps.voc.ai/openapi?utm_source=github&utm_medium=readme&utm_campaign=launch_apr)
- [API Keys](https://apps.voc.ai/openapi/api/keys?utm_source=github&utm_medium=readme&utm_campaign=launch_apr)
- [Buy Credits](https://apps.voc.ai/openapi/api/billing?utm_source=github&utm_medium=readme&utm_campaign=launch_apr)