Estatesales Net

@pipeworx/estatesales-net

米国の郵便番号を指定すると、その近隣で開催予定の EstateSales.NET（米国最大の遺品整理セール掲載サイト）の遺品整理セール、引っ越しセール、遺品オークションと、開催会社を取得できます。

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

ツール

• estatesales_search(postal_code) — 郵便番号の近隣で開催予定のセール：セール ID、種類、市・州・郵便番号、座標、距離、開催スケジュール、開始日と終了日。
• estatesales_sale(sale_id) — セール 1 件の詳細：名称、説明、規約、予定されているすべての日程、座標、写真の数、開催会社の電話番号とページ。住所は、サイトで公開された後に限り取得できます（下記参照）。
• estatesales_companies(postal_code) — 指定した郵便番号で営業する遺品整理セール事業者：名称、事業所住所、電話番号、座標、掲載ランク。

認証

キー不要です。アカウント、トークン、登録は必要ありません。

公式の EstateSales.NET API は別物であり、ここでは利用できません

EstateSales.NET はドキュメントが公開されたベータ版 REST API を提供しています （https://github.com/vintage-software/EstateSales.NET-Api）。このパックでその API を使うべきだと思われるかもしれませんが、使うべきではありません。この API は販売者側専用であり、すべてのエンドポイントが自社の OrgId に限定されています。

GET    /api/public-sales/org/{OrgId}      your org's sales
GET    /api/public-sales/{saleId}         403 without your org's token
POST   /api/public-sales/                 create a sale
PUT    /api/public-sales/{saleId}         edit a sale
POST   /api/public-sales/{saleId}/publish
POST   /api/sale-dates/ · /api/sale-pictures/

この API は、遺品整理セール運営会社が自社のセールを掲載するためのものです。検索エンドポイントは一切なく、API キーは遺品整理セール運営会社のアカウント（/account/company/api-keys）から発行されます。キーを取得しても、自社の空の組織のデータしか返りません。購入希望者の質問には答えられないため、PLATFORM_ESTATESALES_KEY は存在せず、仮にあっても役に立ちません。

このパックが読み取るのは、代わりにサイトが購入希望者向けに公開しているデータです。認証情報なしで、ウェブサイト自体が描画に使用している構造化 JSON を読み取ります。

住所は提供元によって公開制限されており、このパックはそれを遵守します

遺品整理セールは通常、個人宅で開催されるため、EstateSales.NET はセール直前まで住所を公開しません（showAddress、utcShowAddressAfter、showAddressType）。estatesales_sale はサイトですでに公開されている場合に限り住所を返します。それ以外の場合は address_published: false、住所の公開時刻を address_visible_after_utc に返し、注記を添えます。座標と市・郵便番号は、サイトが最初から公開しているため、常に取得できます。

この公開制限を回避しないでください。これは誰かの自宅に関する公開元の判断であり、技術上の制約ではありません。

価格情報なし

EstateSales.NET が掲載するのは開催予定のセールです。ハンマー価格や成約データは公開していないため、この情報は比較対象になりません。すべてのレスポンスで、price_data フィールドにその旨を記載しています。

データソース

• https://www.estatesales.net/{ST}/{City}/{ZIP} — 市区のセール一覧。
• https://www.estatesales.net/{ST}/{City}/{ZIP}/{saleId} — セールの詳細。
• https://www.estatesales.net/companies/{ST}/{City}/{ZIP} — 会社一覧。

再確認する手間を省くためのポイント：

• ページのデータはマークアップではなく JSON として格納されています。 各ページには、id="estatesales-net-state"、type="application/json" の script タグがあり、Angular の転送状態である {"NGRX_STATE": …} が格納されています。セールは feature.cityViewState.filteredSales、個別のセールは feature.traditionalSaleViewState.entitiesById[saleId]、会社は feature.companiesCityViewState.companies にあります。script タグの id を基準にしてください。 type="application/json" だけで照合すると、分析用ブロックにも一致してしまいます。
• サイトは独自のロケーション URL を正規化するため、ここにあるツールでは ZIP またはセール ID だけで十分です。 /XX/x/64111 は /MO/Kansas-City/64111 にリダイレクトされ、/XX/x/00000/{saleId} はセールの実際のパスにリダイレクトされます。市区のスラッグを手動で組み立てないでください。
• 市区ページには、セールの実数にかかわらず 20 件が表示されます。 filteredSaleCount と totalSaleCount は実際の件数を示します（例：64111 の場合、 表示 20 件、フィルター後 61 件、合計 97 件）。ページ番号のパラメーターはありません。残りはサイトがクライアント側で読み込みます。20 件が全件であるかのように示さず、件数を報告してください。
• 日付は {"_type":"DateTime","_value":"…"} にラップされて届きます。このパックでは ISO 文字列に変換しています。
• GET /api/sales/{id} は公開されており、キーは不要ですが、返されるのは事務情報（組織 ID、種別、タイムスタンプ）のみで、住所、日付、説明、写真は含まれません。ページの状態にはこれらすべてが含まれるため、このパックではページの状態を使用しています。GET /api/public-sales/{id}（公式 API のパス）は、販売者トークンがないと 403 を返します。
• /api/sales?postalCodeNumber=… は HTTP 400 の "Permissions denied on filter" を返します。このフィルターは公開されていません。このエラーはエンドポイントが存在することを意味し、サイトがダウンしているという意味ではありません。

クイックスタート

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

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

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

https://gateway.pipeworx.io/estatesales-net/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 も同じゲートウェイと同じ 1879+ 個のデータソースに接続します。異なるのは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも、ask_pipeworx を使ってすべてのツールにアクセスできます。

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

curl -X POST https://gateway.pipeworx.io/v1/tools/estatesales_search \
  -H 'Content-Type: application/json' \
  -d '{"postal_code":"64111"}'

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

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

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

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

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

npx -y @pipeworx/mcp-estatesales-net

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

ask_pipeworx の使用

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

ask_pipeworx({ question: "your question about Estatesales Net data" })

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

詳細

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

ライセンス

MIT