zillow-leads-property-data

zillow-leads-property-data

コードサンプル、サンプルデータセット、およびワークフローノートブック一式です。 Zillow Leads & Property Data Apify アクター向けです。

このアクターは、エージェント／ブローカーの連絡先情報、価格履歴の全タイムライン、20年以上にわたる税金履歴、差し押さえ／困窮状態のフラグ、学校情報、resoFacts の幅広い項目（暖房／冷房／建築）を付加した Zillow の掲載情報を取得します。イベントごとの従量課金で、サブスクリプションはありません。未加工データは1,000行あたり$0.70、エンリッチ済みデータは1,000行あたり$1.20です。

• アクター： https://apify.com/germane_binoculars/zillow-leads-property-data
• アーキテクチャの解説： Web 拡張機能を使った予測可能な Web スクレイピング — このアクターがプロキシファームではなく実際のブラウザーセッションで動作する理由と、それによって Zillow の PerimeterX + AWS WAF に対して得られる利点について説明します。

Apify アカウント以外の登録は不要。30秒で試せます

アクターの catalog モードは、すでにエンリッチ済みのキャッシュスナップショットを即座に返します。バウンディングボックスも待ち時間も不要です。

{ "mode": "catalog", "metro": "Chicago" }

Apify Consoleから実行するか、apify-client 経由で実行します（下記の examples/ を参照）。

このリポジトリの内容

パス	内容
sample/sample_listings.csv	実際にエンリッチされた20件の行（Chicago/Houston/Phoenix）— フラット形式で、スプレッドシートですぐに利用できます
sample/sample_listings.jsonl	同じ行を1行につき1つの JSON オブジェクトとして収録し、各掲載情報にネストされた price_history 配列を含みます
examples/python_quickstart.py	apify-client 経由で Python からアクターを呼び出し、結果を待って概要を出力します
examples/node_quickstart.js	Node から apify-client 経由で同じ操作を行います
mcp-server/	Claude Desktop、Cursor、およびあらゆる MCP クライアント向けの、ツール1つを備えた MCP サーバーです。mcp-server/README.md を参照してください
notebook/zillow_leads_workflow.ipynb	実践的なリード獲得ワークフローです。アクターを実行し、以前のエクスポートと重複を除外し、エージェントの電話番号がある行に絞り込み、整理済み CSV をエクスポートします

フィールドのリファレンス

データの深さは listings（未加工）と enriched（デフォルト）の2種類です。

• listings：住所、価格、ベッドルーム／バスルーム数、ステータス、敷地／居住面積、掲載タイプのフラグなど、Zillow 独自の検索 API が返す情報です。詳細ページの取得は行いません。データの形式は sample_listings.csv を参照してください（表示されている列の一部です。上記のサンプルは enriched のデータで、listings の行には未加工フィールド以降の情報は含まれません）。
• enriched（デフォルト）：listings のすべての情報に加え、エージェント／ブローカーの連絡先（氏名、電話番号、メールアドレス、仲介会社、MLS の帰属情報）、価格履歴と20年以上にわたる税金履歴の全タイムライン、差し押さえ／困窮状態のシグナル、割り当て済みおよび近隣の学校、HOA 費用、resoFacts の幅広い項目（暖房／冷房／駐車場／建築）を含みます。

すべてのフィールド、料金表、および各入力モード（catalog / custom_search / recent_activity）については、アクターの READMEを参照してください。

繰り返し注文時の重複除外

データが納品されるたびに、実行のキーバリューストアに DEDUP_UPDATE レコードが書き込まれます。これには、すでに保有していた zpid と MLS ID、および今回納品されたすべての項目の統合結果が記録されます。次回の注文でこの2つの配列を dedupZpids／dedupMlsIds フィールドに渡せば、同じ行に対して二重に課金されることはありません。実際の例は notebook/zillow_leads_workflow.ipynb を参照してください。

AI エージェントから使う（MCP）

このアクターは、Apify のホスト型 MCP サーバー（https://mcp.apify.com）またはローカルの @apify/actors-mcp-server 経由でツールとして呼び出せます。入力フォームに手動で入力する必要はありません。デフォルトの catalog モードは、ポーリングループなしで数秒以内にキャッシュ済みの行を返すため、エージェントの動作確認に適しています。エージェント向けの入力スキーマ全体と、ライブ収集注文での実行／ポーリング／取得のパターンについては、アクターの README を参照してください。

質問・問題

このリポジトリにはドキュメントとサンプルのみが含まれており、アクター自体は実行しません。期待どおりに動作しない特定の注文については、まずその実行のキーバリューストアにある STATUS レコードを確認してください（アクターは、結果が0件または一部のみの場合、その理由を平易な英語で記録します）。その後、ここで issue を作成するか、アクターの Apify Store ページからお問い合わせください。