redfin-mcp

redfin-mcp

Claude 向けの MCP サーバーとして Redfin の不動産情報にアクセスできます。自然言語で物件を検索し、物件の詳細や市場レポート、保存済みの住宅や検索条件を取得できます。

⚠️ Redfin は一般消費者向けの公開 API を提供していません。このサーバーは、redfin.com のウェブアプリが使用する同じ非公開の /stingray/... エンドポイントを、ContextMint Bridge 拡張機能（fetchproxy によって動作）を介して、サインイン済みのご自身のブラウザータブ経由で利用します。すべてのリクエストは既存のセッションを通じて実行されます。つまり、ご自身の Cookie、TLS、JS コンテキストが使われ、ブラウザーでご自身がクリックした場合とまったく同じです。これは Redfin のウェブサイトを非公式に利用するものとして扱ってください。ご自身の判断でご利用ください。

ツール

ツール	用途	認証スコープ
redfin_search_properties	場所、価格帯、ベッドルーム数／バスルーム数、住宅タイプで物件を検索します。Redfin のオートコンプリートでフリーテキストを解決してから、gis API にクエリを送信します。任意の bounds を指定すると、描画した地図上の範囲を検索します。
redfin_sweep_area	緯度／経度で指定した範囲を網羅的に列挙します。gis の上限である350件に達するタイルがなくなるまで、ポリゴンを再帰的に分割し、重複を除去してローカルでフィルタリングし、完全性の概要とデータのずれに関する警告を表示します。zips モードでは、代わりにZIP地域のリストを検索します（Redfin が描画した地図のポリゴンを無視する地域向け）。物件情報はインラインで返されます。任意の output_path を指定すると、REDFIN_OUTPUT_DIR 内（デフォルトは ~/Downloads/redfin-mcp）に新しい .json ファイルとして書き出します（既存ファイルは上書きしません）。
redfin_get_property	URL、property_id 単独、または property_id と listing_id を指定して、物件の全レコードを取得します。住所、ベッドルーム数／バスルーム数、平方フィート、築年、価格、ステータス、市場掲載日数、メイン写真が含まれます。
redfin_get_property_photos	物件の写真ギャラリー全体を取得します。フルスクリーン／大／中サイズの CDN 画像すべてに加え、サムネイルとキャプションも含まれます。
redfin_get_market_report	地域の販売価格／掲載価格の中央値、ZHVI の前年比、平均市場掲載日数、在庫数を取得します。
redfin_get_price_history	物件の掲載履歴と固定資産税記録のイベントを取得します。掲載済み／売却済み／保留中のエントリーに加え、年間評価額と納税額が含まれます。
redfin_compare_properties	2～25件の物件を並べて比較します。住所、価格、ベッドルーム数／バスルーム数、平方フィート、平方フィートあたりの価格、築年、ステータス、市場掲載日数を表示します。任意で、項目をそろえた概要テーブルも表示できます。
redfin_bulk_get	1回の呼び出しで最大200件の物件情報を構造化して取得します。行ごとのエラー、タイムアウト時の1回の再試行、全体の期限に対応し、処理が完了していない行は pending として返されます。
redfin_get_climate_risk	物件の First Street Foundation による洪水／火災／暑熱リスク要因を取得します。FEMA ゾーン、30年間の洪水発生確率の推移、保険料の範囲、累積暑熱の予測が含まれます。
redfin_get_climate_risk_bulk	1回の呼び出しで最大100件の物件の気候リスクを取得します。入力順を保持し、スコアが共通する物件の cluster_summary を返します。
redfin_get_area_climate_baseline	地域内の2～10件のサンプル物件から、平均的な気候リスクの基準値を取得します。サンプル間で一致する場合は、共通の cluster_id も返します。
redfin_get_comparable_rentals	物件周辺の比較対象となる賃貸物件を取得します。月額家賃、ベッドルーム数／バスルーム数、平方フィート、距離が含まれます。家賃の推定に使用します。
redfin_calculate_affordability	ローカルで動作する住宅購入可能額の計算ツールです。収入、DTI、金利から購入可能な価格の概算を算出します（ネットワーク接続不要）。
redfin_get_saved_homes	お気に入りに登録した住宅を、すべてのコレクションをまとめて取得します。各住宅の CDN ハンドルからメイン写真の URL を構築します。	✓
redfin_get_saved_searches	保存した検索条件を、地域の URL と表示テキストとともに取得します。	✓
redfin_calculate_mortgage	ローカルで動作する PITI 計算ツールです。元金と利息、税金、保険、HOA、PMI を計算します（ネットワーク接続不要）。
redfin_get_by_address	フリーテキストの住所を Redfin の正規 URL と home_id に解決します。一致する掲載物件がない場合は resolved: false を返します。オートコンプリート、語尾のバリエーション、範囲を限定した検索の順に試します。
redfin_resolve_addresses	最大100件の住所を Redfin の URL と home_id に一括で解決し、入力ごとに1行を返します。
redfin_healthcheck	エンドツーエンドのブリッジ接続確認を行います。/robots.txt への往復通信を実施し、失敗した箇所（ブリッジ停止、拡張機能が未リンク／ペアリングコード待ち、または Redfin 側の問題）と、拡張機能のリンク状態（bridge.session_state、pending_pair_code、extension_connected）を報告します。他のツールがタイムアウトした場合に呼び出してください。
redfin_register_session / redfin_set_active_session / redfin_get_session_context	共有セッションレジストリです。ブリッジ経由のタブでログインしている Redfin アカウントを記録し、登録済みセッションを切り替えて、アクティブなセッションを表示します（ローカルで動作し、ネットワーク接続不要）。

利用規約の確認

この MCP サーバーを使用することで、以下の内容を確認し、同意したものとみなされます。

1. このサーバーは、お客様自身の Redfin セッションにアクセスします。 すべてのリクエストは、ContextMint Bridge 拡張機能を介して、お客様自身のブラウザータブ経由で送信されます。お客様の Cookie、お客様の TLS、お客様のセッションを使用します。他のユーザーのアカウントにアクセスすることはなく、アクセスすることもできません。

2. このサーバーの使用には、Redfin の利用規約が適用されます。 redfin.com を直接利用する場合と同様です。ここで特に関連する条項を示します。

該当する Redfin 企業から事前に明示的な書面による許可を得ていない限り、いかなる目的またはいかなる手段によっても、サービスを自動的にクロールまたはクエリすることはできません（これには、サービスから情報を取得する目的で行う画面およびデータベースのスクレイピング、スパイダー、ロボット、クローラー、その他あらゆる自動化された活動が含まれますが、これらに限定されません）。

また、次のように定められています。「お客様は、パスワードの機密を保持し、他者のアカウントを使用せず、他者にお客様のアカウントを使用させないことに同意するものとします。」

このサーバーのツールを呼び出すたびに、管理者が2026-05-23に確認したこれらの規約に同意することになります。Redfin の規約では、書面による許可のない自動クロールが禁止されており、IDX の掲載データは個人的かつ非営利の利用に限ってライセンスされています。

3. 個人的かつ非営利の利用に限ります。 このプロジェクトは、Redfin Corporation と提携、承認、後援、または協力関係にありません。これは、redfin.com で操作するときに呼び出されるものと同じ /stingray/... エンドポイントを呼び出す、個人向けの自動化ツールです。掲載情報の一括抽出、IDX データの再配布、AI モデルのトレーニング、競合する不動産サービスへのデータ登録、または営利目的で使用しないでください。

4. 安定性は保証されません。 このサーバーは、Redfin が予告なく変更する可能性のある非公開の内部エンドポイント（/stingray/api/gis、/stingray/api/home/details/*、/stingray/api/region/.../market-trends、/myredfin/*）を読み取ります。動作しなくなることがあります。停止することもあります。これは意図どおりです。このインターフェースは、Redfin がこちらに代わって保守するものではありません。

5. このサーバーを Redfin へのアクセスに関連して使用したことで生じる結果については、お客様が全責任を負います。 レート制限、アカウントの一時停止、IP ブロック、AWS WAF のチャレンジ、または Redfin が実施するあらゆる措置が含まれます。Redfin からお客様の使用について異議を申し立てられた場合は、このサーバーの使用を中止してください。

このセクションは、管理者が誠意をもって利用規約を要約したものであり、法律上の助言ではありません。また、Redfin の実際の ToU を変更または置き換えるものではありません。

インストール

オプション A — npx（初回公開後）

.mcp.json に追加します。

{
  "mcpServers": {
    "redfin": {
      "command": "npx",
      "args": ["-y", "redfin-mcp"]
    }
  }
}

オプション B — ソースから

git clone https://github.com/chrischall/redfin-mcp
cd redfin-mcp
npm install
npm run build

{
  "mcpServers": {
    "redfin": {
      "command": "node",
      "args": ["/path/to/redfin-mcp/dist/bundle.js"]
    }
  }
}

初回のみのブラウザー設定

redfin-mcp は、ContextMint Bridge 拡張機能を介してブラウザーと通信します。この拡張機能は、fetchproxy ベースのすべての MCP（zillow-mcp、opentable-mcp、resy-mcp など）で共通です。ContextMint Bridge のリリースから一度だけインストールしてください。

• Chrome： Chrome 用の zip をダウンロードして解凍し、chrome://extensions → デベロッパーモードを切り替え → 解凍した拡張機能を読み込む → 解凍したフォルダーを選択します。
• Safari： 現在は利用できません。一般公開されていない ContextMint アプリに同梱される予定です。現時点では Chrome を使用してください。

ContextMint Bridge は、同じ管理者による fetchproxy ブラウザー拡張機能の新しい名称です。fetchproxy の README（fetchproxy#extension）からもリンクされています。ソースは nullnet-app/contextmint-bridge で公開されています。ご自身でビルドするか、リリース zip を同梱の .sha256 ファイルで確認してください（shasum -a 256 -c contextmint-bridge-chrome-<version>.zip.sha256）。

redfin.com を開いてサインインしてください。このサーバーで必要な認証はこれだけです。

仕組み

┌────────────────┐  stdio   ┌──────────────────┐   WS   ┌──────────────────┐    fetch()    ┌─────────────┐
│ MCP client     │◀────────▶│  dist/bundle.js  │◀──────▶│  ContextMint     │◀────────────▶│ redfin.com  │
│ (Claude, etc.) │          │  (Redfin MCP)    │ :37149 │  Bridge          │   (real TLS, │ (your tab)  │
└────────────────┘          └──────────────────┘        │  (separate)      │   cookies)    └─────────────┘

MCP サーバーは Node 上で実行されますが、redfin.com へのすべての HTTP 呼び出しは、ContextMint Bridge 拡張機能を通じて、現在開いているブラウザータブに送られます。各リクエストには既存のセッションが使われるため、TLS フィンガープリント、Cookie、JS 実行コンテキストは、すでに画面に表示されているページと一致します。ヘッドレスブラウザーによる代替、別個の ID、サードパーティーのプロキシは不要です。実際のブラウザーが自らの権限で動作し、MCP サーバーがリクエスト内容を選びます。

Redfin の /stingray/... JSON エンドポイントは、JSON 本文の前に {}&& という CSRF 対策用プレフィックスを返します。クライアントがこれを透過的に削除します。

コマンド

npm test               # vitest, mocked transport, no network
npm run test:watch
npm run test:coverage
npm run build          # tsc --noEmit + esbuild bundle → dist/bundle.js
npm run dev            # node dist/bundle.js (after build)

ライセンス

MIT