Metadata
- name
- voc-amazon-reviews
- description
- VOC AI — Amazon Review Intelligence. Input an ASIN, fetch real Amazon reviews via Shulex VOC API and run AI analysis. Outputs a structured bilingual report: sentiment breakdown, top pain points, key selling points, and Listing optimization suggestions. Triggers: voc, amazon review analysis, asin analysis, voice of customer, listing optimization, pain points, selling points, review insights, amazon fba, product research
- allowed-tools
- Bash
- metadata
- {"openclaw":{"homepage":"https://github.com/mguozhen/voc-amazon-reviews"}}
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) |
Resources