Shopgoodwill

ShopGoodwill Auctions

搜索正在进行的拍卖、已结束且有实际成交价的拍卖，以及 shopgoodwill.com 上单个商品的详细信息——这是由 Goodwill 成员组织运营的在线拍卖网站（170 多家地区卖家在此刊登相机、珠宝、手表、艺术品、电子产品、乐器和收藏品）。

这是 Pipeworx 的一部分——一个将 AI Agent 连接到 1683 多个实时数据源的 MCP 网关。

已结束拍卖搜索可用于估算同类商品价格：它会返回商品的实际成交价（最终落槌价和出价次数），数据大约可追溯 90 天。

工具

工具	返回内容
shopgoodwill_search	按关键词搜索正在进行的商品：当前出价、出价次数、一口价、类别、结束时间、商品链接。可选价格范围、类别 ID、仅一口价筛选条件和分页（每页最多 40 条）。
shopgoodwill_sold_search	按关键词搜索已结束的拍卖，并返回结束时的最终价格。num_bids > 0 的条目以 final_price 成交；出价次数为 0 的条目未售出。days_back 最多可查询存档覆盖的约 90 天。
shopgoodwill_item	根据 item_id 获取一个商品的完整详情：描述、当前/最低出价、出价历史（网站会隐藏竞拍者姓名）、Goodwill 卖家组织、运费/手续费、图片和结束时间。

时间戳不包含时区标记，采用美国太平洋时间（网站惯例）。

身份验证

无需身份验证。搜索和商品详情端点无需凭据即可响应。

数据源

• ShopGoodwill 买家 API：https://buyerapi.shopgoodwill.com/api/Search/ItemListing （搜索、进行中和已结束的拍卖）以及 https://buyerapi.shopgoodwill.com/api/itemDetail/GetItemDetailModelByItemId/{id} （商品详情）——与 shopgoodwill.com 网页应用使用的 JSON 后端相同。
• 请求结构由社区客户端 scottmconway/shopgoodwill-scripts 记录。

上游特性（2026-09-05 实测）

• 错误或不完整的搜索请求体会返回零条结果，但状态码为 200—— lowPrice/highPrice 必须是 "0"/"999999" 这样的字符串，不能留空。
• pageSize 会被静默忽略——每页固定为 40 条（请求 5 条或 100 条，都会得到 40 条，且不报错）；分页通过 page 实现。工具的 per_page 在 客户端侧生效。
• 已结束拍卖存档的覆盖范围为约 90 天，与请求的 closedAuctionDaysBack 值无关。
• 不存在的商品 ID 会返回 404，响应正文为空。

快速开始

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

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

此端点实际提供的内容

https://gateway.pipeworx.io/shopgoodwill/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 都会访问同一个网关和相同的 1683 多个数据源。唯一的区别是，哪些工具包的工具会被直接列出；无论连接哪个端点，ask_pipeworx 都可以访问所有工具包的工具。

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

curl -X POST https://gateway.pipeworx.io/v1/tools/shopgoodwill_search \
  -H 'Content-Type: application/json' \
  -d '{"query":"nikon","per_page":5}'

首次调用无需账号。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/shopgoodwill_search。查找工具：POST https://gateway.pipeworx.io/v1/tools/search_packs，并传入 {"query":"..."}。

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

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

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

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

npx -y @pipeworx/mcp-shopgoodwill

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

使用 ask_pipeworx

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

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

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT