Bonhams

@pipeworx/bonhams

Bonhams 的拍卖成交价——按艺术家或制作人搜索过去（“已售出”）的拍品，并获取落槌价、含买家佣金的落槌价（实际成交价）、估价范围、拍卖日期和部门；还可获取单件拍品的完整详情（描述、品相、图片）。

属于 Pipeworx——一个将 AI agents 连接到 1875+ 个实时数据源的 MCP 网关。这是一个独立的非官方集成，与上游服务提供商无关联，未经其认可，也非由其发布。

工具

• bonhams_results_search(query, category?, page?, limit?) — 按艺术家／制作人／关键词搜索 Bonhams 的已售拍品档案。category 是自由文本筛选条件，会与部门名称匹配（例如“珠宝”“版画”“书籍”）。
• bonhams_lot_details(auction_id, lot_no, slug?) — 获取单件拍品的完整详情，使用 bonhams_results_search 结果中携带的 auction_id／lot_no 作为键。

身份验证

无需密钥。公开页面，无需登录。

数据来源

• https://www.bonhams.com/search/?chronology=past&query=<q>&page=<n> — 网站自身的过往拍品搜索页面。这是一个 Next.js 应用，会将完整结果集服务器渲染到 __NEXT_DATA__ JSON 数据块（pageProps.lotData.auctionLots[]）中——普通的 fetch() 就能获取实际数据，无需单独调用 XHR／API。每个条目都包含 price.hammerPrice（佣金前价格）和 price.hammerPremium（买家实际支付的成交价，与页面上显示的“含佣金售价 $X”一致），以及 estimateLow／estimateHigh、department.name、hammerTime.datetime、auctionId 和 lotNo（其格式为 {full, letter, number}——有时缺少 full，此时回退使用 number）。
• https://www.bonhams.com/auction/<auctionId>/lot/<lotNo>/<slug>/ — 拍品详情页，采用相同的 SSR 模式，包含一个字段更丰富的 "lot":{...} 对象，其中有 sDesc／sCatalogDesc（HTML 描述）、dHammerPrice、dHammerPremium、dEstimateLow／dEstimateHigh、images[]。URL 中的 slug 不会经过验证——只要 auctionId／lotNo 匹配，任何字符串都可以，因此调用方不需要提供 Bonhams 完整的描述性 slug。
• robots.txt（2026-09-05 检查）仅禁止访问 /ldc/、/vms-assets/、*aggregate$、*head_image*——本工具包均不会访问这些路径。未为 User-agent: * 声明抓取延迟。

另外两家拍卖行（Sotheby's、Phillips）的调查记录

Bonhams 首先上线，因为其实际成交价以普通 SSR HTML 呈现，没有访问限制——这是找到的最简单形式。以下是另外两家的快速探查记录，供后续构建其工具包的人员参考：

• Sotheby's — robots.txt 为 User-agent: * 设置了 Crawl-delay: 15，并禁止访问 /bsp-api/*（其实际 API 路径）以及所有 PDF 导出内容。结果页面很可能通过 /bsp-api/ 后面的真正客户端 API 调用获取数据，而 robots.txt 明确禁止访问该路径——在直接认定数据完全无法获取之前，值得先检查是否有其他未被禁止的端点提供相同数据。
• Phillips — robots.txt 禁止访问 /Search、/search、/SEARCH、/bin/、/phillips/otis、/*/filter/。显而易见的关键词搜索路径被禁止，且不区分大小写；通过其他方式（例如从站点地图或部门列表）访问拍品详情页，可能仍然可行——本次会话未进行探查。
• Christie's — 根据构建计划，不在范围内（已关闭，使用内部 API）。

Bonhams 证明了按拍卖行分别构建工具包的方式可行，因此已为另外两家提交后续任务：**#1280（Sotheby's）**和 #1281（Phillips），每项任务都附有上述探查记录。

快速开始

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

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

此端点实际提供的内容

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

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

curl -X POST https://gateway.pipeworx.io/v1/tools/bonhams_results_search \
  -H 'Content-Type: application/json' \
  -d '{"query":"Picasso"}'

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

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

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

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

或者直接运行，确认服务能够启动：

npx -y @pipeworx/mcp-bonhams

它通过 stdin/stdout 使用 MCP 协议，并针对仅限此工具包的工具响应 initialize/tools/list/tools/call——不包含上方网关连接所提供的任何共享元工具。来源相同、工具相同，但没有 ask_pipeworx 路由。

使用 ask_pipeworx

你可以用通俗易懂的英语提问，而不必直接调用工具——此方式既适用于上方的工具包端点，也适用于完整网关：

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

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT