propdata

propdata

APIllow API を通じた Zillow の物件データ：都市名または ZIP コードで住宅を検索し、Zillow ID、掲載 URL、または 番地から個別の物件を取得し、1 回の呼び出しで複数の住所を 検索し、現在掲載中の住所を確認し、無料アカウントを作成し、 月間の利用枠がどれだけ残っているかを確認できます。

物件情報は上流サービスから取得され、そのまま渡されるため、 物件レコードには APIllow が返す情報が含まれます。識別子、 住所、ステータスと種別、寝室数と浴室数、居住面積と敷地面積、 建築年、価格と推定価格、売却履歴と税金の履歴、少数の類似物件、 写真、近隣の学校などです。

9 つのツールが用意されています。上流のカタログにある 10 個目の ツールは、出力が決済リンクのみのプランアップグレード用ヘルパーで、 このパッケージには意図的に含まれていません。

9 つのツール：

• search_properties — 都市名または地域で検索します。オプションで 掲載種別と、返される結果の上限数を指定できます。
• search_by_zip — 1 つ以上の ZIP コードで検索します。
• get_property — Zillow の物件 ID で個別の物件を取得します。
• get_property_by_url — Zillow の掲載 URL から個別の物件を 取得します。
• get_property_by_address — 番地から個別の物件を取得します。
• get_properties_by_addresses — 1 回のリクエストで複数の番地を 検索します。
• check_addresses — 一連の住所のうち、Zillow で現在掲載中のものと その掲載 URL を確認します。
• signup — 無料アカウントを作成します。確認後、API キーが メールで届きます。
• check_usage — 現在の利用状況、利用枠、プランの詳細を確認します。

設定

export APILLOW_API_KEY="..."   # required for every tool except signup
export APILLOW_BASE_URL="https://apillow.co/api"   # optional override

キーが設定されていない場合、signup 以外のすべてのツールは、 引数の確認を行う前に APILLOW_API_KEY is not set で失敗します。 キーは X-API-Key ヘッダーとして API に送信されます。

CLI

各ツールは、1 つの JSON 引数文字列を取るサブコマンドです。

npx @reneturcios/propdata search_properties '{"query":"Austin TX","type":"sale","max_items":10}'
npx @reneturcios/propdata search_by_zip '{"zip_codes":[90210]}'
npx @reneturcios/propdata get_property '{"zpid":12345678}'
npx @reneturcios/propdata check_usage '{}'
npx @reneturcios/propdata --version

出力は上流の JSON で、変更せずに表示されます。終了コード： 成功時は 0、実行時エラー（検証エラーまたは上流側の失敗を含む）時は 1、使用方法のエラー時は 2 です。

MCP サーバー

npx -y @reneturcios/propdata mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "propdata": {
      "command": "npx",
      "args": ["-y", "@reneturcios/propdata", "mcp"],
      "env": {
        "APILLOW_API_KEY": "..."
      }
    }
  }
}

Docker

docker run -i -e APILLOW_API_KEY="..." ghcr.io/cloudcorprecords/propdata
docker run --rm -e APILLOW_API_KEY="..." ghcr.io/cloudcorprecords/propdata check_usage '{}'

開発

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch, no network)
npm run dev     # run the CLI from source

ライセンス

MIT — Copyright (c) 2026 Rene Turcios