VOC_API_KEY — Shulex VOC OpenAPI key. Get a free one (100 calls/month, no credit card) at https://apps.voc.ai/openapi
ANTHROPIC_API_KEY — Anthropic API key. Only needed if you use extract_listing_improvements (which uses Claude Opus 4.7 for structured listing rewrites).
Claude Code n'a pas de lien d'installation pour une commande locale. Copiez la commande ci-dessous et exécutez-la dans un terminal.
Get a free Shulex API key (100 calls/month, no credit card): apps.voc.ai/openapi.
Optional: Add "ANTHROPIC_API_KEY": "sk-ant-..." to enable extract_listing_improvements (the only tool that calls Claude directly — others work without it). Must be an actual Anthropic key; other providers won't work.
First run resolves dependencies in ~5s; subsequent runs are instant.
Try it
Ask any MCP-compatible agent:
Run a VOC report on B08N5WRWNW, render the dashboard, and write it to ~/Desktop/voc.html.
The agent will call voc_full → render_dashboard and hand you the file.
Option B — One-shot CLI
bash voc.sh B08N5WRWNW --limit 100 --market US
Option C — Bring your own reviews (CSV)
# Drop in any reviews CSV (Helium 10 export, eBay scrape, Shopify, custom)
python -c "from mcp_server.tools import analyze_csv, render_dashboard; \
r = analyze_csv('reviews.csv', product_name='My Product'); \
render_dashboard(r, output_path='dashboard.html')"
Option D — Hosted on Smithery (no install)
Connect to the server remotely — no uvx, no Python, no local install. Bring
your own Shulex API key (Smithery prompts for it on first connection).
This repo ships a Dockerfile and smithery.yaml for one-click deploy.
To run your own hosted instance:
This repo also ships vercel.json + app.py for one-click Vercel
deploys. Sign in at vercel.com with GitHub, import the
repo, and Vercel auto-detects the Python function.
Set these in Project Settings → Environment Variables before the first
deploy:
Variable
Required
Notes
VOC_API_KEY
yes
Shulex VOC OpenAPI key
ANTHROPIC_API_KEY
optional
Only for extract_listing_improvements
Timeout caveat: Vercel functions cap at 10s (Hobby default), 60s
(Hobby with maxDuration: 60 — already set in vercel.json), or 300s
(Pro). Long-running tools like voc_full (30-90s) and
extract_listing_improvements (20-60s) may exceed these limits. For
unbounded execution, prefer Option D (Docker/Render/Fly) or local install.
The MCP endpoint after deploy: https://your-project.vercel.app/mcp
Tools
#
Tool
Input
Use when
1
fetch_reviews
ASIN
You want raw reviews; you'll analyze them yourself
2
analyze_reviews
reviews JSON
You already have reviews and want the VOC report
3
voc_full
ASIN
Default "give me a VOC report" — fetch + analyze in one call
4
extract_listing_improvements
ASIN
★ Differentiator — copy-ready title / 5 bullets / description grounded in customer language
5
analyze_csv
CSV / Excel path or URL
The product is NOT on Amazon, or you have your own scrape
6
render_dashboard
VOC report
Generate a standalone black-gold HTML dashboard, no external deps
All 6 tools speak MCP. All return JSON-serializable dicts. Full schemas in mcp_server/README.md.
Data layer — why this is the moat
Most "AI review tools" are a thin LLM wrapper over a brittle scraper. We invert that. The data layer is the moat:
For non-Amazon platforms, analyze_csv accepts any review file — fuzzy column matching detects 内容 / 评价 / body / review / content so you don't have to reformat. Bring data from anywhere, get the same VOC report.
Credit & inspiration: The 22-dimension tag system, fuzzy CSV column detection, and black-gold dashboard aesthetic were inspired by buluslan/review-analyzer-skill (MIT). We adapted them onto an MCP-native architecture with the Shulex VOC OpenAPI data layer.
Pas encore de liste d'outils. Les serveurs distants en obtiennent une après le premier contrôle d'état.
FAQ
Questions
Comment installer Voc Amazon Reviews ?
Copiez sur cette page la configuration stdio pour Cursor, Claude Desktop, Claude Code ou VS Code. Elle utilise l'installation de l'éditeur, pas un proxy PlugMCP.
Voc Amazon Reviews nécessite-t-il une clé API ?
L'éditeur indique ces variables d'environnement : VOC_API_KEY, ANTHROPIC_API_KEY.
Quel transport Voc Amazon Reviews utilise-t-il ?
Voc Amazon Reviews s'exécute en local via stdio.
Quand Voc Amazon Reviews a-t-il été vérifié pour la dernière fois ?
Dernière vérification : 2026-10-27. Review Analyzer — agent-native VOC for e-commerce. 6 MCP tools, ASIN or CSV input, black-gold dashboard. Backed by Shulex VOC OpenAPI (10 markets).