zillow-mcp

zillow-mcp

Claude 向けに、不動産情報にアクセスできる MCP サーバーとして Zillow を利用できます。自然言語で物件を検索し、物件の詳細、Zestimate の履歴、保存した検索条件や住宅、マーケットレポートを取得できます。

⚠️ Zillow は一般消費者向けの公開 API を提供していません。公式の Bridge API は MLS パートナーに限定されています。このサーバーは、ブラウザー拡張機能 ContextMint Bridge を介して、ログイン済みのブラウザータブから zillow.com のウェブアプリと同じ非公開エンドポイントを利用します。すべてのリクエストは、既存のセッション（Cookie、TLS、JavaScript コンテキスト）を通じて実行されます。まるでブラウザーでご自身がクリックしたかのように動作します。Zillow のウェブサイトの非公式な利用として扱ってください。ご自身の判断でご利用ください。

このプロジェクトの目的

既存の Zillow MCP は 4 つありますが、いずれも次の 2 つの基盤のどちらかを利用しています。

• Bridge API — MLS への加入、IDX ベンダーとの関係、または「承認済みテクノロジーパートナーシップ」が必要です（承認まで 10 営業日以上）。一般消費者は利用できません。
• 有料スクレイパー（RapidAPI、Apify）— 信頼の経路に第三者が加わり、利用がレート制限されます。

どちらもセッション外で動作するため、ご自身が保存、お気に入り登録、または最近閲覧した情報は確認できません。zillow-mcp は、すでにログインしている zillow.com のタブを利用します。

ツール

ツール	用途	認証スコープ
zillow_search_properties	場所、ステータス、価格帯、ベッドルーム数／バスルーム数、住宅タイプで物件を検索します。任意の map_bounds ビューポートを指定できます。include_meta を有効にすると、Zillow 独自の合計件数と取得件数が報告され、結果の切り捨てを確認できます
zillow_sweep_area	エリアを網羅的に列挙します。タイルの結果が切り捨てられなくなるまでマップを再帰的に分割し、重複を排除して、完全性の概要とデータ変動の警告を表示します。任意で JSON 出力ファイルを指定できます
zillow_get_property	zpid の詳細レコード（価格、Zestimate、ベッドルーム数、学校、近隣地域、価格履歴）を取得します
zillow_get_by_address	自由形式の住所（任意で市区町村／州／郵便番号を指定）を対応する Zillow の zpid と正規 URL に解決します
zillow_resolve_addresses	複数の自由形式の住所（または構造化された行）を一括で zpid と正規 URL に解決します
zillow_bulk_get	複数の zpid／URL の詳細レコードを一括取得します。部分的な結果とボットウォールに対応します
zillow_get_property_photos	物件の写真ギャラリー全体を取得します。物件詳細ページに埋め込まれたすべての画像と、複数の幅の JPEG／WebP バリエーション、キャプションを含みます
zillow_get_zestimate_history	Zestimate の時系列データ（利用可能な場合は賃貸用 Zestimate も）を取得します
zillow_get_price_history	価格と市場掲載日数を含む掲載履歴（掲載中／売却済み／保留中など）を取得します
zillow_get_tax_history	年ごとの税務記録（納税額と評価額）の履歴を取得します
zillow_compare_properties	最大 12 件の物件を横並びで比較し、項目をそろえた概要表を表示します
zillow_calculate_affordability	ローカルで利用できる住宅購入可能額計算ツールです。収入／DTI／金利から購入可能な上限価格を算出します
zillow_estimate_rent_vs_buy	値上がりと機会費用を考慮して、賃貸と購入の損益分岐点をローカルで算出します
zillow_get_saved_searches	新着物件数と通知頻度を含む、保存済み検索を取得します	✓
zillow_get_saved_homes	現在の価格、Zestimate、メイン写真を含む、お気に入りの物件を取得します	✓
zillow_get_market_report	地域の販売価格／掲載価格／賃料の中央値、市場掲載日数、在庫、ZHVI を取得します
zillow_calculate_mortgage	元金と利息、税金、保険、HOA、PMI を計算するローカルの PITI 計算ツールです（ネットワーク接続不要）
zillow_healthcheck	公開 Zillow URL をブリッジ経由で往復させ、ブリッジ／拡張機能／Zillow 側の障害を切り分けます
zillow_register_session	サインイン済みタブが使用する Zillow アカウントを、ローカルのセッションレジストリに記録します（ラベルのみ）
zillow_set_active_session	登録済みセッションを現在のアカウントラベルとして設定します。リクエストで使用するアカウントは変更されません（すべての呼び出しはサインイン済みのブラウザータブ経由で行われます）
zillow_get_session_context	アクティブなセッションと登録済みセッションの一覧を確認します

入力と出力の契約

ツールを呼び出すスクリプトやプロンプトを調整できるように、ツールの入力と出力が変更されました。

• zillow_compare_properties は zillow_bulk_get と同様に、ボット対策でブロックされた行を報告します。 Zillow が CAPTCHA でブロックし続けている行は、汎用的なエラー種別ではなく error_kind: "bot_challenge" を返すようになったため、掲載情報が見つからない場合と区別できます。レスポンスには blocked（ブロックされたままの行数）、retry_after_s（その行だけを再試行するまで待つ秒数）、pending（全体の期限までに処理が完了しなかった行数。これらの行の error_kind は "pending"）が含まれる場合もあります。

• zpid は数値である必要があります。 zpid を受け取るすべてのツール（zillow_get_property、zillow_bulk_get、zillow_compare_properties、zillow_get_property_photos、zillow_get_zestimate_history、zillow_get_price_history、zillow_get_tax_history）は、正の整数、または "12345" のような数字のみの文字列を受け付けます。"12345_zpid" や URL など、それ以外の文字列は無効な入力として拒否されるようになりました。代わりに、物件詳細ページの URL を url または urls フィールドに渡してください。

• zpids と urls の両方ではなく、どちらか一方を渡してください。 zillow_bulk_get と zillow_compare_properties は、両方のリストを含む呼び出しにエラーを返すようになりました。以前は urls リストが暗黙に無視されていました。両方の種類を取得するには、2 回に分けて呼び出してください。

利用規約への同意

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

1. このサーバーは、ご自身の Zillow セッションにアクセスします。 リクエストはすべて、ContextMint Bridge 拡張機能を介して、ご自身のブラウザータブ（ログインの有無を問いません）から送信されます。他の人のアカウントにアクセスすることはなく、またアクセスできません。

2. このサーバーの利用には、Zillow の利用規約が適用されます。 zillow.com を直接利用する場合と同様です。特に関連する条項は以下のとおりです。

当社の明示的な書面による許可なく、いかなる目的であっても、ロボット、スパイダー、スクレーパーその他の自動化手段を用いて本サービスにアクセスしてはなりません。また、自動クエリ（画面やデータベースのスクレイピング、スパイダー、ロボット、クローラー、CAPTCHA の回避、または同様の予防措置の回避など）を実行してはなりません。

このサーバーのツールを呼び出すたびに、これらの規約（メンテナーが 2026-05-23 に確認）に同意することになります。Zillow の規約は、書面による許可なく行う自動アクセスを広く禁止しています。このツールは非公式のものであり、Zillow から許可を得ていません。

3. 個人利用のみとし、商用利用はできません。 このプロジェクトは、Zillow Group と提携、承認、後援、または協業していません。手作業で操作する場合と同じ Zillow のウェブサイトを操作する個人用の自動化ツールです。1 回に 1 件ずつ検索し、ご自身が保存した住宅や市場レポートを扱います。掲載情報の一括抽出、モデルのトレーニング、競合する不動産サービスへのデータ投入、または商用目的での利用は禁止されています。

4. 安定性は保証されません。 このサーバーは、非公開の内部エンドポイント（/async-create-search-page-state/、__NEXT_DATA__ blob、/myzillow/...）を読み取りますが、Zillow は予告なくこれらを変更する可能性があります。動作しなくなることがあります。利用できなくなることもあります。これは、Zillow がこの仕組みの保守に責任を負わないことを前提とした仕様です。

5. このサーバーを Zillow へのアクセスに関連して使用したことによる結果については、すべてご自身が責任を負います。 これには、レート制限、アカウントへの警告、利用停止、IP アドレスのブロック、CAPTCHA によるブロック、または Zillow Group が行うその他の措置が含まれます。Zillow から利用について異議を申し立てられた場合は、このサーバーの使用を中止してください。

このセクションは、メンテナーが誠意をもってまとめた規約の概要です。法律上の助言ではなく、Zillow の実際の利用規約を変更または置き換えるものでもありません。

インストール

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

.mcp.json に追加します。

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

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

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

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

ブラウザーの初回セットアップ

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

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

ContextMint Bridge は fetchproxy のブラウザー拡張機能の新しい名称で、同じメンテナーが提供しています。fetchproxy の README（インストール → 拡張機能）からもリンクされています。ソースコードはnullnet-app/contextmint-bridgeで公開されています。自分でビルドする（そのリポジトリの README を参照する）か、リリース zip を読み込む前に、同じ場所で公開されている .sha256 ファイルと照合してください。shasum -a 256 -c contextmint-bridge-chrome-<version>.zip.sha256

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

仕組み

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

MCP サーバーは Node 上で動作しますが、zillow.com へのすべての HTTP 呼び出しは、ContextMint Bridge 拡張機能を通じて、起動中のブラウザータブに転送されます。各リクエストは既存のセッションを利用するため、_abck、TLS フィンガープリント、Cookie はすべて、すでに画面に表示されているページと一致します。ヘッドレスブラウザーの代替手段も、別の ID も、サードパーティーのプロキシも使いません。実際のブラウザーが自身の権限で動作し、MCP サーバーが取得する情報を指定するだけです。

コマンド

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