Us Auctions

@pipeworx/us-auctions

市場の両方の側面を網羅する、米国のオークション出品情報をリアルタイムで取得します。約1,900の商用オークションハウスと、アクセス可能なすべての政府余剰品、差し押さえ品、税金滞納による不動産の情報を、キーワード、州、ZIPコードからの距離で検索できます。また、出品終了時にオークションサイトが削除する落札価格も取得できます。

Pipeworxの一部です。AI エージェントを1808以上のライブデータソースにつなぐMCPゲートウェイです。これは独立した非公式の統合であり、上流プロバイダーとは提携しておらず、推奨や公開も受けていません。

ツール

• us_auctions_search(keyword?, state?, asset_type?, segment?, source?, auction_house?, near_zip?, radius_miles?, max_price?, closing_within_hours?, limit?) — 一般的な出品検索です。near_zipを指定すると、各行にdistance_milesが含まれ、距離順に結果が返されます。
• us_auctions_closing_soon(...) — 同じ出品データを終了時刻が早い順に並べ、hours_remainingを付けて返します。「まだ入札できる出品は何か」を調べられます。
• us_auction_events(state?, keyword?, auction_house?, closes_after?, closes_before?, min_lots?, limit?) — 個々の出品ではなく、オークション開催情報を返します。「来週、近くでどのオークションが開催されるか」を調べられます。
• us_auction_houses(state?, keyword?, limit?) — 対応している競売業者と、それぞれの出品数を件数順に表示します。取得した名称を上記2つのツールに渡せます。
• us_auctions_sold_comps(keyword?, asset_type?, state?, segment?, limit?) — 成約価格の最小値、中央値、平均値、最大値と最近の事例を返します。この機能が特長です。
• us_auctions_coverage() — ソースごとの件数、開催中のオークション数、保持している成約価格情報、ソースごとの最終更新時刻を返します。

認証

呼び出し元での認証は不要です。ゲートウェイが各呼び出しでパックのデータ認証情報を注入します。 パック自体はステートレスで、シークレットを保持しません。

隣接するパックとの関係

• gov-auctions — 同じストアをsegment='government'で絞り込んだものです。対象範囲を絞った契約のもとでnpmとMCP Registryに公開されているため、別のパックとして維持しています。余剰のピックアップトラックを探す呼び出し元に、遺品整理セールの骨董品が表示されてはなりません。
• gsa-auctions — GSAの連邦政府余剰品を扱うライブAPIです。DBを基盤としていないため、その出品情報はこのストアには含まれず、ここには表示されません。

データソース

workers/auction-scraperによって取り込まれます（ソースごとに1つのアダプターを使用し、cronの実行をまたいでカーソルを引き継ぎます）。ソースごとの注意点については、そのワーカーを参照してください。

• hibid — 商用。GraphQLを使用し、認証は不要です。米国内の約1,900のオークションハウスに対応しています。
• govdeals、allsurplus — 州・地方自治体および企業の余剰品です。allsurplusはgovliquidation.comとgo-dove.comも対象にしています。これらは異なるドメインで提供される同一のカタログです。これらのためにアダプターを構築しないでください。
• publicsurplus、bid4assets、irs、txauction — 政府関連の残りのソースです。

次の人が、苦労して再発見せずに済むように

• このプロジェクトでは、集計関数とgroup=は無効です（PGRST123）。 count()はありません。正確な件数はPrefer: count=exactと Content-Rangeの末尾から取得します。us_auction_housesの日別集計は データベースではなく、上限を設けた行の取得をもとにパック側で計算します。
• not.is.nullではなく、必ずfinal_price > 0を使ってください。 終了処理のスイープでは、最後に確認された入札額をfinal_priceに固定します。入札がなかった商業ロットはゼロに固定されます。 これらを類似事例として数えると、レスポンスの形式はまったく問題ないように見えるまま、中央値がすべて$0に引き寄せられます。
• イベントの日付は、瞬間ではなく現地の暦日です。 closes_on / starts_onは日付です。HiBidはタイムゾーンなしで販売時刻を公開するためです。 ロット単位のcloses_atは実際の時刻です（カウントダウンから導出）。そのため、 closing_within_hoursはロットを基準にし、us_auction_eventsは日付を基準にします。 現地時刻の文字列を解析して「修正」しないでください。西海岸の夕方の販売が翌日にずれてしまいます。
• フィルターなしの検索は2つのクエリで行い、1つのor=にはしません。 closes_at >= now()とcloses_at IS NULLをORで結合しながらcloses_atで並べ替えると、インデックスでは処理できません。最も単純な呼び出しでもアクティブなデータ全体をスキャンし、8sのステートメントタイムアウトを超えて、ハード500エラーと何も返さないままの空結果を交互に引き起こしました。分割しても、返される行と順序は同じです。
• 座標は郵便番号の重心です。 多くの情報源が公開するのは郵便番号までで、それより細かい位置情報はありません。そのため、ロットの位置は町の位置になります。distance_milesは町単位です。レスポンスにもその旨が記載されており、今後も記載し続ける必要があります。
• キーワード検索は、まず全文検索を行い、次に部分文字列検索を行います。 search_tsv（マイグレーション092で追加された重み付け済みの保存列）は語幹処理を行い、説明文も検索対象にします。トライグラムによるILIKE検索は、全文検索で何も見つからなかった場合にのみ実行します。オークションのタイトルには、tsqueryでは単語内を検索できない部分的な型番が多く含まれるためです。

クイックスタート

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

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

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

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

これは意図的な仕様であり、誤って多重化しているわけではありません。メタツールを使えば、このパックの対象外の質問にも、カタログ全体を検索するask_pipeworx経由で回答できます。そのため、2つ目のMCPサーバーを追加する必要はありません。現在、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利便性に見合わない場合は、複数のパックエンドポイントに接続するのではなく、フルゲートウェイに一度だけ接続してください。

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

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

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

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

curl -X POST https://gateway.pipeworx.io/v1/tools/us_auctions_search \
  -H 'Content-Type: application/json' \
  -d '{"keyword":"forklift","limit":10}'

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

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

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

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

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

npx -y @pipeworx/mcp-us-auctions

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

ask_pipeworx を使用する

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

ask_pipeworx({ question: "your question about Us Auctions data" })

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

詳細

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

ライセンス

MIT