Easyparser — Amazon Product & Seller Data

easyparser-mcp

官方 Easyparser MCP 服务：通过 Model Context Protocol，让你的 AI Agent 实时获取覆盖 21 个市场的结构化 Amazon 数据。

商品详情、卖家报价、搜索结果、12 个月销售历史、Best Sellers Rank、包装尺寸、卖家法律身份、商品目录和反馈。10 种数据操作，加上批量任务监控和账户工具，只需一个连接。

Agent 可以做什么

产品数据

工具	返回内容	费用
get_product_detail	完整的产品资料：标题、价格、图片、评分、BSR、变体、评论	1 个点数（含 A+ 内容时另加 1 个点数）
get_product_offers	所有卖家报价：价格、商品状况、FBA/FBM、Buy Box 获胜者	每页 1 个点数（最多 5 页）
get_bestseller_rank	按类别显示当前 Best Sellers Rank	1 个点数
get_package_dimensions	精确尺寸、重量、Amazon 费用类别	1 个点数
get_sales_history	12 个月的每周趋势：浏览量、销量、价格、BSR	5 个点数，每增加 1 个月历史数据另加 1 个点数（最多 17 个）

搜索与发现

工具	返回内容	费用
search_products	按关键词/类别搜索结果，包含价格、评分、徽章	每页 1 个点数（最多 5 页）
lookup_product	UPC/EAN/GTIN/ISBN → ASIN 转换	1 个点数

卖家情报

工具	返回内容	费用
get_seller_profile	卖家法定名称、地址、30/90/365 天反馈趋势	1 个点数
get_seller_products	卖家的完整商品目录，包含价格和评分	每页 1 个点数（最多 5 页）
get_seller_feedback	单条买家反馈，可按评分/时间段筛选	每页 1 个点数（最多 5 页）

批量任务监控：跟踪从网页应用或 Bulk API 启动的任务

工具	返回内容	费用
list_bulk_jobs	你的批量任务及其进度：状态、已完成/失败/无效数量	免费
get_bulk_job_items	任务中每个项目的结果（用于调试失败/无效项目）	免费
get_bulk_item_result	项目生成的解析后数据（保留 24 小时）	免费
get_bulk_webhook_logs	任务完成时的 Webhook 投递日志	免费

错误日志：与网页应用中错误页面显示的数据相同

工具	返回内容	费用
get_error_logs	API 请求错误（实时和批量）：错误代码、渠道、操作、失败请求参数、时间戳	免费

账户与发现

工具	返回内容	费用
list_operations	操作目录，包含参数、费用和支持的域名。无需密钥即可使用	免费
check_credits	套餐、点数余额、速率限制，以及本月按操作统计的每日用量	免费

获取 API 密钥

在 app.easyparser.com/signup 注册：包含免费套餐，无需信用卡。你可以从账户 → 套餐复制 API 密钥。在下面的任何设置步骤要求填写 YOUR_API_KEY 时，粘贴此密钥。

设置

有两种连接方式：托管的远程服务（无需安装，始终保持最新）或通过 npx 本地运行（在你的计算机上运行）。

Cursor

一键安装（将打开 Cursor，并预先填入配置；出现提示时替换 YOUR_API_KEY）：

• 远程服务： 添加到 Cursor
• 本地（npx）： 添加到 Cursor

或者手动添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "easyparser": {
      "type": "http",
      "url": "https://mcp.easyparser.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

VS Code

一键安装（VS Code 会通过输入提示安全地询问你的 API 密钥）：

• 远程服务： 添加到 VS Code

或者手动添加到 .vscode/mcp.json：

{
  "servers": {
    "easyparser": {
      "type": "http",
      "url": "https://mcp.easyparser.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Claude Code

claude mcp add --scope user --transport http easyparser https://mcp.easyparser.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Claude Desktop & claude.ai

添加自定义连接器：

1. 打开 设置 → 连接器 → 添加 → 添加自定义连接器。
2. 名称： Easyparser
3. 远程 MCP 服务 URL： https://mcp.easyparser.com/mcp，然后点击 继续。
4. 在 身份验证 下，选择 无（Easyparser 使用 API 密钥，而非 OAuth）。
5. 在 请求标头 下，添加一个标头：名称为 authorization，值为 Bearer YOUR_API_KEY，并标记为 必填。
6. 点击 添加。

Manus

前往 设置 → 集成 → 自定义 MCP 服务 → 添加服务，并填写表单：

字段	值
服务名称	Easyparser
传输类型	HTTP
服务 URL	https://mcp.easyparser.com/mcp
自定义标头	标头名称：Authorization，值：Bearer YOUR_API_KEY（在 “Bearer ” 后粘贴你的 Easyparser API 密钥）

点击 测试 验证连接，然后点击 保存。该值始终是你的 Easyparser API 密钥；无需单独的令牌。

任意 MCP 客户端

托管端点通过 https://mcp.easyparser.com/mcp 提供 Streamable HTTP。使用 Authorization: Bearer YOUR_API_KEY 进行身份验证；x-api-key 和 api-key 标头也可使用。list_operations 发现工具无需密钥，因此 Agent 可以先探索，再注册。

对于本地 stdio 客户端，请在环境中设置 EASYPARSER_API_KEY，然后运行 npx -y easyparser-mcp。

示例提示词

What is the current price and rating of ASIN B0F25371FH?

Find the ASIN for UPC 041604458187, then show me its 6-month sales trend.

Who is the seller behind this product, what is their legal business name,
and what do their negative reviews say?

Compare the top 10 organic results for "stainless steel water bottle" on
amazon.de: prices, ratings, and which ones are Prime.

Is the bulk job I started this morning finished? If any items failed,
tell me which ASINs and why.

内置提示词和资源

支持 MCP 提示词的客户端可以一步启动以下工作流：

提示词	功能
analyze_competitor_product	单个 ASIN 的商品详情、卖家报价以及 3 个月的销量和 BSR 趋势
estimate_fba_logistics	用于 FBA 规划的精确包装尺寸、重量和费用类别
match_barcodes_to_asins	将 UPC、EAN、GTIN 或 ISBN 编码列表转换为 ASIN
vet_amazon_seller	卖家的法定身份、声誉趋势和负面反馈
product_market_research	关键词细分市场的热门自然搜索结果和需求对比

只读资源，免费且无需密钥即可使用：

• easyparser://operations：所有操作及其积分消耗
• easyparser://marketplaces：支持的 21 个 Amazon 域名
• easyparser://guide：选择工具和节省积分的决策规则

数据工具还会返回与其声明的 outputSchema 匹配的 structuredContent。

自托管 HTTP 服务

npm install -g easyparser-mcp
PORT=3000 easyparser-mcp-http   # or: node dist/http.js from a clone

也可以使用 Docker：

docker build -t easyparser-mcp .
docker run -p 3000:3000 easyparser-mcp

端点：POST /mcp（MCP）、GET /health（健康检查）。

工作原理

此服务是 Easyparser Real-Time API 之上的轻量级只读适配器。工具描述面向 AI Agent 编写：每个描述都会说明工具的返回内容、适用场景、更经济的工具何时更合适，以及所需的点数。每个响应都包含 credits_remaining，以便 Agent 根据预算做出决策。速率限制和身份验证错误会提供可操作的指引（包括注册链接），而不是原始 HTTP 状态码。

许可证

MIT。请参阅 LICENSE。