Sothebys

@pipeworx/sothebys

Sotheby's 的成交拍卖价格——按艺术家或制作人搜索所有拍卖的过往拍品档案，获取含买家佣金的成交价、获胜（落槌）出价、估价范围，以及拍卖名称／日期／地点；还可获取单件拍品的完整图录详情（描述、来源、文献、展览历史、图片）。

Pipeworx 的一部分（https://pipeworx.io）——一个将 AI Agent 连接到 1683+ 个实时数据源的 MCP 网关。

工具

• sothebys_results_search(query, category?, sale_type?, page?, limit?, include_unpriced?) — 按艺术家／制作人／关键词搜索档案。category 是自由文本筛选条件，会与拍品的部门名称匹配（例如“版画”“摄影”）。sale_type 为 "timed"（默认值）、"live" 或 "any"——请参阅下文的哪些数据公开，哪些不公开；这是这里最重要的参数。
• sothebys_lot_details(lot_id) — 获取单件拍品的完整图录详情，以 sothebys_results_search 结果中携带的 lot_id 为键。

工具名称特意加上了拍卖行前缀：三个艺术品拍卖行工具包（Bonhams、Sotheby's、Phillips）都提供相同的两种工具形态，因此单独使用 results_search 会彼此冲突，并导致 ask_pipeworx 路由出现歧义。

身份验证

无需密钥。两个上游服务都允许匿名调用；Algolia 搜索密钥由 Sotheby's 自有的公开 GraphQL 按需签发，并缓存 5 分钟。

数据来源

Sotheby's 的数据结构不同于 Bonhams。其拍品页面由 Next.js 应用提供，数据来自单独的 GraphQL 后端，因此没有可读取的服务器渲染搜索页面。两个公开的免密端点提供了所有数据，而且都不是 /bsp-api/*：

• https://clientapi.prod.sothelabs.com/graphql — Sotheby's 自有的公开竞拍 API。无需身份验证即可使用 POST。其 Cosmo Router 禁用了内省，但操作文档包含在网站自身的 JS 包中，路径为 /buy/_next/static/chunks/。使用了三个操作：
  • AlgoliaSearchKeyQuery → 获取下方索引的搜索密钥。不传筛选条件时，返回的密钥适用于整个索引，而非某场拍卖。
  • LotCardsQuery(id, lotIds, language) → auction.lotCardsFromIds，用于按拍卖批量查询价格。bidState.currentBidV2 是获胜（落槌）出价；bidState.sold.premiums.finalPriceV2 是含买家佣金的成交价。金额以十进制字符串形式返回。auction.testRecord 用于标记 Sotheby's 的 QA 拍卖，这些拍卖也在索引中。
  • lotV2(lotId, language, countryOfOrigin) → 获取完整图录详情。它返回 Lottable 接口，因此选择字段时需要使用 ... on LotV2 { … }；condition 是一个对象，而非字符串。
• https://KAR1UEUPJD-dsn.algolia.net/1/indexes/prod_lots/query — 网站自身查询的搜索索引（页面源码中的 window.ALGOLIA_APP_ID / window.ALGOLIA_INDEX_NAME）。这是唯一的跨拍卖搜索途径。它包含 creators、departments、估价、auctionType、auctionDate 和相对于网站的拍品 slug——但完全不含价格：每条记录的 price 都为 null，因此每次搜索都需要额外进行一次按拍卖发起的 GraphQL 往返请求。

这两个主机都不是 www.sothebys.com，因此 https://www.sothebys.com/robots.txt（检查日期：2026-09-05）中的 Crawl-delay: 15 和 Disallow: /bsp-api/* 不适用于它们；clientapi.prod.sothelabs.com 完全没有 robots.txt（404）。此工具包不会向 www.sothebys.com 发出任何请求——它只会生成供人点击的 www URL。

哪些内容是公开的，哪些不是

已成交价来自 GraphQL bidState.sold 联合类型，其值为 ResultVisible 或 ResultHidden，具体取决于 Sotheby's 是否通过该平台发布了这场拍卖的结果。根据 2026-09-05 对“Pablo Picasso”样本中 100 个搜索结果所涉及的 44 场不同拍卖的统计，区分规则非常明确，并非随机噪声：

范围	已公开结果的拍卖
auctionType: Live（拍卖厅拍卖），任何年份，包括 2025–26 年	11 场中 0 场
auctionType: Timed（线上拍卖），约从 2021 年起	18 场中 18 场，每件拍品皆如此
auctionType: Timed，约 2021 年以前	15 场中 0 场

因此，sale_type 默认为 timed：这是档案中确实存在已成交价的范围。即使是非常知名的拍品，查询 live 返回的也会是价格为 null 的结果——Sotheby's 会在自己的结果页面发布拍卖厅拍卖结果，而不会通过此 API 发布。工具会在 note 中说明这一点，而不是让人误以为解析失败。

阅读响应时有两点值得注意：

• sothebys_results_search 会扫描最多 100 条搜索结果，并返回其中有价格的子集，因此 count 通常远小于 scanned，而 total_hits（整个档案的匹配数）则远大于两者。
• 价格查询按拍卖时间从新到旧进行，而不是按相关性排序。搜索“Pablo Picasso”时，相关性很容易把 2019 年的拍卖排在前面，而这些结果只能回答“未公开”；输出顺序仍按相关性排列。

相关项目

• bonhams — 为 Bonhams 提供相同的双工具结构，其已成交价为普通的服务端渲染 HTML。
• Phillips 是本次调查中的第三家拍卖行；Christie's 已关闭（使用内部 API），不在范围之内。

快速开始

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

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

此端点实际提供的内容

https://gateway.pipeworx.io/sothebys/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+ 个数据源。唯一的区别在于直接列出的数据包工具；无论连接哪个 URL，ask_pipeworx 都能访问所有工具。

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

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

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

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

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

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

也可以直接运行，以确认服务能够启动：

npx -y @pipeworx/mcp-sothebys

它通过 stdin/stdout 使用 MCP 通信，并为仅此数据包的工具响应 initialize/tools/list/tools/call——不包含上述网关连接额外提供的共享元工具。数据来源和工具相同，但没有 ask_pipeworx 路由。

使用 ask_pipeworx

无需直接调用工具，你可以用通俗的英语提问—— 这在上方的 pack 端点和完整网关上都适用：

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

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT