realestate

@czagents/realestate

仅包含免费套餐。 捷克困境房地产情报——按区划汇总（破产和强制出售数量、价格趋势），数据来自公共法律登记簿：ISIR（破产）和 portál dražeb / CEVD（强制出售和执行）。不包含个人身份信息（PII）（无姓名、无地址）。为避免指认个人，困境线索为 1–4 条的区划会返回 null 计数，并附带 counts_band: "<5"（记录存在，但不披露确切数量）；0 显示为 0，≥5 时显示确切数量。低活跃度区划会标记为 low_activity（k<5）。

付费功能（完整房产搜索、所有者数据、单套房产详情）可通过托管端点使用： realestate-pro.cz-agents.dev——详见 https://cz-agents.dev/pricing.html。

安装

npm install -g @czagents/realestate

与 Claude Desktop 搭配使用

{
  "mcpServers": {
    "realestate": {
      "command": "npx",
      "args": ["-y", "@czagents/realestate"]
    }
  }
}

工具

免费套餐

• get_district_aggregate——返回来自 ISIR 和 portál dražeb / CEVD 的捷克区划级困境统计数据，包含分类计数和市场均价。请勿用它查找特定房产、所有者或地址，也不要据此推断被隐去的数量：1–4 条线索会按设计以 null 和 counts_band: "<5" 返回。示例：{"okres":"Beroun","window_days":90}。

付费工具（仅限托管版 realestate-pro）

以下工具不包含在此软件包中。它们仅可通过托管付费端点 https://realestate-pro.cz-agents.dev/mcp 使用：

• search_distress_properties——完整房产搜索，包含地址和所有者姓名（Reality Profesional / Agency 套餐）
• get_property_detail——单套房产完整详情，包括 RUIAN 地块、估价链接和 AI 风险评分（Reality Profesional 套餐及以上）

订阅详情请见 cz-agents.dev/pricing.html。

套餐

套餐	价格	可获得内容
Free（此软件包）	0 Kč	公共登记簿中的区划汇总数据；1–4 条线索归入 "<5" 档，k<5 时标记 low_activity，不包含个人 PII。
Reality Profesional	1 990 Kč/月	完整房产搜索和详情、所有者姓名、地址、RUIAN 地块、估价链接。通过托管端点提供。
Reality Agency	5 990 Kč/月	多席位、REST API 和 Webhook、更高的速率限制、批量搜索。通过托管端点提供。

GDPR / 选择退出

困境出售中列出的所有者数据依据 GDPR 第 6(1)(f) 条（合法利益、公共登记簿数据）进行处理。托管服务遵循选择退出登记簿：已请求移除信息的个人不会出现在任何响应中。

自托管（仅限免费套餐）

源码：https://github.com/martinhavel/cz-agents-mcp

git clone https://github.com/martinhavel/cz-agents-mcp
cd cz-agents-mcp
npm install
npm run build
node packages/realestate/dist/index.js

自托管需要具备读取兼容 cz-agents-webapp 的 SQLite 数据库的权限，其中的 RealEstateLead 和 OptOutEntry 表由上游项目的每日爬虫填充。此开源软件包仅提供免费套餐的汇总工具。

重大变更

0.2.0

已从此软件包中移除 search_distress_properties 和 get_property_detail。现在只能通过托管付费端点 realestate-pro.cz-agents.dev 使用。免费套餐汇总工具（get_district_aggregate）不受影响。

许可证

MIT——详见 LICENSE