rentfeed

rentfeed

rentfeed は、米国の賃貸物件情報を構造化データとして公開する、ホスト型の HousingFeed MCP サーバーへの小規模なローカルブリッジです。3つのツールのうち2つは キーなしで利用できます。サンプル検索では、地域と予算を指定して最大10件の最新 物件情報を取得でき、サマリーツールでは、1つの都市またはZIPコードについて、物件数と 募集賃料の中央値およびパーセンタイルを確認できます。残りの3つのツールでは、 HousingFeedからライセンスを取得したフィードを対象に、現在のステータス、検索可能な 物件情報、最新の週次更新での変更内容を確認できます。

このブリッジは物件情報を一切保存しません。ライブエンドポイントから取得した上流 サーバーのツール一覧をそのままローカルで提供し、各ツール呼び出しを上流に転送して、 結果を変更せずに返します。提供するのは物件情報のみで、予約、申し込み、メッセージ 送信、支払いのためのツールはありません。

ツール

• search_rentals_sample — 米国の最新賃貸物件情報を対象とした無料のサンプル検索です。 地域と予算を指定でき、1回の呼び出しで最大 10件を取得できます。省略可能な項目：state、city、min_rent、 max_rent、min_beds、max_beds、地図の範囲 （min_lat、max_lat、min_lng、max_lng）、 new_since_days、sort（best、newest、 cheapest、rent_desc）。
• rent_summary — 米国の1つの都市またはZIPコードの賃料統計です。 物件数と、募集賃料の中央値、25パーセンタイル値、75パーセンタイル値を、 全体および寝室数別に確認できます。必須項目：state。省略可能な項目： city、zip、beds（0 = ワンルーム、4 = 4室以上）、 include_rooms。
• feed_status — ライセンス取得済みフィードのステータスです。 物件数、公開日時、次回の週次更新予定日時、追加・変更・削除された物件数を確認できます。 HousingFeed のキーが必要です。
• search_my_feed — ライセンス取得済みフィード内の物件を、都市、ZIPコード、賃料、 寝室数または地図の範囲で検索します。offset によるページ分割に対応し、 1回の呼び出しで最大50件を取得できます。省略可能な項目：state、city、zip、 min_rent、max_rent、min_beds、max_beds、地図の範囲、 limit、offset、full。キーが必要です。
• feed_changes — フィードの最新の週次更新で追加、変更または削除された物件情報です。 省略可能な項目：change（added、changed、removed）、since、 limit（デフォルトは20）、offset。キーが必要です。

設定

• HOUSINGFEED_MCP_URL（省略可能）— 上流エンドポイントを上書きします。デフォルトは https://housingfeed.com/mcp です。（この上書き用の仕組みは、本再構築で独自に追加した ことを明記したものです。）
• HOUSINGFEED_API_KEY（省略可能）— 設定すると、すべての上流リクエストに、 ご自身の HousingFeed キーを含む Authorization: Bearer <key> ヘッダーが付加され、ライセンス取得済みの市場向けの 3つのフィードツールを利用できます。設定されていない場合、キーを含むヘッダーは 送信されず、キー不要のツールのみ利用できます。（ヘッダー名と Bearer 形式は、 元のレジストリ記録に基づいています。この環境変数からキーを転送する処理は、本再構築で 独自に追加したことを明記したものです。元のインターフェースはキーなしで取得されました。）

転送の仕組み

最初のツール呼び出し時に、クライアントは上流とのストリーミング可能な HTTP セッションを開始します。まず JSON-RPC の initialize リクエスト（protocolVersion 2025-03-26、 clientInfo name rentfeed）を送信し、次に notifications/initialized 通知を送り、その後、呼び出し元の引数を変更せずに含めた tools/call リクエストを送信します。上流が initialize に対して Mcp-Session-Id ヘッダーを返した場合、その値はセッション内の以降のすべての リクエストに付加され、プロセスの存続中は同じセッションが再利用されます。応答は 通常の JSON またはサーバー送信イベントとして届く場合があり、どちらも読み取ります。

上流からの成功結果は、上流が設定した isError フラグも含めて、そのまま返されます。 JSON-RPC エラー、2xx 以外のステータス、読み取り不能な応答、完了できないリクエストなどの 失敗は、テキストが rentfeed error: で始まる isError 結果として返されます （このエラー表示は、本再構築で独自に追加したことを明記したものです）。

CLI

各ツールは、JSON 引数文字列を1つ受け取るサブコマンドとしても実行できます。

npx @reneturcios/rentfeed search_rentals_sample '{"state":"NY","city":"Brooklyn","max_rent":3000}'
npx @reneturcios/rentfeed rent_summary '{"state":"TX","city":"Austin"}'
npx @reneturcios/rentfeed feed_status '{}'
npx @reneturcios/rentfeed --version

終了コード：成功時は 0、isError 結果の場合は 1、使用方法に誤りがある場合は 2。

MCP サーバー

npx -y @reneturcios/rentfeed mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "rentfeed": {
      "command": "npx",
      "args": ["-y", "@reneturcios/rentfeed", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/rentfeed
docker run --rm ghcr.io/cloudcorprecords/rentfeed --version

コンテナーのデフォルトコマンドは mcp です。そのため、最初の 形式は stdio MCP サーバーとして動作し、それ以外の引数は通常どおり CLI に渡されます。

開発

npm install
npm run build
npm test
npm run dev

テストスイートはすべて、スタブ化された JSON-RPC アップストリームを使用して実行されます。実際のネットワーク呼び出しはありません。

ライセンス

MIT — LICENSE を参照してください。