详细介绍
概览
eBay MCP 是 eBay 官方推出的 Model Context Protocol(MCP)服务器,由 eBay 自家 GitHub 组织维护。它让 Claude Desktop、Cursor、Cline 等 AI 助手能用自然语言直接调用 eBay 平台的 REST API——查 listing、浏览类目、管理 eBay 数据,不再需要记接口地址或写一堆样板 API 调用代码。
作为 eBay 一方出品,它在底层包装了 eBay 的 OpenAPI 规范并自动处理 OAuth,AI Agent 可以像调用任何其他工具一样发现并调用 eBay 接口。因为是 eBay 自己发布,它能跟随 eBay 真实 API 表面做同步更新,这一点是社区包装器无法保证的。
主要功能
- 自然语言访问 API:用大白话描述需求,Agent 自动映射到对应的 eBay REST 接口——无需记 URL 和参数。
- OAuth 自动管理:一次性提供 Client ID 和 Client Secret,后续的令牌生成和刷新(约每两小时一次)由服务器自动处理。
- 双 Token 模式:Application Token 用于公开数据(搜索、浏览),User Token 用于卖家授权的私有数据(账号、订单)。
- MCP Prompt 支持:为 AI 助手深度集成,让 eBay API 工作流在 Claude、Cursor、Cline 里像原生功能一样自然。
- OpenAPI 驱动:基于 eBay 发布的 OpenAPI 规范构建,新文档化的接口自动跟进。
- 广泛客户端兼容:支持任何 MCP 兼容客户端(Claude Desktop、Cursor、Cline 等)。
如何使用
- 安装兼容 MCP 的客户端(Claude Desktop、Cursor、Claude Code 等)。
- 从 https://github.com/eBay/npm-public-api-mcp 克隆或安装服务器,按 README 完成构建 /
npx/ Docker。 - 在对应平台申请 API 凭证,写入 MCP 的
env,切勿把密钥提交到 Git。 - 在客户端 MCP 配置(如 Claude Desktop 的
claude_desktop_config.json或 Cursor 的mcp.json)中注册该服务器,然后重启客户端。 - 先用只读问题验证;确认权限与确认开关后再启用写入类工具。
定价
开源免费。MCP 服务器本身在 eBay 自家 GitHub 组织下发布,零费用。使用它需要一个免费的 eBay 开发者账号(在 developer.ebay.com 注册),按 eBay API 标准的速率限制执行。
适合谁
希望在 AI 助手里直接操作 eBay 的卖家和开发者——做市场调研、Listing 体检、浏览类目,或者不用自己写 API 集成就能搭出 eBay 自动化原型。尤其适合已经用熟 Claude Desktop 或 Cursor 的技术型卖家。
常见问题
这是 eBay 官方工具吗?
是的,由 eBay 自家 GitHub 组织(eBay/npm-public-api-mcp)维护,不是社区项目。这是 eBay 唯一接近"厂商支持"的 MCP。
运行需要什么?
Node.js 22 及以上版本 + 一个免费的 eBay 开发者账号(会拿到 Client ID 和 Client Secret)。之后 OAuth 令牌刷新由服务器自动完成。
支持卖家的私有数据吗?
支持。有双 Token 模式——Application Token 拿来取公开数据(搜索、浏览),User Token 拿来取需要卖家授权的私有数据。
免费吗?
MCP 服务器开源免费。只需要一个免费的 eBay 开发者账号,eBay API 调用遵循 eBay 标准速率限制。