Phillips

@pipeworx/phillips

Phillipsの落札価格 — アーティストや作家を検索し、実際に支払われた価格（落札価格と買い手手数料の合計）、落札時の推定価格帯、通貨、ロット番号とセール番号、セール会場、部門、セール日を含む最近の過去ロットを取得できます。個別のロットの詳細もすべて取得できます。

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

ツール

• phillips_results_search(artist?, artist_id?, category?, include_upcoming?, limit?) — 1人の作家の落札価格を取得します。Phillips独自のアーティストインデックスで名前を解決し、その作家のページを読み込みます。category は部門、セール会場、セール番号、ロットタイトルに照合する自由記述のフィルターです（例： 「jewels」、「watches」、「editions」、「photographs」、「design」、「London」）。名前解決を完全に省略するには、以前の結果から artist_id を渡します。
• phillips_lot_details(lot_id, slug?) — 1つのロットの詳細をすべて取得します。phillips_results_search の結果に含まれる lot_id をキーにします。落札価格（手数料加算前）とセール名全体を追加します。

ツール名にハウス名のプレフィックスを付けているのは意図的です。Bonhamsでは最初にプレフィックスなしの results_search／lot_details が提供されましたが、3つのオークションハウスが稼働する現在、この2つの名前はパック間で衝突し、 ask_pipeworx のルーティングで判別できなくなります。新しいハウスのパックでも {house}_ プレフィックスを付けてください。

認証

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

データソース

Phillipsのキーワード検索はクローラーに公開されていません — robots.txt（2026-09-05に確認）では /Search、/search、/SEARCH のすべてが拒否されているため、明白なパスの大文字・小文字3種類はいずれも使用できません。また、/bin/、/phillips/otis、/*/filter/ も拒否されています。そのため、このパックでは検索を行わず、robots.txtで許可されている次の3つのパスを通じて作家を検索します。

• https://www.phillips.com/sitemap.xml — /artist/{makerId}/{name} のURLが13,031件あります。アーティスト名から makerId へのインデックスで、名前の解決に使います。各分離環境につき、取得は最大1回です。名前はパーセントエンコードされ、さらにHTMLエスケープされています（Jennifer%20&%20Kevin%20McCoy）。使用する前に両方のエンコードを解除してください。解除しないと、組み立てたURLが二重エンコードされ、404になります。
• https://www.phillips.com/artist/{makerId}/{slug} — アーティストのランディングページです。落札価格はここでサーバー側レンダリングされ、同じ行が React.createElement(PhillipsReact.ArtistLanding, {...}) のハイドレーション用プロパティ内にもJSONで含まれています。maker プロパティは、pastLots {currentPage, totalPages, totalCount, resultsPerPage, data[]} を保持するJSON 文字列 です。各行には hammerPlusBP（落札価格）、lowEstimate、highEstimate、currencySign、saleNumber、lotNumber、objectNumber（ロットID）、auctionStartDateTimeOffset が含まれます。落札されなかったロットでは hammerPlusBP が 0 になります。これは価格が0という意味ではなく、価格が存在しないことを示します。
• https://www.phillips.com/detail/{slug}/{objectNumber} — ロットのページです。

/artist/ と /detail/ のURLにある {slug} の部分は装飾的なもので、空でない値であればどれでも同じレコードが返されます。読み取られるのは数値IDのみです。

カバレッジの上限とその理由

アーティストページで提供される過去ロットは1ページ分、24行のみです。2ページ目以降はブラウザーが別のホスト（api.phillips.com）から取得します。また、HTMLページ自体をページ送りするクエリパラメーターはありません（?page=2、?p=2、?pastLotsPage=2 をそれぞれ試しましたが、いずれも1ページ目が返されました）。そのため、phillips_results_search は直近24件の過去ロットを返し、同時に total_past_lots も報告します。これにより、呼び出し元はアーカイブのうち取得できていない量を確認できます。Banksyは272件中24件、Patek Philippeは3,728件中24件が返されます。

ロットページの読み取り

ロットページはサイトの他の部分とは異なるスタック（Remix）を使用しており、状態データの blob はキーと値を順に並べたフラットな配列で、アドレス指定可能なオブジェクトではありません。そのため、このパックでは3か所からデータを読み取り、レンダリング済み HTML を優先します。

• JSON-LD Product — タイトル、メーカー、画像、通貨、落札済み／未落札。offers.price は下限見積額であり、実際の落札価格ではありません。落札価格として扱わないでください。
• レンダリング済み HTML — Sold For {cur}{amount} と Estimate {cur}{low}–{high}。見積額は必ずここから取得してください。状態データの blob にある lowEstimate／highEstimate のペアは、ページの通貨換算テーブルに属するものだけです。その値を読み取ると、もっともらしく見えても通貨が間違った数字（実際の見積額が £60,000–80,000 のロットで HK$622,000–830,000）が返されます。
• 状態データの blob — ほかの場所にはない2つのフィールド、hammerPrice と auctionStartDateTime。フラット化された配列ではキーと値が隣接しているとは限らないため、ハンマー価格が実際の落札価格を上回る場合は返さずに破棄します。

セール番号には部門と競売場が含まれます

セール番号は {2-letter saleroom}{2-digit department}{2-digit sequence}{2-digit year} です。UK010526 はロンドン、部門 01、セール 05、2026年を表します。以下の部門対応表は、/auctions/past に掲載された過去のオークション892件（2026-09-05）から導き出され、一致を確認したものです。01 はモダン＆コンテンポラリーアート、03 は版画および紙作品、04 は写真、05 はデザイン、06 は宝飾品、07 は版画・写真・デザイン、08 は時計です。00 と 09 は部門ではなく、複数の部門にまたがるセール形式（特別／コラボレーション、およびオンライン）なので、推測せずにそのように分類しています。確認された競売場は、NY ニューヨーク、UK ロンドン、HK 香港、CH／GE ジュネーブです。

関連パック

@pipeworx/bonhams と @pipeworx/sothebys は、ほかの2つのオークション会社について同じ情報を提供します。Christie's は対象外です（閉鎖済み、内部 API）。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

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

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/phillips/mcp の tools/list は、上記の表にあるツールに加えて、共通の Pipeworx メタツール — ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で利用できるツール一式 — を返します。そのため、表示されるツール数はこの表の数より多くなります。現在、単一パックのエンドポイントには、パック固有のツールとあわせておよそ30個の共通ツールが一覧表示されます。接続の initialize 応答には正確な範囲が示されており、その日の状況を確認するうえでの正式な情報源です。

これは意図された動作であり、偶然の多重化ではありません。このパックが対応していない質問にも、カタログ全体を横断してルーティングする ask_pipeworx を通じて答えられるようにするのが、メタツールの役割です。MCP サーバーをもう1つ追加する必要はありません。現在、これらのメタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、フル Pipeworx ゲートウェイに接続すると、このパックのツールだけでなく、すべてのパックのツールが直接一覧表示されます。

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

どちらの URL も同じゲートウェイと同じ1683以上のデータソースに接続します。唯一の違いは、どのパックのツールが直接一覧表示されるかです。どちらからでも ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントがない場合は、HTTP で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/phillips_results_search \
  -H 'Content-Type: application/json' \
  -d '{"artist":"Banksy","limit":5}'

最初の呼び出しにアカウントは不要です。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/phillips_results_search を実行します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

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

このパッケージはローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイとの往復通信も不要です。

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

または、直接実行して起動を確認できます。

npx -y @pipeworx/mcp-phillips

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

ask_pipeworx を使用する

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

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

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

詳細

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

ライセンス

MIT