Sothebys

@pipeworx/sothebys

Sotheby's の落札価格 — あらゆるセールを横断してアーティストまたは作家で過去のロットアーカイブを検索し、買い手手数料込みの価格、落札（ハンマー）価格、予想価格の範囲、セール名・日付・場所を取得できます。また、1件のロットについて、カタログの詳細情報（説明、来歴、文献、展覧会履歴、画像）を取得できます。

Pipeworx の一部です — AI エージェントを1683以上の稼働中データソースに接続するMCPゲートウェイです。

ツール

• sothebys_results_search(query, category?, sale_type?, page?, limit?, include_unpriced?) — アーティスト／作家／キーワードでアーカイブを検索します。category は、ロットの部門名（例：「版画」、「写真」）に対して照合される自由記述のフィルターです。sale_type は "timed"（デフォルト）、"live"、"any" のいずれかです — 以下の 公開情報と非公開情報 を参照してください。このツールで最も重要な引数です。
• sothebys_lot_details(lot_id) — 1件のロットのカタログ詳細情報です。sothebys_results_search の結果に含まれる lot_id をキーとして使います。

ツール名にオークションハウス名を意図的に付けています。Bonhams、Sotheby's、Phillips の3つのアートハウス向けパックは同じ2種類のツールを公開しているため、results_search だけでは名前が衝突し、ask_pipeworx によるルーティングが曖昧になります。

認証

認証キーは不要です。どちらの上流サービスも匿名の呼び出しに対応しています。Algolia の検索キーは、Sotheby's 独自の公開 GraphQL からオンデマンドで発行され、5分間キャッシュされます。

データソース

Sotheby's は Bonhams とは異なる構成です。ロットページは別の GraphQL バックエンドからデータを取得する Next.js アプリのため、読み取れるサーバー側レンダリングの検索ページはありません。すべての情報は、キー不要の2つの公開エンドポイントで取得でき、どちらも /bsp-api/* ではありません。

• https://clientapi.prod.sothelabs.com/graphql — Sotheby's 独自の公開入札APIです。認証なしの POST が動作します。Cosmo Router でイントロスペクションは無効になっていますが、オペレーションのドキュメントはサイト独自のJSバンドル（/buy/_next/static/chunks/ 以下）に含まれています。以下の3つのオペレーションを使います。
  • AlgoliaSearchKeyQuery → 以下のインデックス用の検索キーを取得します。フィルターを指定せずにリクエストすると、特定のオークションではなく、インデックス全体を対象にするキーが得られます。
  • LotCardsQuery(id, lotIds, language) → auction.lotCardsFromIds。オークションごとの一括価格照会です。bidState.currentBidV2 は落札（ハンマー）価格、bidState.sold.premiums.finalPriceV2 は買い手手数料込みの落札価格です。金額は10進数の文字列として返されます。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リクエストがもう1回必要になります。

どちらのホストも 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 ユニオンから取得します。この値は、Sotheby's がこのプラットフォームを通じてそのセールの結果を公開しているかどうかに応じて、ResultVisible または ResultHidden のいずれかになります。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 で伝えます。

応答を確認する際には、次の2点に注意してください。

• sothebys_results_search は最大100件の検索結果が含まれるページを調べ、価格があるものだけを返します。そのため、通常 count は scanned を大きく下回り、アーカイブ全体での一致件数である total_hits は、そのどちらよりもはるかに大きくなります。
• 価格の検索は、関連度順ではなく、新しいセールから順に行われます。「Pablo Picasso」では関連度によって2019年のセールが上位に表示されることがありますが、これらは「非公開」という結果しか返せません。それでも、出力の順序は関連度順のままです。

関連項目

• bonhams — Bonhams 向けの、同じ2ツール構成です。落札価格は通常のサーバー生成 HTML で公開されています。
• この調査の3社目は 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以上のデータソースに接続します。異なるのは、どのパックのツールが直接表示されるかだけです。どちらからでも 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":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を呼び出します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの 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 での使用

ツールを直接呼び出す代わりに、平易な英語で質問できます。 これは、上記のパックエンドポイントだけでなく、フルゲートウェイでも機能します。

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

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT