NYC Property Intel

NYC Property Intel

为 Claude AI 提供访问 20 多个 NYC 公共记录数据集的 MCP 服务，适用于房地产尽职调查。用日常语言向 Claude 询问任意 NYC 房产信息——违规记录、留置权、销售历史、所有权、许可证、租金稳定政策、分区、火灾历史、犯罪数据等。

这是尽职调查工具，不是估价工具。 它仅呈现公共记录数据，不会估算房产价值。

快速入门 — 网页聊天（无需设置）

最快的试用方式：打开 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 驱逐历史 — City Marshal 执行的驱逐记录，2017 年至今
• 检查你是否有驱逐记录（NYC） — 面向租户的法院记录、筛查档案和权利指南

快速入门 — Claude Code / Desktop（托管 MCP）

在 nycpropertyintel.com 注册以获取免费试用令牌（30 天内每天 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	将任何纽约市地址或 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	可配置半径范围内的 NYPD 犯罪投诉（默认 300 m ≈ 3 个街区）。包括重罪/轻罪分类、主要罪名和同比趋势。
analyze_property	完整的尽职调查摘要——并发运行所有子查询。包括物业档案、FAR 分析、财务信息、风险因素、租金稳定管制信息、可比销售记录和主要观察结果。

---

数据源

核心数据（约 1,900 万行）来自 nycdb。所有数据集均加载到 PostgreSQL 中。仅在备用情况下使用 Socrata API。

数据集	机构	备注
PLUTO	DCP	房产档案、分区、FAR、建筑类别
PAD	DCP	地址到 BBL 的解析
HPD Violations	HPD	按类别和状态划分的住房法规违规记录
HPD Complaints	HPD	租户投诉记录
HPD Registrations	HPD	所有人／代理人／主管登记信息
HPD Litigations	HPD	住房法院案件
DOB Violations	DOB	建筑法规违规记录
ECB Violations	OATH/ECB	环境管制委员会处罚
DOF Rolling Sales	DOF	近期房产销售
DOF Annual Sales	DOF	2003 年至今的历史销售记录
DOF Assessments	DOF	税务估值和评估清单
DOF Exemptions	DOF	税务豁免记录（421a、J-51、STAR）
DOF Tax Liens	DOF	年度留置权拍卖清单
Rent Stabilization	DOF	按建筑划分的租金稳定房源数量，2007–2017 年（根据 taxbills.nyc / JustFix 提供的 DOF 税单数据整理）
ACRIS	DOF	契据、抵押、留置权、清偿记录、UCC 备案
FDNY Fire Incidents	FDNY	2013 年至今
311 Service Requests	311/DOITT	2010 年至今
Marshal Evictions	DOI	2017 年至今
DOB Complaints	DOB	从 NYC Open Data 加载
NYPD Crime Data	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