Zillow MCP Server

Zillow MCP サーバー

Claude、Cursor、Windsurf、その他の MCP クライアントに、読み取り専用の Zillow ツールを2つ提供するホスト型 Model Context Protocol（MCP）サーバーです。豊富なフィルターを使って販売中、賃貸中、売却済みの物件を検索し、個別の物件情報をすべて構造化 JSON で取得できます。ホストするものはありません。

サインアウトした訪問者が閲覧できる Zillow.com の公開物件ページを読み取ります。

毎月1,000クレジットを無料で利用でき、カード登録も不要です。基本料金で Zillow を100回呼び出せます。

https://mcp.hasdata.com/mcp?apis=zillow

• プロンプトとリソース

目次

• 必要なもの
• クイックスタート
• プロンプトの例
• ツール
• エラーと失敗時の処理
• 料金、無料枠、上限
• ツールの選択
• 比較
• よくある質問
• HasData のリンク
• 開発
• 貢献
• ライセンス

必要なもの

MCP クライアントと、ダッシュボードから取得できる HasData API キーが必要です。カード登録なしで無料作成でき、無料枠では月に約100回、10クレジットの料金で呼び出せます。これはリモートサーバーなので、最も簡単な方法は URL と x-api-key ヘッダーを使うことで、実行するコンテナーは不要です。stdio のみを話すクライアントからは、npm で @hasdata/zillow-mcp、PyPI で hasdata-zillow-mcp として公開されている軽量ランチャーを介して接続できます。詳細は以下をご覧ください。

クイックスタート

サーバー URL はすべてのクライアントで共通です。Claude Code と Claude Desktop では、実際に動かして設定する手順を紹介します。その他のブロックは、それぞれのクライアントがリモートサーバー向けに公開している形式に従っています。

OAuth に対応したクライアントでは、同じ URL をコネクターとして追加してサインインすれば、設定ファイルにキーを記述せずに利用できます。

claude mcp add --transport http zillow "https://mcp.hasdata.com/mcp?apis=zillow" \
  --header "x-api-key: HASDATA_API_KEY"

{
  "mcpServers": {
    "zillow": {
      "command": "npx",
      "args": ["-y", "@hasdata/zillow-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

{
  "mcpServers": {
    "zillow": {
      "command": "uvx",
      "args": ["hasdata-zillow-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

{
  "mcpServers": {
    "zillow": {
      "url": "https://mcp.hasdata.com/mcp?apis=zillow",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

{
  "mcpServers": {
    "zillow": {
      "serverUrl": "https://mcp.hasdata.com/mcp?apis=zillow",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

{
  "servers": {
    "zillow": {
      "type": "http",
      "url": "https://mcp.hasdata.com/mcp?apis=zillow",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

プロンプトの例

コードではなく、プロンプトです。1つ貼り付ければ、エージェントが適切なツールを選びます。成功した呼び出しごとに10クレジットかかるため、それぞれに必要な呼び出し回数を記載しています。

テキサス州オースティンで、寝室が3部屋以上、価格が60万ドル未満の販売中の住宅を検索し、新しい順に並べて、最も新しい10件の価格と売出し期間を教えてください。

1回の呼び出しで10クレジットです。価格、寝室数、面積、売出し期間は検索結果に含まれます。

最上位の検索結果を選び、価格履歴、税金履歴、価格推定額、指定された学校を含む詳細情報を取得してください。

1回の呼び出しで10クレジットです。これらの情報は物件ページにあり、詳細ツールは URL を使って読み取ります。

オースティンで、猫の飼育が可能な賃貸コンドミニアムを検索し、最も安い3件の賃貸推定額を取得してください。

4回の呼び出しで40クレジットです。検索が1回、その後3件それぞれに対する物件呼び出しが1回ずつです。

この物件 URL について、売出価格、価格推定額、価格履歴にある直近3件の売却情報を教えてください。

1回の呼び出しで10クレジットです。

検索結果だけで順位付けと候補の絞り込みができます。価格履歴、税金履歴、価格推定額、学校、担当エージェントの情報は物件呼び出しから取得するため、候補を絞り込んで3件を調べるプロンプトでは、検索が1回、物件呼び出しが3回必要です。

ツール

ツールは2つで、どちらも読み取り専用です。以下のサンプルは実際の呼び出しから抜粋したものです。数値は市場の変化に応じて変わります。データの形を示すものとしてご覧ください。各ツール名にはエンドポイントのリファレンスへのリンクがあり、すべてのフィールドが記載されています。

サンプルはペイロードであり、レスポンス全体ではありません。tools/call の結果には1つのテキストブロックが含まれ、そのテキスト自体が url、status、text、json を含む JSON で、スクレイピングしたデータは json の下にあります。未加工の JSON-RPC レスポンスでは、パスは result.content[0].text です。これを解析してから .json を参照します。チャットクライアントはこの処理を代行しますが、エンドポイントに直接アクセスするコードでは自分で処理する必要があります。

Zillowの不動産掲載情報を取得

hasdata_zillow_listing_getRealEstateListings

場所のキーワードで絞り込んだ掲載情報のページです。

リファレンスには、専有面積、土地面積、建築年、HOAの範囲に加えて、otherAmenities__、views__、pets__、listingType、propertyStatus__、listingPublishOptions__ なども記載されています。

totalResultsを含むsearchInformation、properties配列、次のページのURLを示すnextPageを含むpaginationを返します。各物件には、id、url、homeType、status、price、currency、賃料の推定額であるrentZestimate、daysOnZillow、平方フィート単位のarea、addressRawと構造化されたaddress、latitude、longitude、beds、baths、listingDetails、mediaDetails、photosが含まれます。

{
  "id": "60134551",
  "url": "https://www.zillow.com/homedetails/6116-Speyside-Dr-Austin-TX-78754/60134551_zpid/",
  "homeType": "SINGLE_FAMILY",
  "status": "FOR_SALE",
  "price": 320000,
  "currency": "$",
  "rentZestimate": 2286,
  "daysOnZillow": 0,
  "area": 2277,
  "address": { "street": "6116 Speyside Dr", "city": "Austin", "state": "TX", "zipcode": "78754" },
  "beds": 4,
  "baths": 3
}

Zillowの物件詳細を取得

hasdata_zillow_property_getPropertyDetails

URLで指定した物件の詳細情報です。

ページの全情報を返します。price、currency、fees、beds、baths、area、yearBuilt、homeType、mlsId、構造化されたaddressとgeo、descriptionとhighlights、photos、schools、daysOnZillow、views、saves、agentInfoブロックに加え、priceHistory、taxHistory、mortgageの各配列が含まれます。Zillow独自の価格推定値は、zestimate、estimatedSaleRange、rentZestimateを格納したzestimateオブジェクトで返されます。確定値ではなく推定値として扱ってください。

ここでのareaは{ livingArea, livingAreaUnits }というオブジェクトであり、検索ツールが返す単一の数値ではありません。物件ページの平方フィート数を取得するにはarea.livingAreaを参照してください。area > 2000のような数値比較を行うと、オブジェクトに対して比較するため、エラーにならずに失敗します。

{
  "id": 60134551,
  "status": "FOR_SALE",
  "price": 320000,
  "currency": "USD",
  "yearBuilt": 2002,
  "beds": 4,
  "baths": 3,
  "area": { "livingArea": 2277, "livingAreaUnits": "Square Feet" },
  "fees": { "monthlyHoaFee": "$500 annually" },
  "zestimate": { "zestimate": 318100, "estimatedSaleRange": "$302K - $334K", "rentZestimate": 2286 },
  "address": { "street": "6116 Speyside Dr", "county": "Travis County" },
  "agentInfo": { "agentName": "Marie Coleman", "brokerName": "eXp Realty" },
  "priceHistory": [{ "date": "2026-08-24", "price": 320000, "event": "listedForSale" }],
  "schools": { "elementarySchool": { "name": "Bluebonnet Trail", "district": "Manor ISD" } }
}

プロンプトとリソース

サーバーには2つのプロンプトが用意されています。ユーザーにツール呼び出しを組み立ててもらう代わりに、クライアントが提示できる既成のワークフローです。

また、サーバーは、受け付ける値が固定リストになっているパラメーターごとに1つ、計11個のリソースを公開しています。拒否された呼び出しから値の候補を学ぶより、リソースを読むほうが低コストで、クレジットも消費しません。URIはそれぞれ hasdata://zillow/<parameter> です。

どちらのリストもAPIキーなしで提供されるため、ユーザーが登録する前にクライアントが読み取れます。

エラーと失敗時の動作

クライアントがツール呼び出しからHTTPエラーコードを受け取ることは、ほとんどありません。MCPレイヤーは200で応答し、isError を true に設定して、理由をテキストで結果に含めます。エージェントには、ステータス行が表示されると思われる場面でメッセージが表示されます。

キーが間違っていても、接続エラーではなくツール出力として表れます。 tools/list は空でないキーであれば何でも受け付け、両方のツールを返すため、クライアントはハンドシェイクを完了し、正常を示す緑色の表示になります。その後の最初のツール呼び出しで、isError: true とテキスト HasData API error: 401 Unauthorized が返されます。フローのそれ以前の段階では問題が報告されないため、この文字列に注意してください。

キーがない場合は、実際にHTTPエラーが発生します。 認証はどのツールよりも先に行われ、接続自体が401で失敗します。CORSヘッダーが付与されるため、ブラウザクライアントは不透明なネットワークエラーではなく、ステータスを読み取れます。

ツールのスキーマに適合しない引数は、スクレイピングが始まる前に拒否されます。 サーバーは isError: true と、問題のあるフィールド名を含むテキスト MCP error -32602: Input validation error を返します。データは取得されず、料金も発生しません。

検索結果がない場合はエラーではなく、properties 配列が空の成功結果が返されます。 該当する物件がない場所とフィルターの組み合わせでも、requestMetadata.status が ok に設定された結果が返されます。反復処理の前に配列の長さを確認してください。

掲載終了した物件は、requestMetadata.status が error に設定された400を返します。 過去の検索結果に含まれるURLが、すでに削除されたリスティングを指していることがあります。

データを含む結果には、サポートへの問い合わせで伝えると役立つ requestMetadata.id も含まれています。

料金、無料枠、制限

Zillow の各ツールは、呼び出しが成功するたびに10 クレジットかかります。extractAgentEmails を有効にすると物件の呼び出しに5クレジットが加算され、10ではなく15クレジットになります。メールアドレスが必要な場合を除き、オフのままにしてください。レスポンスのサイズによって料金は変わりません。

無料枠は、カード登録不要で毎月1,000クレジットです。基本料金では Zillow を100回呼び出せます。請求サイクルごとに更新されるため、呼び出し頻度の低いエージェントは無料枠を期限なく利用できます。

有料プランは、200,000クレジット（20,000回の呼び出し）が含まれる月額59ドルからです。ボリュームが増えるほど単価は下がり、エントリープランでは呼び出し1,000回あたり1.48ドル、Basicでは0.60ドル、Growth各プランでは0.41ドルです。最新の料金は料金ページをご覧ください。

同時実行数もプランによって異なります。無料枠では同時に1件、Startupでは5件、Basicでは15件、Growth各プランでは50～500件を実行できます。無人で動作するものでは、超過時の処理を適切に行ってください。

HTTP ステータスが200以外で返されたリクエストには課金されません。結果が見つからなくても、呼び出しが成功すれば課金対象です。

ツールの選択

apis クエリパラメーターで、エージェントに表示するツールを指定できます。ツールを絞ると、ツール定義に使われるコンテキストが減り、モデルが誤ったツールを選ぶ可能性も低くなります。

?apis=zillow                     the two tools in this repo
?apis=zillow,redfin              add Redfin real estate
?apis=zillow,google_maps         add Google Maps places

このパラメーターには、zillow のようなプロバイダー名と、zillow_listing のような個別の API 名を指定できます。スペルミスのある名前は無視されます。すべての名前が無効な場合、リクエストは400エラーとなり、認識されなかった値と有効な値がすべて本文に記載されます。パラメーターを省略すると、同じエンドポイントですべての HasData ツール57種類が公開されます。

比較

Zillow 独自の API プログラムは、Bridge Interactive や Mortgage API のように、会員やパートナーが自社の物件情報を扱うためのものです。一般公開されている市場情報を自由に参照するためのセルフサービス手段ではありません。掲載物件の検索や任意の物件情報の取得には、一般公開ページのスクレイピングが必要で、このサーバーは安定したスキーマを通じてそれを実現します。

このサーバーではできないこと。 掲載、リードの送信、アカウントデータの取得はできません。サインアウトした状態の訪問者が Zillow.com で見られる情報を読み取ります。

よくある質問

Zillow の公式 MCP サーバーはありますか？

Zillow は公開していません。このサーバーは HasData が保守しており、一般公開されている Zillow.com のページを読み取ります。

Zillow MCP サーバーとは何ですか？

AI クライアントが呼び出せるツールとして、Zillow の掲載物件データを公開するサーバーです。クライアントが Model Context Protocol 経由でツール呼び出しを送信すると、サーバーがデータを取得して構造化された JSON を返し、モデルがその結果を処理します。このサーバーは2つのツールを公開し、リモートで実行されます。

Zillow のアカウントや API キーは必要ですか？

いいえ。必要な認証情報は HasData キーのみです。ツールは一般公開されている Zillow.com のページを読み取ります。

検索結果に価格履歴や学校の情報が表示されないのはなぜですか？

Zillow は検索カードにそれらの情報を掲載していないためです。これらの情報は物件ページにあり、詳細ツールで URL を指定して取得できます。検索で候補を絞り込んでから、物件ツールを呼び出して詳細を確認してください。

価格の推定値とは何ですか？

zestimate オブジェクトには、Zillow 独自の推定価格、その上下の範囲、賃貸価格の推定値が含まれます。これはモデルの出力であり、鑑定評価額でも確定した売却価格でもありません。あくまで推定値として扱ってください。

他の HasData API と一緒に使えますか？

はい。apis パラメーターにはリストを指定できます。?apis=zillow,redfin とすると、エージェントで Zillow と Redfin を利用できます。パラメーターを省略すると、すべてのツールを利用できます。

HasData は Zillow と提携していますか？

いいえ。HasData は独立したサービスであり、Zillow Group, Inc. と提携、推奨、または後援を受けていません。Zillow は、それぞれの所有者の商標です。

コンプライアンスと個人データ

HasData は、一般に公開されているデータのみを取得します。プラットフォームの利用規約では自動アクセスが制限されている場合があり、コンプライアンスの遵守はお客様の責任です。収集するデータに、物件掲載エージェントの連絡先などの個人情報が含まれる場合は、GDPR、CCPA、またはお客様の管轄区域における同等の規則に基づく適法な根拠があることを確認してください。

HasData のリンク

開発

このリポジトリには、リモートサーバーの設定とドキュメントが含まれています。ビルド手順はなく、コンテナ化するものもありません。

test/ のテストでは、コミットがなくても変更される可能性のある部分であるツールの契約を検証します。?apis=zillow が正確に 2 つのツールを返すこと、各ツールで必須パラメーターが引き続き宣言されていること、名前が変更されていないこと、使用中のキーが実際に受け入れられることを確認します。最後のチェックではツールを実際に呼び出すため、10 クレジットがかかります。これは、適切な理由で失敗する可能性のあるカナリアテストの費用です。

# macOS and Linux
HASDATA_API_KEY=your_key_here npm test

# Windows PowerShell
$env:HASDATA_API_KEY="your_key_here"; npm test

同じテストスイートは、リポジトリに変更がなくても上流のツール一覧が変わる可能性があるため、プッシュのたびに CI で実行されるほか、スケジュールに従って週 1 回実行されます。失敗した場合は、ツール一覧の変更、キーの動作停止、またはエンドポイントへの接続不能が原因です。アサーションメッセージに、どれに該当するかが示されます。

貢献

ツールの表とレスポンスのサンプルは変化しやすいため、これらの修正が最も役立ちます。実行した呼び出しと、受け取ったレスポンスを記載してください。フォークからのプルリクエストではキーなしでテストスイートが実行され、ライブチェックは失敗として扱われずにスキップされます。

ライセンス

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