VOC AI — Amazon Review Intelligence

Input an ASIN, fetch real Amazon reviews via Shulex VOC API, and get a structured bilingual insight report powered by AI.

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

# 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) |

Voc Publish NPIIr8