nycrentals

nycrentals

ニューヨーク市の住宅を、街の実際の区分に沿って検索できます。区と近隣エリアで検索する nycrentals は、ホスト型の Borough MCP サービスへの、薄い検証ブリッジです。マンハッタン、ブルックリン、クイーンズ、ブロンクス、スタテンアイランド全域の賃貸物件と売り出し中の住宅を探す、検索結果の物件や建物の詳細を開く、内見を申し込む前に近隣エリアの市場動向を確認するといった、10 個のツールを提供します。

このブリッジは 2 つの役割を担います。ツール一覧をローカルで提供し、あらゆる呼び出しについて、マシンから送信される前に検証します。引数の型、必須フィールド、サービス独自のルール（場所の指定方法は areas、location、locations のいずれか 1 つだけを選び、混在させないこと、手数料とツアーのフラグは有効にすることしかできないこと、売り出し物件の検索では仲介手数料のフラグを指定できないこと、1 回の検索で指定できるエリア ID は最大 10 個であること、比較する近隣エリアは 1 〜 5 か所であること）をチェックします。検証を通過した呼び出しは、1 度だけ開いて再利用する単一の上流セッションを介して転送されます。価格、写真、鮮度マーカーを含む物件情報など、サービスからの応答は一切変更されずに返されます。

10 個のツール：

• search_rentals — 5 つすべての区を対象に、価格、寝室と浴室の数、専有面積、アメニティ、建物の種類、ペットの可否、交通機関のスコア、インターネット速度で絞り込める、募集中の賃貸物件を検索します。手数料なし、オープンハウス、3D ツアーの切り替えにも対応しています。
• search_sales — 売買タイプの選択を追加した、同じ絞り込み条件で募集中の売り出し物件を検索します。
• get_property — 1 件の物件の詳細情報（価格、住所、寝室と浴室の数、アメニティ、ペットの可否、建物のスコア）を、チャットクライアントに適したコンパクトな形式で取得します。
• get_property_by_url — ID の代わりに物件 URL のパスを使って、同じ詳細情報を取得します。
• get_building — 建物のプロフィール（種類、竣工年、階数と住戸数、アメニティ、ポリシー、管理会社、減税措置の状況）を取得します。
• get_building_listings — 1 棟の建物に紐づく物件を、価格の安い順に取得します。
• list_areas — エリア一覧そのものを取得します。316 の近隣エリアとサブエリア、5 つの区、北部ニュージャージーの対象エリアが含まれ、ページ分割に対応しています。
• get_market_snapshot — 近隣エリアの最新の市場統計を取得します。
• get_market_trends — 近隣エリアの最近の価格変動を、日付とイベントタイプごとに 1 行で取得します。
• compare_neighborhoods — 1 〜 5 か所の近隣エリアを並べて比較します。

エリア ID は区ごとに 100 番台で割り当てられています。マンハッタンは 100、ブロンクスは 200、ブルックリンは 300、クイーンズは 400、スタテンアイランドは 500 で、各区内で近隣エリアに番号が付けられています。

設定

環境変数から読み込む認証情報は 1 つです：

export BOROUGH_API_KEY="..."

すべてのツールでキーが必要です。キーがない場合、呼び出しは BOROUGH_API_KEY is not set で直ちに失敗し、どこにも何も送信されません。アクセス権限の階層はホスト型サービスによって適用され、このブリッジでは適用されません。

CLI

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

npx @reneturcios/nycrentals search_rentals '{"location":"Brooklyn","maxPrice":3500,"noFee":true}'
npx @reneturcios/nycrentals get_property '{"id":"..."}'
npx @reneturcios/nycrentals compare_neighborhoods '{"locations":["Astoria","Jackson Heights"]}'
npx @reneturcios/nycrentals --version

出力は、転送された結果コンテンツを JSON 形式で表したものです。終了コード：成功時は 0、エラー結果時（検証エラーや上流の障害を含む）は 1、使用方法のエラー時は 2 です。

MCP サーバー

npx -y @reneturcios/nycrentals mcp

MCP クライアントの設定：

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

Docker

docker run -i -e BOROUGH_API_KEY="..." ghcr.io/cloudcorprecords/nycrentals
docker run --rm -e BOROUGH_API_KEY="..." ghcr.io/cloudcorprecords/nycrentals list_areas '{"level":1}'

開発

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

ライセンス

MIT — Copyright (c) 2026 Rene Turcios