Ebid

@pipeworx/ebid

eBid MCP — 通过官方 eBid Trading API v2，访问 eBid.net 在线市场和拍卖网站上的商品列表、已结束商品搜索、出价历史和分类。eBid 在 20 多个国家/地区运营网站（us、uk、ca、au、de、fr 等）；它是 eBay 之外的小型市场，因此请将其视为次要的商品列表/价格来源。

Pipeworx 的一部分：Pipeworx 是连接 AI Agent 与 1878+ 个实时数据源的 MCP 网关。这是一个独立的非官方集成，与上游服务提供方无关联、未获其认可，也不是由其发布。

工具

• ebid_search(keyword?, site?, category_id?, min_price?, max_price?, condition?, buy_now_only?, closed?, username?, country?, search_descriptions?, sort?, start?, rows?) — 搜索当前商品列表，或使用 closed: true 搜索已结束的商品（成交价格可在其中查询）。每页最多 75 行（API 上限）。
• ebid_listing(listing_id, site?, ship_to?) — 查看完整的单个商品列表，并计算运送至 ship_to 的运费。
• ebid_listing_bids(listing_id, site?) — 查看出价历史；拍卖结束后，最高出价即为成交价。
• ebid_categories(category_id?, site?) — 查看分类树及各分类的商品数量。

身份验证

• 仅支持自带凭据： 每条 eBid API 命令（包括文档中所述的无需登录读取命令）若没有 AppId/AppKey 配对，都会被上游拒绝（错误 003）。请在 eBid 开发者门户 https://ebid.3scale.net/ 免费注册，然后将两者作为一个参数传入：_apiKey: "AppId:AppKey"。
• 注册不代表可以调用 API。 eBid 会在注册时签发应用的 AppId 和 AppKey，但还需单独激活应用。因此，刚生成的凭据对虽然可以通过身份验证，却仍无法获取任何数据：每条命令都会返回错误 116 application is not active。Pipeworx 持有这样一对凭据（fleet #1284，签发于 2026-09-07），因此此工具包仍仅支持自带凭据——在实时调用成功之前，我们会刻意不声明 PLATFORM_EBID_KEY，因为一个无法响应的已声明密钥会让路由器不断选择一个必定失败的工具包。

区分四种凭据错误

eBid 对所有这些错误都返回 HTTP 200，其中三种使用相同的代码 116。我们于 2026-09-07 对 api.ebid.net/trading 进行了实时探测：

发送的内容	代码	上游描述
未提供 AppId	003	AppID not received. Please check your credentials are correctly formatted
eBid 从未签发过的 AppId	116	application with id="…" was not found
真实的 AppId，但 AppKey 错误	116	application key "…" is invalid
真实、匹配但尚未激活的凭据对	116	application is not active

此工具包会分别映射为不同的消息。只有第一种情况会提示调用者传入密钥；其余三种情况意味着调用者已经传入密钥，解决方法在别处。

数据源

• https://api.ebid.net/trading — eBid Trading API v2；单一端点，使用 JSON POST 请求，并在请求体中传入命令。文档：https://ebid.3scale.net/doc-json。
• 失败时会返回 HTTP 200 和一个 Error 数组；此工具包会显示上游代码和描述，而非状态行。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "ebid": {
      "url": "https://gateway.pipeworx.io/ebid/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/ebid/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 共享元工具——ask_pipeworx、discover_tools、search_within、remember/recall 以及网关级工具集中的其他工具。因此，你看到的工具数量会多于此表所列：目前，单个工具包端点除了列出该工具包自身的工具外，还会列出约 30 个共享工具。连接的 initialize 响应会说明其确切范围，是当天实际情况的权威依据。

这是有意设计的，并非意外的多路复用。元工具让限定范围的连接能够回答此工具包无法涵盖的问题——通过 ask_pipeworx 跨整个目录进行路由——无需再添加第二个 MCP 服务。目前无法挂载不含这些元工具的工具包端点；如果额外的架构定义占用的上下文超过路由带来的价值，请连接一次完整网关，而不是连接多个工具包端点。

你也可以连接完整的 Pipeworx 网关，直接获取每个工具包列出的工具，而不只是此工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都连接到同一个网关和相同的 1878+ 个数据源。唯一的区别是直接列出哪个工具包的工具；从任一端点都可以通过 ask_pipeworx 访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/ebid_search \
  -H 'Content-Type: application/json' \
  -d '{"keyword":"lego","site":"uk"}'

首次调用无需账户。查看任意工具：GET https://gateway.pipeworx.io/v1/tools/ebid_search。查找工具：使用 {"query":"..."} 向 https://gateway.pipeworx.io/v1/tools/search_packs 发送 POST 请求。

独立运行（无需网关账户）

此软件包也可以作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需通过网关往返：

{
  "mcpServers": {
    "ebid": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-ebid"]
    }
  }
}

或者直接运行它以确认已启动：

npx -y @pipeworx/mcp-ebid

它通过 stdin/stdout 使用 MCP 协议，并响应 initialize/tools/list/tools/call，仅提供此工具包的工具——不包含上述网关连接额外提供的任何共享元工具。源代码相同，工具相同，但不包含 ask_pipeworx 路由。

使用 ask_pipeworx

你可以用简单的英语提问，而不是直接调用工具——此方式既适用于上面的工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Ebid data" })

网关会自动选择合适的工具并填入参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT