# VOC Amazon Reviews

Extracts Amazon or CSV customer reviews, detects buyer pain points, and builds HTML dashboards. Useful for rewriting e-commerce listings based on real feedback.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 37
- Author: mguozhen
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/mguozhen/voc-amazon-reviews
- Updated: 2026-05-25
- HTML: https://affpapa.org/en/nevibecode/mcp/voc-amazon-reviews

## What it does

The server provides six tools to pull and inspect customer feedback. It queries Shulex OpenAPI by ASIN across 10 Amazon marketplaces. If your catalog lives elsewhere, the `analyze_csv` tool accepts review spreadsheets from Shopify, eBay, or Helium 10 using fuzzy column mapping. Output options include Markdown summaries, raw JSON data, and a standalone black-and-gold HTML deck.

Running the server requires `uvx` and a valid `VOC_API_KEY`. Shulex offers a free tier of 100 requests per month without requiring a payment card. The `extract_listing_improvements` tool calls Claude directly, so it fails without a native `ANTHROPIC_API_KEY` from Anthropic. Be mindful of execution times on serverless hosts: full analysis can take up to 90 seconds.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `VOC_API_KEY`, `ANTHROPIC_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add voc-amazon-reviews-mcp -e VOC_API_KEY=<VOC_API_KEY> -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -- uvx voc-amazon-reviews-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from voc-amazon-reviews-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add voc-amazon-reviews --env VOC_API_KEY=<VOC_API_KEY> --env ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -- uvx voc-amazon-reviews-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from voc-amazon-reviews-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "voc-amazon-reviews": {
            "command": "uvx",
            "args": [
                "voc-amazon-reviews-mcp"
            ],
            "env": {
                "VOC_API_KEY": "<VOC_API_KEY>",
                "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from voc-amazon-reviews-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "voc-amazon-reviews": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "voc-amazon-reviews-mcp"
            ],
            "env": {
                "VOC_API_KEY": "<VOC_API_KEY>",
                "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from voc-amazon-reviews-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e VOC_API_KEY=<VOC_API_KEY> -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> voc-amazon-reviews uvx voc-amazon-reviews-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from voc-amazon-reviews-mcp <command>

## When to use it
- Fetch customer reviews for an Amazon ASIN across 10 marketplaces
- Extract product flaws and user complaints from custom CSV files
- Generate listing bullet points grounded in buyer phrasing
- Render an offline HTML sentiment dashboard without external assets

## Example prompts
- Generate a VOC report for ASIN B08N5WRWNW and export the dashboard to `~/Desktop/voc.html`
- Analyze customer complaints in `reviews.csv` and list recurring defects
- Generate 5 listing bullet points for `B08N5WRWNW` based on customer feedback

## Similar
- [labelhead-artist-momentum](https://affpapa.org/en/nevibecode/mcp/labelhead-artist-momentum.md) — MCP server · ★ 107423
- [openshorts](https://affpapa.org/en/nevibecode/mcp/openshorts.md) — MCP server · ★ 7049
- [OpenScreen](https://affpapa.org/en/nevibecode/mcp/openscreen.md) — MCP server · ★ 4863
- [Usertour MCP Server](https://affpapa.org/en/nevibecode/mcp/usertour-mcp-server.md) — MCP server · ★ 2326
- [Appllama](https://affpapa.org/en/nevibecode/mcp/appllama.md) — MCP server · ★ 3046
- [obsei](https://affpapa.org/en/nevibecode/mcp/obsei.md) — MCP server · ★ 1441

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md