NYC Property Intel

NYC Property Intel

不動産のデューデリジェンス向けに、Claude AI が NYC の20以上の公開記録データセットにアクセスできる MCP サーバーです。自然な英語で NYC のあらゆる物件について Claude に質問できます。違反、先取特権、売却履歴、所有権、許可、家賃安定化、ゾーニング、火災履歴、犯罪データなどを調べられます。

これはデューデリジェンスツールであり、査定ツールではありません。 公開記録データのみを表示し、物件価格の推定は行いません。

クイックスタート — Web チャット（セットアップ不要）

手軽に試すには、nycpropertyintel.com/chat を開き、自然な英語で NYC のあらゆる物件について質問してください。登録不要で、3件の無料クエリを利用できます。インストール、トークン、Claude クライアントは不要です。

"What violations does 123 Atlantic Ave, Brooklyn have?"

無料ガイドと検索

• NYC 物件デューデリジェンスチェックリスト — 20以上の市のデータソースを網羅した、購入オファー前の完全なチェックリスト
• NYC HPD 違反検索 — 住所別のクラス A／B／C の内訳
• NYC DOB・ECB 違反検索 — 未解決の違反、ECB の罰金、Local Law 153 による先取特権のリスク
• NYC 物件所有者検索 — LLC の背後にいる所有者と HPD の連絡先
• 住所別 NYC 立ち退き履歴 — 市の執行官による執行済みの立ち退き（2017年から現在まで）
• NYC で自分の記録に立ち退き履歴があるか確認する — 裁判記録、審査記録、権利についての借主向けガイド

クイックスタート — Claude Code／Desktop（ホスト型 MCP）

nycpropertyintel.com で登録して、無料トライアルトークンを取得してください（30日間、1日10件のクエリ、最大5件の完全なデューデリジェンスレポートを含む）。その後、次の手順に進みます。

Claude Code — ターミナルで一度実行します。

claude mcp add --transport http nyc-property-intel \
  "https://nyc-property-intel-production.up.railway.app/mcp" \
  --header "Authorization: Bearer YOUR_TOKEN" \
  --scope user

Claude Desktop — claude_desktop_config.json に追加します（Settings → Developer → Edit Config）。

{
  "mcpServers": {
    "nyc-property-intel": {
      "type": "http",
      "url": "https://nyc-property-intel-production.up.railway.app/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

次に、Claude に質問します。

"Look up 350 5th Ave, Manhattan"
"What violations does 123 Atlantic Ave, Brooklyn have?"
"Full due diligence on 123 Atlantic Ave, Brooklyn"

---

セルフホスト

前提条件

• Python 3.12+
• uv パッケージマネージャー
• PostgreSQL 16+
• nycdb CLI（pip install nycdb）

1. クローンしてインストール

git clone https://github.com/ccedacero/nyc-property-intel.git
cd nyc-property-intel
uv sync

2. 環境を設定

cp .env.example .env
# Edit .env:
#   DATABASE_URL=postgresql://nycdb:nycdb@localhost:5432/nycdb
#   NYC_GEOCLIENT_SUBSCRIPTION_KEY=your_key  (optional, improves address resolution)
#   SOCRATA_APP_TOKEN=your_token             (optional, higher rate limits for 311/FDNY/NYPD)

3. データベースをセットアップ

オプション A：ダンプから復元（約10分）

createuser -s nycdb 2>/dev/null; createdb -O nycdb nycdb 2>/dev/null
pg_restore -U nycdb -d nycdb --no-owner --jobs=4 data/nycdb.dump

オプション B：ソースから読み込み（約2.5時間）

createuser -s nycdb 2>/dev/null; createdb -O nycdb nycdb 2>/dev/null
chmod +x scripts/seed_nycdb.sh
./scripts/seed_nycdb.sh              # all phases
# or incrementally:
./scripts/seed_nycdb.sh --phase A    # core data (~30 min)
./scripts/seed_nycdb.sh --phase B    # sales + DOB (~45 min)
./scripts/seed_nycdb.sh --phase C    # ACRIS + permits (~90 min)

次に、インデックスとマテリアライズドビューを作成します。

psql -U nycdb -d nycdb -f scripts/create_indexes.sql
psql -U nycdb -d nycdb -f scripts/create_views.sql

4. Claude Desktop に追加

{
  "mcpServers": {
    "nyc-property-intel": {
      "command": "uv",
      "args": ["run", "nyc-property-intel"],
      "cwd": "/absolute/path/to/nyc-property-intel",
      "env": {
        "DATABASE_URL": "postgresql://nycdb:nycdb@localhost:5432/nycdb"
      }
    }
  }
}

5. Claude Code に追加

プロジェクトのルートにある .mcp.json は、このディレクトリを開くと自動で登録されます。または、~/.claude.json に手動で追加します。

{
  "mcpServers": {
    "nyc-property-intel": {
      "command": "uv",
      "args": ["run", "nyc-property-intel"],
      "cwd": "/absolute/path/to/nyc-property-intel"
    }
  }
}

---

18 個のツール

ツール	説明
lookup_property	NYC の住所または BBL から、所有者、建物クラス、ゾーニング、FAR、評価額、敷地の寸法を含む完全な物件プロフィールを取得します。必ず最初に呼び出してください。
get_property_issues	HPD の住宅違反（クラス A／B／C）、DOB の建築基準違反、ECB／OATH の金銭的罰則を取得します。重大度、ステータス、日付で絞り込めます。
get_property_history	DOF の売買記録と ACRIS の権利証書移転記録を取得します。価格の推移、買主／売主の氏名、書類の種類を 2003 年までさかのぼって確認できます。
get_hpd_complaints	入居者から報告された HPD への苦情を取得します。正式な違反が発行される前に建物の問題を示す先行指標です。
get_hpd_litigations	HPD の住宅裁判所案件、未解決の判決、建物所有者に対する嫌がらせの認定を取得します。
get_hpd_registration	法的な所有者、管理代理人、代表役員の登録記録を取得します。
get_building_permits	DOB の工事申請を取得します。新築、改修、解体、看板の許可が対象です。ステータス、見積費用、申請者名を確認できます。
get_liens_and_encumbrances	DOF の税金先取特権売却リストへの登録情報と ACRIS の抵当権記録を取得します。未解消の先取特権、貸し手の名称、金額、弁済記録を確認できます。
get_tax_info	税評価額、市場価値の推定額、課税価格、適用中の免税措置（421a、J-51、STAR）を取得します。
get_rent_stabilization	年別の家賃安定化対象ユニット数（2007～2017 年）を取得します。規制解除の兆候を把握するための傾向分析に利用できます。
search_comps	郵便番号別の類似物件の売買情報を検索します。建物クラス、価格、日付で絞り込めます。四半期ごとの市場統計も含まれます。
search_neighborhood_stats	地域単位の集計情報を取得します。物件ストック、売買価格の中央値、違反率、家賃安定化対象物件の割合が含まれます。
get_fdny_fire_incidents	FDNY の火災・緊急事態の履歴を取得します。火災の種類、警報レベル、延焼、死傷者、継続時間を確認できます。2013 年から現在までのデータを NYC Open Data から読み込みます。
get_311_complaints	物件またはその近隣における 311 へのサービスリクエストを取得します。騒音、げっ歯類、暖房、不法投棄など、200 種類以上が対象です。2010 年から現在までのデータを NYC Open Data から読み込みます。
get_evictions	住所別に執行官が実施した立ち退きを取得します。住宅用と商業用が対象です。2017 年から現在までのデータを NYC Open Data から読み込みます。
get_dob_complaints	正式な違反に先立って提出された DOB への苦情を取得します。建設や安全上の問題を示す、最も早い段階の公開情報です。
get_nypd_crime	設定可能な半径（デフォルトは 300 m ≈ 3 ブロック）内の NYPD 犯罪通報を取得します。重罪／軽犯罪の内訳、主な犯罪、前年比の傾向を確認できます。
analyze_property	すべてのサブクエリを並行実行し、包括的なデューデリジェンスの概要を作成します。物件プロフィール、FAR 分析、財務情報、リスク要因、家賃安定化、類似物件の売買情報、主な所見が含まれます。

---

データソース

コアデータ（約1,900万行）はnycdbから読み込まれます。すべてのデータセットはPostgreSQLに読み込まれます。Socrata APIはフォールバックとしてのみ使用されます。

データセット	機関	備考
PLUTO	DCP	不動産の概要、ゾーニング、FAR、建物クラス
PAD	DCP	住所からBBLへの解決
HPD違反	HPD	クラスとステータス別の住宅法違反
HPD苦情	HPD	入居者からの苦情記録
HPD登録	HPD	所有者／代理人／役員の登録
HPD訴訟	HPD	住宅裁判所の案件
DOB違反	DOB	建築基準法違反
ECB違反	OATH/ECB	環境管理委員会による罰則
DOFローリング売買記録	DOF	最近の不動産売買
DOF年間売買記録	DOF	2003年から現在までの売買履歴
DOF評価額	DOF	税務評価額と評価記録
DOF免税	DOF	税の免除記録（421a、J-51、STAR）
DOF税先取特権	DOF	年次の先取特権売却リスト
家賃安定化	DOF	建物ごとの安定化対象住戸数、2007～2017年（taxbills.nyc / JustFix経由のDOF納税通知書から算出）
ACRIS	DOF	不動産譲渡証書、抵当権、先取特権、抹消、UCC申請
FDNY火災事故	FDNY	2013年から現在まで
311サービスリクエスト	311/DOITT	2010年から現在まで
マーシャルによる立ち退き	DOI	2017年から現在まで
DOB苦情	DOB	NYC Open Dataから読み込み
NYPD犯罪データ	NYPD	2006年から現在まで、地理空間半径

---

アーキテクチャ

src/nyc_property_intel/
  app.py              # FastMCP instance + system prompt
  server.py           # Entry point: lifespan, auth middleware, tool registration
  config.py           # pydantic-settings (reads .env / environment variables)
  db.py               # asyncpg connection pool + query helpers
  auth.py             # Token validation, rate limiting, usage logging
  analytics.py        # PostHog event capture (fire-and-forget)
  geoclient.py        # NYC GeoClient API + PAD fallback for address resolution
  socrata.py          # Socrata Open Data API client — fallback for FDNY, 311, NYPD, evictions
  loops_webhook.py    # Loops.so webhook → auto-provision trial tokens on signup
  tools/
    lookup.py         # lookup_property
    issues.py         # get_property_issues
    history.py        # get_property_history
    hpd_complaints.py # get_hpd_complaints
    hpd_litigations.py# get_hpd_litigations
    hpd_registration.py# get_hpd_registration
    permits.py        # get_building_permits
    liens.py          # get_liens_and_encumbrances
    tax.py            # get_tax_info
    rentstab.py       # get_rent_stabilization
    comps.py          # search_comps
    neighborhood.py   # search_neighborhood_stats
    fdny.py           # get_fdny_fire_incidents
    complaints_311.py # get_311_complaints
    evictions.py      # get_evictions
    dob_complaints.py # get_dob_complaints
    nypd_crime.py     # get_nypd_crime
    analysis.py       # analyze_property
scripts/
  seed_nycdb.sh         # Downloads and loads all nycdb datasets
  create_indexes.sql    # Performance indexes on critical columns
  create_views.sql      # Materialized views for fast property lookup
  manage_tokens.py      # CLI for provisioning and managing customer tokens

---

開発

uv run pytest tests/test_utils.py -q          # unit tests (no DB needed)
uv run pytest tests/ -m integration -q        # integration tests (needs live DB)
uv run ruff check src/                         # lint
uv run nyc-property-intel                      # run server locally (stdio)

---

公正な住宅提供

NYC Property Intelは、市の公開記録に基づく建物および不動産のデータのみを提供します。人口統計データ、入居者審査、または保護対象の特性に基づく分析は提供しません。ポリシーの全文はnycpropertyintel.com/#fair-housingをご覧ください。

ライセンス

MIT