HasData Redfin

Redfin MCP サーバー

Claude、Cursor、Windsurf など、あらゆる MCP クライアントから利用できる、ホスト型の Model Context Protocol（MCP）サーバーです。読み取り専用の Redfin ツールを 2 つ提供します。Redfin が訪問者に表示するフィルターを使って、販売中、賃貸中、売却済みの物件を検索し、個別の物件ページを構造化 JSON としてすべて読み取れます。MLS ライセンスも、ホストするものも必要ありません。

ログアウト状態の訪問者が閲覧できる、Redfin の公開ページを読み取ります。

毎月 1,000 クレジットが無料で、カードの登録も不要です。10 クレジットで利用できる Redfin 呼び出しが 100 回分です。

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

• プロンプトとリソース

目次

• 必要なもの
• クイックスタート
• プロンプトの例
• ツール
• エラーと失敗時の動作
• 料金、無料枠、制限
• ツールの選択
• 比較
• よくある質問
• HasData のリンク
• 開発
• コントリビューション
• ライセンス

必要なもの

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

クイックスタート

サーバー URL は、どのクライアントでも同じです。Claude Code と Claude Desktop では、実際に動作させる手順を紹介します。その他のブロックでは、各クライアントがリモートサーバー向けにドキュメントで定めている形式に従います。

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

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

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

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

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

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

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

プロンプトの例

以下の各プロンプトは 1 つのツールで処理されます。2 つ目のツールが 1 つ目のツールの返す URL を必要とする場合は、順番に 2 つのツールで処理されます。

• 78741 で 50 万ドル未満の 3 ベッドルームの売り出し中の住宅を 3 件探し、平方フィートあたりの価格順に並べてください。
• 過去 3 か月にオースティンで売れた物件と、現在売り出し中の物件を比較してください。
• この Redfin URL の物件ページ全体を取得し、説明文から物件の状態を要約してください。
• オースティンで、犬を飼えて室内に洗濯設備がある賃貸物件はどれですか？
• オースティン独立学区にある売り出し中の住宅のうち、指定された小学校の評価が 8 以上の物件を表示してください。
• この郵便番号で、1970 年より前に建てられ、30 日以上 Redfin に掲載されているリノベーションが必要な物件を探してください。

市場を指定するプロンプトは検索ツールに送られます。Redfin の URL を渡すプロンプトは、物件ツールに直接送られます。完全な番地を指定して検索するのは 3 つ目のケースで、一覧ではなく 1 つの物件を返すため、以下で説明します。

ツール

ツールは 2 つで、成功した呼び出し 1 回につき 10 クレジットです。

Redfin の不動産物件一覧を取得する

hasdata_redfin_listing_getRealEstateListings

場所の物件一覧、または場所として番地を 1 つ指定した場合はその物件を返します。

必須パラメーターは 2 つで、その他のスキーマは Redfin 独自の絞り込みパネルに準じます。

知っておくと便利なパラメーターは次のとおりです。

市場検索では、totalResults を含む searchInformation、40 件の properties 配列、currentPage、nextPage、otherPages マップを含む pagination が返されます。販売中または売却済みの物件には、id、mlsId、url、homeType、status、price、beds、baths、area、yearBuilt、daysOnSite、addressRaw、解析済みの address、latitude、longitude、description、atAGlanceFacts、photos が含まれます。

atAGlanceFacts には 2 つの形式があります。検索結果の行ではセールスポイントを示す文字列のリストですが、物件のレスポンスでは factLabel と factValue のペアのリストです。そのため、片方の形式を読み取るコードは、もう片方の形式では動作しません。

{
  "id": 31625298,
  "mlsId": "2190201772333567097",
  "url": "https://www.redfin.com/TX/Austin/1721-Deerfield-Dr-78741/home/31625298",
  "homeType": "House",
  "status": "FOR_SALE",
  "price": 675000,
  "beds": 3,
  "baths": 2,
  "area": 1667,
  "yearBuilt": 1963,
  "daysOnSite": 0,
  "addressRaw": "1721 Deerfield Dr, Austin, TX 78741",
  "address": { "street": "1721 Deerfield Dr", "city": "Austin", "state": "TX", "zipcode": "78741" },
  "latitude": 30.231372,
  "longitude": -97.734893,
  "atAGlanceFacts": ["Hill country views", "2020 roof", "Stainless appliances"]
}

賃貸物件は住宅ではなく建物であるため、type: forRent を指定すると異なる形式が返されます。price、beds、baths、area はそれぞれ、利用可能なユニット全体の { min, max } オブジェクトになります。また、エントリーには propertyName、availableUnits、agentEmail、agentPhone が追加され、mlsId、homeType、yearBuilt、daysOnSite は含まれません。

{
  "id": "31510362",
  "propertyName": "The Sonata",
  "status": "FOR_RENT",
  "availableUnits": 12,
  "price": { "min": 745, "max": 1300 },
  "beds": { "min": 1, "max": 2 },
  "baths": { "min": 1, "max": 2 },
  "area": { "min": 474, "max": 976 },
  "addressRaw": "1070 Mearns Meadow Blvd, Austin, TX 78758"
}

Redfin の物件詳細を取得する

hasdata_redfin_property_getPropertyDetails

Redfin の URL を指定して、1 件の物件ページの全情報を取得します。

property オブジェクトを返します。検索結果に含まれる情報に加えて、propertyDetails、schools、nearby、agentInfo、viewsActivity、openHouseSchedule、updatedAt、geo オブジェクト、および完全な photos コレクションを含みます。以下の物件では画像が 61 枚ありました。

propertyDetails は、parking、interior、exterior、utilities、publicFacts に分類された仕様のまとまりです。各グループはラベル付きセクションの配列で、各セクションは label と value のペアの配列です。そのため、型付きオブジェクトではなく、ページに表示される形式に沿った構造になっています。位置ではなくラベルを使って情報を検索してください。

schools.assignedSchools には、学区の学校とともに、greatSchoolsRating、parentRating、distanceInMiles、servesHome フラグが含まれています。このフィールドは、その学校が実際にこの住所を対象としているかどうかを示します。

{
  "id": 31625298,
  "homeType": "Single Family Residential",
  "status": "COMING SOON",
  "price": 675000,
  "beds": 3,
  "baths": 2,
  "area": 1667,
  "yearBuilt": 1963,
  "geo": { "latitude": 30.231372, "longitude": -97.734893 },
  "updatedAt": "Sep 9, 2026 4:04 AM",
  "viewsActivity": { "views": 98, "favorites": 5 },
  "agentInfo": {
    "agentName": "Lilly Rockwell",
    "agentPhoneNumber": "512-413-1975",
    "brokerName": "Compass",
    "brokerPhoneNumber": ""
  },
  "propertyDetails": {
    "parking": [{ "parkingInformation": [{ "label": "Has Garage", "value": "yes" }] }],
    "utilities": [{ "utilitiesInformation": [{ "label": "Has Air Conditioning", "value": "yes" }] }]
  },
  "schools": { "assignedSchools": [{ "greatSchoolsRating": 6, "parentRating": 5, "servesHome": true }] }
}

プロンプトとリソース

サーバーは、受け付ける値が固定リストであるパラメーターごとに 1 つ、計 30 個のリソースを公開します。拒否された呼び出しから用語を覚えるよりも、リソースを読み取るほうが簡単で、クレジットも消費しません。各 URI は hasdata://redfin/<parameter> です。

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

エラーと失敗時の動作

正常に完了するケースだけを前提にせず、これらのケースにも備えてください。

soldWithinOption は売却済み検索の対象期間を絞り込みます。この指定を意味のあるものにするには、type: sold が必要です。 期間は想定どおり入れ子になっているため、同じ市場では、1 週間の期間で返される件数は 1 年間の期間の場合より大幅に少なくなります。指定しない場合、type: sold は Redfin 独自のデフォルトである過去 3 か月を対象にします。売却済み検索と販売中検索は重複しないため、同じ物件が両方に表示されることはありません。

検索ツールは 3 種類の異なる形式を返します。返される形式はキーワードによって異なります。 市場を表すキーワードの場合は、searchInformation、properties、pagination が返されます。住所全体または名前の付いた建物を指定した場合は、単一の property オブジェクトが返され、properties 配列、searchInformation、pagination はありません。賃貸検索では、上記の範囲形式のエントリーが返されます。properties の有無を確認してから反復処理してください。

totalResults は全件数を示すため、大規模な市場では数千件に達します。 1 ページには 40 件の物件が含まれ、pagination.otherPages には残りのページが列挙されます。都市によっては数百ページに達することもあります。ページ番号の大きいページも返されるため、ページネーションは機能しますが、市場全体を順に取得するにはページごとに 1 回の呼び出しが必要です。網羅性よりも予算を重視する場合は、郵便番号、価格帯、または物件タイプで絞り込んでください。

売却済み検索では、売却価格が独立したフィールドとして返されません。 price には、そのステータスでページに表示されている価格が入るため、販売中の価格も売却価格も同じフィールドで返されます。毎回、status と合わせて確認してください。

物件のレスポンスには、検索結果にはない履歴情報が含まれます。 priceHistory と taxHistory はイベントリストとして返され、redfinEstimate には比較対象物件とともに推定価格が含まれます。また、propertyDetails では査定官スタイルの情報が publicFacts にまとめられ、parking、interior、exterior、financial、utilities も含まれます。これらは検索結果の各行には含まれないため、履歴に関する質問には物件呼び出しが必要です。

nearby.pointsOfInterest は近隣の場所を示すもので、比較対象の売却物件ではありません。 その categories はサードパーティの施設データセットに由来し、誤っていることがよくあります。そのため、タイトルローンの店舗がバーとして分類される場合もあります。名前と座標を利用し、カテゴリは信用しないでください。

openHouseSchedule は、セクションは存在するものの日付がない場合、空のオブジェクトを含む配列になることがあります。 配列の長さではなく、内容を確認してください。

brokerPhoneNumber やその他のエージェント関連フィールドは、null ではなく空文字列として返されます。 空文字列は値がないものとして扱ってください。

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

料金、無料枠、制限

Redfin の各ツールは、呼び出しが成功するごとに 10 クレジットかかります。レスポンスのサイズによって料金は変わらないため、40 件の物件が含まれるページも 1 件だけの物件も同じ料金です。

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

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

同時実行数もプランによって異なります。無料枠では同時に 1 件、Startup では 5 件、Basic では 15 件、Growth 各プランでは 50 ～ 500 件を処理できます。無人で実行する処理では、429 が返されたらバックオフを入れて再試行してください。物件一覧を順に取得するエージェントは、あなたが上限に達するより先に上限に達するためです。

200 以外のステータスコードで返されたリクエストには料金がかかりません。検索結果が 0 件でも、呼び出しが成功すれば料金がかかります。

ツールの選び方

まず、プロンプトで与えられた情報を確認します。市場、郵便番号、学区があれば検索ツールを使います。Redfin の URL があれば、そのまま物件ツールを使います。すでに持っている URL にたどり着くために検索を呼び出すのは、最もよくある無駄です。

次に、必要な情報の深さに応じて選びます。検索結果は、ランキング、価格帯ごとの検索、市場の概要を把握するのに十分で、価格、ベッドルーム数、バスルーム数、面積、築年、掲載日数もすでに含まれています。仕様の一覧、割り当てられた学校、掲載担当エージェントを返すのは物件ツールだけです。気になる物件ごとに1回呼び出す価値はありますが、検索結果の各行について呼び出す必要はありません。

フィルターはサーバー側で適用します。スキーマは Redfin のフィルターパネルを正確に反映しているため、「ベッドルーム3室、50万ドル未満、1970年より前に建築、指定の郵便番号内」といった検索は、ページを順に取得してからローカルで絞り込むのではなく、4つのパラメーターを指定して1回呼び出すだけです。

比較

Redfin に公開 API はないため、実質的な代替手段は MLS または IDX のフィードです。

利用資格の行が判断を左右します。MLS フィードは信頼できる正式な情報源ですが、開発者として購入できないライセンスが必要です。そのため、調査、プロトタイプ、エージェントに代わって行う作業には利用できません。すでにフィードを利用できる不動産仲介業者であれば、フィードのほうが情報が充実していて更新も早いため、そちらを使うべきです。

よくある質問

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

Redfin は公式 MCP サーバーも公開 API も提供していません。このサーバーは HasData が保守しており、Redfin の公開ページを読み取ります。

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

MCP サーバーは、AI クライアントが呼び出せるツールを公開します。このサーバーは、Redfin の検索結果と物件ページを、ブラウザーやスクレイピング用ライブラリをスタックに追加せずに、エージェントが推論に使える JSON に変換します。

MLS ライセンスまたは Redfin アカウントは必要ですか？

いいえ。必要な認証情報は HasData キーだけです。

住所を検索すると、一覧ではなく1件の物件が返されるのはなぜですか？

Redfin は、完全な番地を検索すると検索結果一覧ではなく、その物件のページに解決するためです。ツールはその結果をそのまま渡すため、レスポンスには物件ツールと同じ形式の property オブジェクトが1つ含まれます。URL はないものの住所が分かっている場合に便利な近道です。

市内のすべての掲載物件を取得するにはどうすればよいですか？

ページごとに呼び出して、ページングします。市の全件数は totalResults に示され、1回の呼び出しにつき40件の物件が返されます。そのため、大きな市場では1回で一括取得するのではなく、数百回の呼び出しが必要になります。郵便番号、価格帯、住宅タイプで市場を絞れば、同じ範囲をより少ない回数で、より狭い条件のクエリで取得できます。通常はその方法が適しています。

売却済み物件を日付で絞り込めますか？

現時点では、確実にはできません。type: sold は機能し、Redfin のデフォルトである直近3か月のデータを返しますが、soldWithinOption は Redfin が受け付けるフィルターに変換されず、指定すると「SOLD」とラベル付けされた販売中の物件が返されます。修正されるまでは指定しないでください。

賃貸物件にも対応していますか？

はい。type: forRent で取得できます。賃貸物件の検索結果は複数の利用可能なユニットを持つ建物のため、1戸の住宅と同じ形式ではなく、範囲形式で返されます。

これをほかの HasData API と一緒に使用できますか？

はい。1つのキーですべてを利用でき、1つのエンドポイントから apis パラメーターを使ってすべての API を呼び出せます。クライアントの接続先を ?apis=redfin,zillow にすると、1つの接続で両方のツールセットを利用できます。または、すべてのカタログを利用するには mcp.hasdata.com/mcp を指定してください。

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

いいえ。HasData は独立したサービスであり、Redfin との提携、推奨、後援は受けていません。Redfin はそれぞれの所有者の商標です。ツールは公開されているデータのみを使用します。結果を Redfin の利用規約および適用される法律に従って使用する責任は、利用者にあります。

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

掲載情報には、エージェントの連絡先情報が含まれます。販売中の物件では agentInfo に氏名と直通電話番号が含まれ、賃貸物件では agentEmail と agentPhone が含まれます。これらは業務上の立場で公開されている、特定可能な個人の情報であり、GDPR や CCPA の適用範囲外になるわけではありません。また、そうした人々へのマーケティングには別途規制が適用されます。不動産エージェントはまさにその対象となることが多いため、連絡先リストを作成する前に、適用される義務を確認してください。市場分析には、これらのフィールドは必要ありません。

HasData のリンク

• Redfin Scraper API。これらのツールの基盤となる REST エンドポイントです
• API ドキュメント
• MCP サーバーのドキュメント
• 料金
• ダッシュボード

その他の HasData MCP サーバー：Google Search、Google Maps、Google Trends、Google Flights、DuckDuckGo、YouTube、TikTok、Instagram、Amazon、Shopify、Yelp、Zillow、Airbnb、Booking.com、Indeed。

開発

ランチャーはリモートサーバーへのシンプルな stdio ブリッジであるため、ビルドは不要です。

npm install
HASDATA_API_KEY=your_key_here npm test

test/ のテストでは、ここでコミットしなくても変更される可能性のあるツールの契約を検証します。?apis=redfin が想定された数のツールを返すこと、名前が変更されていないこと、すべてのツールに必須パラメーターが定義され、説明が付いていること、この README に記載されているフィルターの列挙値がスキーマで提示されるものと一致していること、そして使用中のキーが実際に受け付けられることを確認します。最後の確認では実際にツールを呼び出すため、10 クレジットが必要です。これは、適切な理由で失敗し得るカナリアテストの費用です。

上流のツール一覧は、このリポジトリに変更がなくても変わる可能性があるため、契約テストスイートもスケジュールに従って毎週実行されます。

コントリビューション

ツールの表、レスポンスのサンプル、またはドキュメントに記載された動作が実際と異なる場合は、Issue を作成してください。そのためのテンプレートが用意されています。同様の内容やランチャーに関するプルリクエストも歓迎します。

ライセンス

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