Voc Amazon Reviews

MCP运维云端

提供方 mguozhen

运维云端 未标注 API Key 社区 / 第三方 ClaudeCursorClineCodex
查看接入方式

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

一句话选型结论

按资料字段整理

Voc Amazon Reviews 属于运维云端类 MCP 服务器,传输方式未标注,API Key,可直接接入 Claude、Cursor、Cline 等,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式未标注 鉴权API Key 部署方式未标注
GitHub 星标 未标注 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

运维云端
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

mcp mcp server amazon amazon fba agent tools

支持客户端

适用场景

mcpmcp serveramazon

安装与配置

未标注 API Key
上游未给出传输方式
"command": "uvx",\r

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude、Cursor、Cline,换客户端不用重新研究配置。

先想清楚的地方

  • 使用前要准备好API Key对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 已经在用 Claude、Cursor 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Voc Amazon Reviews当前 未标注 未标注 未标注 有 未标注
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

运维云端
字段来自项目仓库与公开索引,中文说明由本站标注
提供方mguozhen上游标注的维护方 mguozhen
分类运维云端本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式API Key远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Cross-platform本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验未标注上游最后核验时间

详细介绍

10.1 KB
来自项目仓库与上游目录的原文,未做删改

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.

↑ Sample dashboard: B08N5WRWNW · 100 reviews · sentiment + pain points + listing improvements, generated by render_dashboard.


TL;DR

Two inputs, six tools, three outputs.```
┌─────────────┐ ┌──────────────┐
│ ASIN │──┐ ┌─│ Markdown │
└─────────────┘ │ ┌─────────────────────────┐ │ │ report │
├──────▶ 6 agent-callable tools ├──────┤ ├──────────────┤
┌─────────────┐ │ └─────────────────────────┘ │ │ Structured │
│ CSV / XLSX │──┘ fetch_reviews analyze_csv │ │ JSON │
└─────────────┘ analyze_reviews voc_full │ ├──────────────┤
extract_listing_improvements └─│ Black-gold │
render_dashboard │ HTML deck │
└──────────────┘


- **Inputs** — Amazon ASIN (auto-fetched via Shulex VOC OpenAPI, 10 markets) **or** any review CSV / Excel (Helium 10 / eBay / Shopify / custom — fuzzy column detection)
- **Outputs** — Markdown report · structured JSON · standalone HTML dashboard
- **Surface** — MCP server (works in Claude Code / Cursor / Cline / Continue) **and** Skill (works in Claude Code)

---

## Quick start

### Option A — As an MCP server (recommended)

Requires `uv`.

Add this to your MCP client config (Claude Code, Claude Desktop, Cursor, Windsurf, VS Code Copilot, Cline, Continue.dev):```json
{
  "mcpServers": {
    "voc-amazon-reviews": {
      "command": "uvx",
      "args": ["voc-amazon-reviews-mcp"],
      "env": {
        "VOC_API_KEY": "your-shulex-key"
      }
    }
  }
}

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

bash voc.sh B08N5WRWNW --limit 100 --market US


### Option C — Bring your own reviews (CSV)```bash
# 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:

  1. Fork or clone this repo to your GitHub.
  2. Sign in at smithery.ai with GitHub.
  3. Deploy a server → pick the repo. Smithery builds the container and
    exposes an HTTPS MCP endpoint.
  4. Share the URL with users; they paste it into Claude / Cursor / Cline.

The same image runs anywhere that takes a Dockerfile — Fly.io, Railway,
Cloudflare Workers (with adapter), Render, Cloud Run.

To run the HTTP transport locally (e.g. for testing):```bash
MCP_TRANSPORT=streamable-http PORT=8080 python -m mcp_server.server


### Option E — Deploy to Vercel (serverless)

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:

| | Typical seller-tool data layer | **review-analyzer** |
|---|---|---|
| **Source** | Web scraper / undocumented scrape API | Paid Shulex VOC OpenAPI |
| **Reliability** | Breaks when Amazon updates HTML | API-grade, no DOM dependencies |
| **Markets** | US-only or 2-3 markets | **10**: US, CA, MX, GB, DE, FR, IT, ES, JP, AU |
| **Volume** | 10–50 reviews (free-tier cap) | Up to **1,000 reviews per ASIN** |
| **Freshness** | Daily snapshots, sometimes cached for days | Live pull |
| **Schema** | Strings only | Full: verified-purchase, helpful votes, vine, variant, dates |
| **Access** | Locked behind a UI | curl + JSON, fully scriptable, MCP-ready |

**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.

---

## vs. the alternatives

| | **review-analyzer** | Helium 10 / Data Dive | review-analyzer-skill (Buluu) | Generic review scrapers |
|---|---|---|---|---|
| **Input** | ASIN **or** CSV | ASIN (manual UI) | CSV only | URL |
| **Markets** | 10 | 1-3 | depends on user's data | 1 |
| **Output** | JSON + Markdown + **HTML dashboard** | UI dashboard (locked) | CSV + MD + HTML dashboard | Raw CSV |
| **MCP-callable** | ✅ | ❌ | ❌ Claude Code only | ❌ |
| **Listing copy gen** | ✅ `extract_listing_improvements` (cite-by-pain-point) | Keyword research only | ❌ | ❌ |
| **Cost** | Shulex API + Anthropic API ($0.05-0.20/listing) | $99-249/month subscription | Free (uses your Claude quota) | Free, brittle |
| **Open source** | ✅ MIT | ❌ | ✅ MIT | varies |

> **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.

---

## Architecture```
mcp_server/
├── server.py                  # 6 @mcp.tool decorators
├── tools.py                   # implementations (subprocess wrappers + Anthropic SDK)
├── csv_loader.py              # fuzzy column detection for CSV/Excel input
├── dashboard.py               # HTML rendering
├── dashboard_template.html    # black-gold template (placeholders)
├── tag_system.yaml            # 22-dim tag schema (customizable per category)
├── schemas.py                 # pydantic structured-output models
└── tests/                     # 36 unit tests (subprocess + Anthropic mocked)

fetch.sh / analyze.sh / voc.sh   # shell pipeline behind tools 1-3
  • fetch + analyze loop: shell scripts (proven, reproducible, easy to debug)
  • listing rewrites: Anthropic SDK direct (claude-opus-4-7 + adaptive thinking + prompt caching on the system rubric)
  • dashboard: pure stdlib HTML rendering, no node / no react

Distribution / where to find us

Channel Status
punkpeye/awesome-mcp-servers PR #6528 ✅ Open
cline/mcp-marketplace issue #1602 ✅ Open
Glama 🟢 Auto-indexed via GitHub topics
mcp.directory 🟢 Auto-pull
mcp.so / PulseMCP 🟡 Pending (manual form submit)
Smithery 🟡 Container deploy ready (smithery.yaml + Dockerfile in repo)
Official MCP Registry 🟡 Pending PyPI publish (W2)

Roadmap

  • [x] Drop in CSV / Excel (any platform, fuzzy column detect)
  • [x] 22-dimension tag system (YAML-configurable)
  • [x] Black-gold HTML dashboard tool
  • [x] 6 MCP tools shipped
  • [ ] npx skills add mguozhen/review-analyzer one-line install
  • [ ] CLI subprocess engine option (use your Claude subscription, $0 API)
  • [ ] PyPI publish + official MCP Registry submission
  • [x] Smithery deploy config (smithery.yaml + Dockerfile)
  • [x] Vercel deploy config (vercel.json + app.py)
  • [ ] Smithery / mcp.so / PulseMCP form submissions

License

MIT. See LICENSE.

Acknowledgments: Tag schema, CSV column detection, and dashboard visual design inspired by buluslan/review-analyzer-skill. Data layer powered by Shulex VOC OpenAPI.

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
Voc Amazon Reviews 怎么安装?

在客户端按下面的安装命令接入:"command": "uvx",\r。装完在客户端配置里引用同一个包或端点。

Voc Amazon Reviews 怎么在 Claude、Cursor、Cline 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Voc Amazon Reviews 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Voc Amazon Reviews 需要 API Key 吗?

资料标注需要API Key认证,使用前准备好对应凭据,并按最小权限配置。

Voc Amazon Reviews 支持哪些客户端?

资料标注支持 Claude、Cursor、Cline、Codex、Zed;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Voc Amazon Reviews 能提供哪些能力?

资料显示能力标签包括 mcp、mcp server、amazon、amazon fba、agent tools。具体工具清单以官方文档为准。

Voc Amazon Reviews 需要什么运行环境?

运行时为 Cross-platform。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 未标注。