VOC Amazon Reviews

mguozhen/voc-amazon-reviews

Connects Claude to Amazon review data across 10 marketplaces through Shulex VOC's OpenAPI. You get six tools: fetch reviews by ASIN, run sentiment and pain point analysis, generate listing improvements grounded in customer language, ingest your own CSV exports from Helium 10 or Shopify, and render standalone HTML dashboards. The listing improvement tool is the standout, it rewrites titles, bullets, and descriptions using phrases customers actually typed. Ships with verified purchase flags, Vine badges, and helpful vote counts in the schema. Handles up to 1,000 reviews per product. Works as a standard MCP server or deploys to Vercel, Smithery, or any Docker host if you need remote access.

GitHub stars: 28
tools: 6
auth: Secret needed
transport: STDIO
env vars: 2
last updated: May 20, 2026

View on GitHub

Tools

6 tools

Public tool metadata for what this MCP can expose to an agent.

fetch_reviewsFetch raw Amazon reviews for an ASIN via the Shulex VOC API. No analysis — returns the raw review array plus metadata. Use this when you want to plug reviews into your own analysis pipeline, or when you plan to call `analyze_reviews` later (avoids paying the Shulex API twice)....3 params

Fetch raw Amazon reviews for an ASIN via the Shulex VOC API. No analysis — returns the raw review array plus metadata. Use this when you want to plug reviews into your own analysis pipeline, or when you plan to call `analyze_reviews` later (avoids paying the Shulex API twice)....

Parameters* required

asinstring

limitinteger

default: 100

marketstring

default: US

analyze_reviewsRun AI analysis on reviews you already have. Useful when you fetched reviews via `fetch_reviews` (or your own scraper) and want the VOC report — sentiment breakdown, pain points, selling points, listing tips — without re-paying the Shulex API. Args: reviews_json: Either fetch....2 params

Run AI analysis on reviews you already have. Useful when you fetched reviews via `fetch_reviews` (or your own scraper) and want the VOC report — sentiment breakdown, pain points, selling points, listing tips — without re-paying the Shulex API. Args: reviews_json: Either fetch....

Parameters* required

asinstring

reviews_jsonvalue

voc_fullOne-shot: fetch reviews AND run AI analysis. The default tool for "give me a VOC report on this ASIN" style requests. Internally equivalent to `bash voc.sh ASIN` — calls fetch.sh and analyze.sh in sequence. Args: asin: 10-character ASIN. market: Market code or amazon.* domain...3 params

One-shot: fetch reviews AND run AI analysis. The default tool for "give me a VOC report on this ASIN" style requests. Internally equivalent to `bash voc.sh ASIN` — calls fetch.sh and analyze.sh in sequence. Args: asin: 10-character ASIN. market: Market code or amazon.* domain...

Parameters* required

asinstring

limitinteger

default: 100

marketstring

default: US

extract_listing_improvementsDifferentiator tool — derive specific, copyable listing improvements from the VOC report, grounded in actual customer language. Instead of raw search-volume tables (Data Dive style), Claude reads the full VOC report and produces a title, 5 bullets, a description paragraph, and...3 params

Differentiator tool — derive specific, copyable listing improvements from the VOC report, grounded in actual customer language. Instead of raw search-volume tables (Data Dive style), Claude reads the full VOC report and produces a title, 5 bullets, a description paragraph, and...

Parameters* required

asinstring

limitinteger

default: 100

marketstring

default: US

analyze_csvAnalyze any review CSV / Excel — not just Amazon. Drag in a Helium 10 export, an eBay / AliExpress scrape, or your own Shopify export. The loader fuzzy-matches column names (`内容` / `评价` / `body` / `review` / `content` all detected automatically) so you don't have to reformat t...3 params

Analyze any review CSV / Excel — not just Amazon. Drag in a Helium 10 export, an eBay / AliExpress scrape, or your own Shopify export. The loader fuzzy-matches column names (`内容` / `评价` / `body` / `review` / `content` all detected automatically) so you don't have to reformat t...

Parameters* required

csv_pathstring

marketstring

default: OTHER

product_namevalue

render_dashboardRender a VOC report as a standalone black-gold HTML dashboard. The output is single-file HTML — no external dependencies, opens directly in any browser. Includes sentiment bar, pain-point / selling-point panels, executive summary, and (if `improvements` provided) a copy-ready...4 params

Render a VOC report as a standalone black-gold HTML dashboard. The output is single-file HTML — no external dependencies, opens directly in any browser. Includes sentiment bar, pain-point / selling-point panels, executive summary, and (if `improvements` provided) a copy-ready...

Parameters* required

improvementsvalue

output_pathvalue

product_namevalue

reportobject

Configuration

VOC_API_KEY*secret

Shulex VOC OpenAPI key. Get a free one (100 calls/month, no credit card) at https://apps.voc.ai/openapi

ANTHROPIC_API_KEYsecret

Anthropic API key. Only needed if you use extract_listing_improvements (which uses Claude Opus 4.7 for structured listing rewrites).

Readme

Review Analyzer

Agent-native voice-of-customer for e-commerce.
Drop in an ASIN or a CSV — get sentiment, pain points, copy-ready listing improvements,
and a black-gold HTML dashboard. 6 MCP tools. Backed by the most stable Amazon review data layer.

View the full README on GitHub

Details

Repository: github.com/mguozhen/voc-amazon-reviews
Package: voc-amazon-reviews-mcp
Transport: STDIO
Auth: Required
Registry: MCP registry, active