Voc Amazon Reviews
About
Agent-native Amazon review intelligence — fetches verified reviews from 10 marketplaces via real Shulex OpenAPI (not scrapers) and produces copy-ready listing improvements grounded in actual customer language. Backed by a 2B-review historical dataset that Helium 10 / Jungle Scout
Details
- Transport
- SSE
Explore
- Real OpenAPI access, not DOM scraping
- Verified-purchase, Vine, and helpful-vote signals included
- Proprietary listing rubric trained on 2B+ reviews
- Agent-first design with optimized tool schemas
- Fetch up to 1000 reviews per ASIN
- Generate standalone HTML dashboards
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Voc Amazon ReviewsCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Add this to your MCP client config (Claude Code, Cursor, Cline):
``json`
{
"mcpServers": {
"voc-amazon-reviews": {
"command": "uvx",
"args": [
"voc-amazon-reviews-mcp"
],
"env": {
"VOC_API_KEY": "your-shulex-key",
"ANTHROPIC_API_KEY": "your-anthropic-key"
}
}
}
}
Requires
Get a free Shulex API key (100 calls/month, no credit card): apps.voc.ai/openapi
fetch_reviews
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). Args: asin: 10-character Amazon product ID (e.g. "B08N5WRWNW"). market: Market code (US, GB, DE, FR, IT, ES, JP, AU, CA, MX) or amazon.* domain ("amazon.co.uk"). Default…
analyze_reviews
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.sh's `{reviews, meta}` envelope, or a bare list of review objects. asin: 10-character ASIN that the reviews belong to (for the report header). Returns: …
voc_full
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 (default: US). limit: Number of reviews to fetch (default 100, max 1000). Returns: Same shape as `analyze_reviews`.
extract_listing_improvements
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 missing keywords — each suggestion citing the pain point it preempts or selling point it amplifies. Requires ANTHROPIC_API_KEY. Costs ~$0.05-0.20 per call (claude-opus-4-7).
analyze_csv
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 the file. Use this when: - The product is NOT on Amazon (eBay / AliExpress / D2C) - You already have a reviews file from another source - You want to bypass the Shulex VOC API entir…
render_dashboard
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 listing optimization card. Args: report: Output from `analyze_reviews` / `voc_full` / `analyze_csv`. improvements: Optional output from `extract_listing_improvements`. produc…
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"voc amazon reviews": {
"voc-amazon-reviews": {
"command": "uvx",
"args": [
"voc-amazon-reviews-mcp"
],
"env": {
"VOC_API_KEY": "your-shulex-key",
"ANTHROPIC_API_KEY": "your-anthropic-key"
}
}
}
}
}McpServers
{
"voc-amazon-reviews": {
"command": "uvx",
"args": [
"voc-amazon-reviews-mcp"
],
"env": {
"VOC_API_KEY": "your-shulex-key",
"ANTHROPIC_API_KEY": "your-anthropic-key"
}
}
}What it does
| Tool | What it does | |---|---| |fetch_reviews | Pull verified Amazon reviews for any ASIN, up to 1000 per call |
| analyze_reviews | Turn raw reviews into structured VOC reports (themes, sentiment, complaints) |
| voc_full | One-shot fetch + analyze for ad-hoc seller questions |
| extract_listing_improvements | Generate copy-ready title, 5 bullets, description — grounded in real customer language. Uses Claude Opus 4.7 + proprietary rubric distilled from Shulex's 2B-review corpus |
| analyze_csv | Run VOC analysis on any CSV/Excel (Walmart, Shopify, support tickets) |
| render_dashboard | Generate standalone HTML dashboards |
Why it's different
- Real OpenAPI access, not DOM scraping — won't break when Amazon changes HTML - Verified-purchase, Vine, helpful-vote, variant signals included in every review - Proprietary listing rubric trained on 2B+ historical Amazon reviews (data indexed before Amazon's access restrictions; cannot be replicated by buying API access today) - Agent-first design — tool schemas, error codes, and metadata optimized for LLM router selectionInstallation (one line)
Add this to your MCP client config (Claude Code, Cursor, Cline): ``json
{
"mcpServers": {
"voc-amazon-reviews": {
"command": "uvx",
"args": [
"voc-amazon-reviews-mcp"
],
"env": {
"VOC_API_KEY": "your-shulex-key",
"ANTHROPIC_API_KEY": "your-anthropic-key"
}
}
}
}
`
Requires uv (install). First run pulls the repo and resolves deps in ~10s; subsequent runs are instant.
Get a free Shulex API key (100 calls/month, no credit card): apps.voc.ai/openapi
Example workflows
Listing rewrite: "Pull reviews of my ASIN and the top 3 competitors. Rewrite my listing to attack their weak points." → agent calls fetch_reviews × 4 → analyze_reviews × 4 → extract_listing_improvements → complete listing draft.
Daily monitoring: Schedule voc_full × 10 ASINs daily via cron; alerts on new negative theme clusters.
Competitor gap analysis: "What do customers complain about in this category that no top seller addresses?" → fetch_reviews × 5 → analyze_reviews` → list of unaddressed pain points.
License
MITSign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
