listingdata

listingdata

listingdata は、ホスト型の HasData Redfin MCP サーバーへの小規模なローカルブリッジです。Redfin の不動産データを JSON で返します。指定した場所の売出中、賃貸中、または売却済みの 物件を検索でき、Redfin の URL から物件を 1 件 詳しく取得できます。住所、売出価格と売却価格およびその履歴、 Redfin Estimate、ベッドルーム数とバスルーム数、面積と敷地、 築年、税金と学校のデータ、ページに掲載された担当エージェントの名前を取得します。

このブリッジ自体は物件データを保持しません。ライブ エンドポイントから取得した内容そのままのツール一覧をローカルで返し、各ツール呼び出しを上流に転送して、 返ってきた内容を変更せずに返します。取得したインターフェースは、公開物件データに対する読み取り専用の取得ツール 2 つです。 予約、購入申し込み、連絡先情報の抽出、 または支払いのツールは含まれていません。

ツール

• hasdata_redfin_listing_getRealEstateListings — Redfin の物件を検索します。必須項目：keyword（郵便番号、 市、近隣地域、学校、学区、 集合住宅名、または住所全体）と type（forSale、forRent、または sold）。任意の フィルターでは、価格と月々の支払いの範囲、 並べ替え、住宅の種類、ベッドルーム数とバスルーム数、 延床面積、敷地面積、築年、掲載カテゴリとステータス、 Redfin への掲載期間、住宅の設備、賃貸物件のアメニティと ペットに関する条件、学校の評価、徒歩／公共交通機関／自転車の スコア、およびページ送り用の page 番号を指定できます。住所または 建物を指定すると、一覧ではなく単一の物件カードが返されます。住所、Redfin URL、売出価格、 ベッドルーム数／バスルーム数、延床面積、築年、市場掲載日数、 ステータス、座標、写真、MLS 番号を含む物件情報を返します。
• hasdata_redfin_property_getPropertyDetails — 物件を 1 件詳しく取得します。必須項目：url（Redfin の物件 URL）。 住所、売出価格／売却価格、価格履歴、Redfin Estimate、ベッドルーム数／バスルーム数、 延床面積、敷地面積、築年、物件の種類、 HOA、市場掲載日数、学校の評価、税金の履歴、 担当エージェント、詳細な説明、写真、近隣の比較対象物件を返します。

設定

• HASDATA_REDFIN_MCP_URL（任意）— 上流エンドポイントを 上書きします。デフォルトは https://mcp.hasdata.com/mcp?apis=redfin です。（この 上書き用フックは、この再構築で独自にラベル付けした 再現仕様です。）
• HASDATA_API_KEY（任意）— 設定すると、すべての 上流リクエストに、呼び出し元自身の HasData API キーを使った x-api-key: <key> ヘッダーが付加されます。設定されていない場合、 キーヘッダーは送信されません。（ヘッダー名と環境変数名は、元の レジストリレコードで固定されています。この環境 変数からキーを転送する動作は、再構築で独自にラベル付けした仕様です。元の インターフェースはキーなしで取得されています。）

転送の仕組み

最初のツール呼び出し時に、クライアントは上流とのストリーミング可能な HTTP セッションを開きます。JSON-RPC の initialize リクエスト（protocolVersion 2025-03-26、clientInfo name listingdata）を送り、続いて notifications/initialized 通知を送信し、その後、呼び出し元の引数を変更せずに含む tools/call リクエストを送信します。上流が initialize への応答で Mcp-Session-Id ヘッダーを返す場合、その値はセッション中の 以後すべてのリクエストに付与され、プロセスの実行中は同じセッションが 再利用されます。応答は通常の JSON またはサーバー送信イベントで届く場合があり、どちらも読み取られます。

上流からの成功結果は、上流が設定した isError フラグも含めて、 そのまま返されます。失敗（JSON-RPC エラー、2xx 以外のステータス、 読み取り不能な応答、または完了できないリクエスト）は、 テキストが listingdata error: で始まる isError 結果として返されます （このエラー表現は、この再構築で独自にラベル付けした仕様です）。

CLI

各ツールは、1 つの JSON 引数文字列を受け取るサブコマンドとしても実行できます。

npx @reneturcios/listingdata hasdata_redfin_listing_getRealEstateListings '{"keyword":"Austin, TX","type":"forSale"}'
npx @reneturcios/listingdata hasdata_redfin_property_getPropertyDetails '{"url":"https://www.redfin.com/example"}'
npx @reneturcios/listingdata --version

終了コード：成功時は 0、isError の 結果の場合は 1、使用方法に誤りがある場合は 2 です。

MCP サーバー

npx -y @reneturcios/listingdata mcp

MCP クライアントの設定：

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

Docker

docker run -i ghcr.io/cloudcorprecords/listingdata
docker run --rm ghcr.io/cloudcorprecords/listingdata --version

コンテナのデフォルトコマンドは mcp なので、最初の形式は stdio MCP サーバーとして動作します。それ以外の引数は通常どおり CLI に渡されます。

開発

npm install
npm run build
npm test
npm run dev

テストスイートは、スタブ化された JSON-RPC アップストリームに対してのみ実行されます。実際のネットワークへの呼び出しはありません。

ライセンス

MIT — LICENSE を参照してください。