real-estate-autos-research

不動産・自動車のリサーチ

Crawlora API を使って、5 つのプラットフォームから住宅や中古車を検索し、不動産・車両の詳細情報を正規化された JSON 形式で取得します。掲載ページをスクレイピングする必要はありません。

このスキルを使う場面

• 「 で売りに出ている家を探して」／「この不動産はいくらの価値がありますか？」（Zillow、Redfin）
• 「この地域の住宅価格はどうなっていますか？」（Redfin の市場動向）
• 比較のために「類似物件を探して」。
• 「 の近くで販売中の <make/model> を探して」（CarMax、Autotrader、Cars.com）
• 「この車両の掲載情報／ディーラーを調べて」。

セットアップ（一度のみ）

• 無料の Crawlora API キー（月 2,000 クレジット、クレジットカード不要）を https://crawlora.net で取得します。
• ヘルパーを実行する前に、環境変数に CRAWLORA_API_KEY を設定します。
• ヘルパーは環境変数から CRAWLORA_API_KEY を読み取り、https://api.crawlora.net/api/v1 にリクエストを送信します。キーがない場合、または無効な場合は 401 が返されます。

仕組み

1. Zillow — /zillow/search では location 文字列だけでなく、まず /zillow/autocomplete（query）で地域を解決して、region_id（および利用可能な場合は地図の境界 north／south／east／west）を取得する必要があります。その後、location+region_id（返された場合は region_type も）を /zillow/search に渡します。詳細情報には /zillow/property/{zpid} を使います。
2. Redfin — 掲載情報には /redfin/search（location または region_id+region_type と、min_beds／max_price などのフィルター）を使います。詳細情報には /redfin/property（property_id または url を指定）、Redfin Estimate には /redfin/estimate（property_id を指定）、類似物件には /redfin/similar、市場の過去の動向には /redfin/region-trends（region_id+region_type を指定）を使います。
3. CarMax — /carmax/search（フィルター：make、model、zip、min_price／max_price、min_year／max_year）を使います。詳細情報とおすすめ情報には /carmax/vehicle/{stock_number}（および /recommendations）、ディーラーの所在地には /carmax/stores／/carmax/store/{id} を使います。
4. Autotrader — /autotrader/search（フィルター：make、model、zip、radius、価格／年式／走行距離の範囲、condition）を使います。詳細情報には /autotrader/vehicle/{id}、販売者には /autotrader/dealer/{id} を使います。
5. Cars.com — /carsdotcom/search（zip、radius、stock_type）を使います。詳細情報には /carsdotcom/vehicle/{listing_id} を使います。

エンドポイント、メソッド、パラメーターの一覧は reference/endpoints.md を参照してください。

API の呼び出し

# Homes (resolve region_id first, Zillow search needs more than a location string):
scripts/crawlora.sh /zillow/autocomplete query="Austin, TX" | jq '.data'
scripts/crawlora.sh /zillow/search location="Austin, TX" region_id=10221 | jq '.'
scripts/crawlora.sh /redfin/region-trends region_id=30818 region_type=city | jq '.'

# Cars:
scripts/crawlora.sh /carmax/search make=Toyota model=RAV4 zip=94103 | jq '.'
scripts/crawlora.sh /autotrader/search make=Honda model=Civic zip=94103 radius=50 | jq '.'

すべてのリクエストには scripts/crawlora.sh を使います。これにより、API キーをコマンドライン引数に含めずに済みます。

エンドポイントのリファレンス

このスキルで使用する Zillow、Redfin、CarMax、Autotrader、Cars.com のすべてのエンドポイントについては、reference/endpoints.md を参照してください。

使用例

• 住宅購入のリサーチ： 同じ地域で /zillow/search と /redfin/search を使い、価格／平方フィートを照合してから、/redfin/region-trends で市場が活況か沈静化しているかを確認します。
• 不動産価格の妥当性確認： 1 つの住所について、/redfin/estimate と /redfin/similar（比較物件）を併せて使います。
• 車の購入比較： 同じメーカー／モデル／郵便番号で /carmax/search、/autotrader/search、/carsdotcom/search を使い、3 つすべての価格と走行距離を比較します。

注意事項と制限

• クレジット／成功時のみ課金： 2xx の場合のみ課金されます。無料枠は月 2,000 クレジットです。キーは https://crawlora.net で取得できます。
• 公開データのみ — 公開されている掲載情報／査定ページを対象とします。不動産や金融に関する助言は行いません。
• セキュリティ： キーは CRAWLORA_API_KEY のみに保存してください。ハードコードしたり、クエリパラメーターに含めたり、コミットしたりしないでください。
• Redfin の地域 ID はプラットフォーム固有です — /redfin/region-trends を事前に呼び出す前に、region_id を含む /redfin/search の結果で解決してください。
• Zillow の検索には region_id（/zillow/autocomplete で取得）が必要で、location 文字列だけでは不十分です — location だけを指定すると 400 が返されます。
• 検索エンドポイントはページネーションに対応しています（page）。全件を取得するには、ページを順に確認してください。