Batchdata MCP Real Estate

🚀 BatchData MCP Server

BatchData MCP Serverは、BatchData.ioの包括的な物件および住所APIと統合されたModel Context Protocol (MCP)サーバーです。このサーバーを通じて、物件データの取得、住所検証、スキップトレーシング、ジオコーディング、高度な物件検索機能を利用できます。

✨ 主な機能

住所操作

• verify-address：USPSの検証を使用して住所を検証し、標準化します。
• autocomplete-address：入力に応じて、賢い住所の候補を取得します。
• geocode-address：住所を緯度/経度の座標に変換します。
• reverse-geocode：座標を読みやすい住所に変換します。

物件操作

• lookup-property：住所またはAPN（査定用区画番号）で詳細な物件情報を取得します。
• search-properties：包括的なフィルターを使用した高度な物件検索を行います。
• search-properties-by-boundary：バウンディングボックスまたは半径を使用した地理的境界検索を行います。
• count-properties：特定の条件に一致する物件数を取得します（軽量な操作）。

📦 インストール

1. このMCPサーバーをローカルマシンにクローンまたはダウンロードします

2. 依存関係をインストールします：

   cd batchdata-mcp-real-estate
   npm install
   

3. APIキーを設定します：

   • BatchData SettingsからAPIキーを取得するか、ここで登録します。
   • プロジェクトのルートに.envファイルを作成または更新します：

   BATCHDATA_API_KEY=your_actual_api_key_here
   

4. TypeScriptプロジェクトをビルドします：

   npm run build
   

5. サーバーをテストします：

   npm start
   

🚀 クイックセットアップ

自動化されたセットアップスクリプトを使用します：

Linux/macOS：

chmod +x setup.sh && ./setup.sh

Windows：

setup.bat

開発コマンド

• Build：npm run build - TypeScriptをJavaScriptにコンパイルします。
• Start：npm start - コンパイルされたJavaScriptサーバーを実行します。
• Dev：npm run dev - ビルドと実行を1つのコマンドで行います。
• Clean：npm run clean - コンパイルされたJavaScriptファイルを削除します。

Claude Desktopの設定

このMCPサーバーをClaude Desktopと共に使用するには、Claudeの設定ファイルに以下を追加します：

macOS

~/Library/Application Support/Claude/claude_desktop_config.jsonを編集します：

{
  "mcpServers": {
    "batchdata": {
      "command": "node",
      "args": ["/path/to/batchdata-mcp-real-estate/batchdata_mcp_server.js"],
      "env": {
        "BATCHDATA_API_KEY": "your_api_key_here"
      }
    }
  }
}

Windows

%APPDATA%\Claude\claude_desktop_config.jsonを編集します：

{
  "mcpServers": {
    "batchdata": {
      "command": "node",
      "args": ["C:\\path\\to\\batchdata-mcp-real-estate\\batchdata_mcp_server.js"],
      "env": {
        "BATCHDATA_API_KEY": "your_api_key_here"
      }
    }
  }
}

💻 使用例

フェニックスの物件数をカウントする

I need to count single-family homes in Phoenix, AZ between $250,000 and $600,000

類似物件を検索する

Find properties similar to 2800 N 24th St, Phoenix, AZ 85008 within 1 mile

住所を検証する

Verify this address: 2800 N 24th St, Phoenix, Arizona 85008

APIのレート制限

BatchData.ioの各エンドポイントのレート制限：

• 住所検証：最大5,000件（バッチあたり1,000件を推奨）
• 住所ジオコーディング：最大90件（バッチあたり75件を推奨）
• 物件検索：最大1,000件のリクエスト
• 物件照会：標準のAPI制限

環境変数

エラーハンドリング

サーバーには、以下のエラーに対する包括的なエラーハンドリングが含まれています：

• 無効なAPIキー
• ネットワークリクエストの失敗
• 不正なリクエスト
• APIのレート制限超過
• 無効なパラメーターの組み合わせ

依存関係

• @modelcontextprotocol/sdk：コアMCPフレームワーク
• zod：ランタイム型検証
• dotenv：環境変数の読み込み
• typescript：TypeScriptコンパイラ
• @types/node：Node.jsの型定義

コントリビュートについて

開発セットアップとガイドラインについては、CONTRIBUTING.mdを参照してください。

📄 ライセンス

MITライセンス - 詳細はLICENSEを参照してください。

サポート

• BatchData API：ドキュメント | ダッシュボード
• MCPプロトコル：ドキュメント
• 問題報告：GitHub Issues

不動産関係者および開発者の皆様：このMCPサーバーを使用することで、Claudeが自然言語クエリを通じて包括的な物件データにアクセスし、住所検証を行い、高度な物件検索を実施できるようになります。