Bonhams

@pipeworx/bonhams

Bonhamsの落札価格 — アーティストや作家で過去の「落札済み」ロットを検索し、落札価格、買い手プレミアム込みの落札価格（実際の落札価格）、予想価格帯、落札日、部門を取得できます。1件のロットについて、詳細（説明、状態、画像）を取得できます。

Pipeworxの一部です。AI エージェントを1875以上の稼働中データソースにつなぐMCPゲートウェイです。これは独立した非公式の連携であり、上流プロバイダーとは提携、承認、公開のいずれもしていません。

ツール

• bonhams_results_search(query, category?, page?, limit?) — Bonhamsの落札済みロットのアーカイブを、アーティスト／作家／キーワードで検索します。categoryは部門名に対して照合される自由入力のフィルターです（例：「jewellery」、「prints」、「books」）。
• bonhams_lot_details(auction_id, lot_no, slug?) — 1件のロットの詳細を取得します。bonhams_results_searchの結果に含まれるauction_id／lot_noをキーとして使用します。

認証

キー不要です。公開ページのため、ログインは必要ありません。

データソース

• https://www.bonhams.com/search/?chronology=past&query=<q>&page=<n> — サイト独自の過去ロット検索ページです。Next.jsアプリであり、結果セット全体を__NEXT_DATA__ JSON blob（pageProps.lotData.auctionLots[]）にサーバーサイドレンダリングします。通常のfetch()で実データを取得でき、別途XHR／API呼び出しは不要です。各エントリには、price.hammerPrice（プレミアム加算前）とprice.hammerPremium（買い手が実際に支払った落札価格。ページ上の「Sold for $X inc. premium」という表示と一致）、estimateLow／estimateHigh、department.name、hammerTime.datetime、auctionId、lotNo（{full, letter, number}形式で、fullがない場合もあります。その場合はnumberを使用します）が含まれます。
• https://www.bonhams.com/auction/<auctionId>/lot/<lotNo>/<slug>/ — ロット詳細ページです。同じSSRパターンで、より詳しいフィールドを含む"lot":{...}オブジェクトが1つあります。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: *に対するクロール遅延の指定はありません。

他の2つのオークションハウス（Sotheby's、Phillips）に関する調査メモ

Bonhamsは、実際の落札価格が制限のない通常のSSR HTMLで提供されており、確認できた中で最も扱いやすい形式だったため、最初にリリースしました。次に各社のパックを作成する人向けに、残る2社を簡単に調査したメモを記録します。

• Sotheby's — robots.txtではUser-agent: *にCrawl-delay: 15を設定し、/bsp-api/*（実際のAPIパス）とすべてのPDFエクスポートを拒否しています。検索結果ページは、robotsで明示的に拒否されている/bsp-api/を介したクライアントサイドのAPI呼び出しを実際に使用している可能性があります。完全にブロックされていると判断する前に、同じデータを提供する別の拒否対象外のエンドポイントがあるか確認する価値があります。
• Phillips — robots.txtでは/Search、/search、/SEARCH、/bin/、/phillips/otis、/*/filter/が拒否されています。キーワード検索で使われる一般的なパスは大文字小文字を区別せずブロックされています。一方、別の方法（サイトマップや部門別一覧など）でたどり着いたロット詳細ページは、引き続き利用できる可能性があります。このセッションでは調査していません。
• Christie's — ビルド計画により対象外です（非公開の社内API）。

Bonhamsでハウスごとのパックの形式が有効だと確認できたため、残る2社について後続の作業チケットを登録しました。**#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

標準入力／標準出力経由で MCP を処理し、このパックのツールだけを対象に initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使う

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

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

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

詳細

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

ライセンス

MIT