Cenogram - Polish Real Estate Prices & Parcel Data

Cenogram MCP Server

面向 AI 的波兰房地产交易与地块数据

用于访问波兰房地产数据的 MCP 服务。直接从 Claude、Cursor、ChatGPT、Grok 或任何兼容 MCP 的 AI 助手中，访问来自国家价格与价值登记处（Rejestr Cen Nieruchomosci，RCN）的 800 多万笔房地产交易——这些是来自公证契约的价格，而非房源挂牌价。除了交易价格，该服务还能解析地籍地块，并提供每块地的背景信息：分区规划、洪水与滑坡风险、遗产登记、建筑许可与施工活动、公共交通可达性、农业用地分类、周边土地用途、自然环境——附近森林及与保护区的重叠情况——地下情况（采矿区和大型地下水储层）、土地用途与土壤质量分类，以及道路通达性。

数据来源：波兰国家 RCN 登记处（Rejestr Cen Nieruchomosci） | 平台：cenogram.pl

获取 API 密钥

1. 前往 cenogram.pl/api
2. 输入你的电子邮件地址
3. 你会通过电子邮件收到 cngrm_... API 密钥

在 cenogram.pl/ustawienia 管理密钥。

免费套餐

新账户可获得 1,000 个令牌和 Standard 套餐的 14 天试用期。此后，密钥仍可使用，每周提供 50 个令牌——余额每 7 天恢复至 50 个，而不是累积——且永不过期，也无需绑定银行卡。

统计、参考数据、地块身份信息和市镇背景信息的调用各需 1 个令牌；交易搜索需 3 个令牌（包括列表及其摘要；使用 summaryOnly 时需 1 个）；价格直方图或区域内地块列表需 2 个；地块或交易的一项背景信息图层需 4 个；空间搜索、地块轮廓、估值和多区县比较需 5 个；get_parcel_report 一次返回所有图层，需 45 个令牌。位置目录免费。付费套餐会提高可用额度——详情请见 cenogram.pl/api。

安装

选择你的客户端。以下所有选项均使用托管服务——无需本地安装（npx/stdio 除外）。

claude mcp add cenogram https://mcp.cenogram.pl/mcp \
  -t http -H "Authorization: Bearer YOUR_API_KEY"

[mcp_servers.cenogram]
url = "https://mcp.cenogram.pl/mcp"
bearer_token_env_var = "CENOGRAM_API_KEY"

export CENOGRAM_API_KEY=cngrm_...

[mcp_servers.cenogram]
url = "https://mcp.cenogram.pl/mcp"

codex mcp login cenogram

{
  "mcpServers": {
    "cenogram": {
      "type": "http",
      "url": "https://mcp.cenogram.pl/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "cenogram": {
      "command": "npx",
      "args": ["-y", "@cenogram/mcp-server@latest"],
      "env": {
        "CENOGRAM_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

{
  "servers": {
    "cenogram": {
      "type": "http",
      "url": "https://mcp.cenogram.pl/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "cenogram": {
      "type": "http",
      "url": "https://mcp.cenogram.pl/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

{
  "cenogram": {
    "type": "http",
    "url": "https://mcp.cenogram.pl/mcp",
    "headers": {
      "Authorization": "Bearer YOUR_API_KEY"
    }
  }
}

{
  "mcpServers": {
    "cenogram": {
      "command": "npx",
      "args": ["-y", "@cenogram/mcp-server@latest"],
      "env": {
        "CENOGRAM_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

配置

你也可以使用 --http CLI 标志来代替 MCP_TRANSPORT=http。

提示

• 模型选择：为获得最佳效果，请使用 Claude Opus。它会按顺序调用更多工具，并生成更丰富的分析。你可以在聊天窗口底部的下拉菜单中切换模型。

示例提示词

波兰语：

• “2025 年克拉科夫的公寓价格中位数是多少？”
• “显示莫科托夫区普瓦夫斯卡街 15 号的交易”
• “查找地块 126104_9.0015.201 上的交易”
• “查询地块 126104_9.0015.201 的地方规划和洪水风险”
• “查找弗罗茨瓦夫市中心 5km 范围内，价格超过 500 000 PLN 的土地交易”
• “比较莫科托夫区和沃拉区的公寓价格”
• “显示波兰房地产价格分布”

英语：

• “2025 年克拉科夫的公寓价格中位数是多少？”
• “显示莫科托夫区普瓦夫斯卡街 15 号的交易”
• “查找地块 126104_9.0015.201 上的所有交易，然后搜索附近区域”
• “查询地块 126104_9.0015.201 的分区规划和洪水风险”
• “查找弗罗茨瓦夫市中心 5km 范围内，价格超过 500,000 PLN 的土地交易”
• “比较莫科托夫区和沃拉区的公寓价格”
• “显示波兰房地产价格分布”

工具

地点命名

• 大多数城市：直接使用城市名称（例如，“Gdansk”“Lublin”）
• Warsaw：“Warszawa”涵盖全部 18 个区；指定一个区（“Mokotow”“Srodmiescie”“Wola”）可缩小范围
• Krakow 和 Lodz 的规则相同：城市名称涵盖所有下级区域，也可以指定一个区域（“Krakow-Podgorze”）
• 街区名称不是行政区划单位——请改用半径或多边形搜索
• 使用 list_locations 查找有效名称

房产类型

工作流

结果包含地块 ID 和 GPS 坐标，可用于开展多步研究：

1. Search by address    -> search_transactions(location="Mokotow", street="Pulawska", buildingNumber="15")
2. Note parcel_id and coordinates from results
3. Search nearby        -> search_by_area(lat=52.19, lng=21.01, radiusKm=2, propertyType="unit")
4. Compare prices       -> get_price_statistics(location="Mokotow")

这模拟了房地产估价师为估价报告查找可比交易的方式。

从土地而不是产权契据入手，是另一种途径：

1. List the parcels     -> list_parcels_in_area(location="Wawer", minArea=800)
2. Draw the ones you want -> list_parcels_in_area(bbox="21.10,52.20,21.14,52.23", includeGeometry=true)
3. Open one in full     -> get_parcel_report(parcelId="146518_8.0108.27")

步骤 1 使用游标分页；步骤 2 有结果上限，通常会被截断，因此应缩小搜索框，而不要把截断的回答当作该区域的地块列表。

数据

• 800 万笔以上交易，覆盖波兰全境（380 个县）
• **日期范围：**2003 年至今
• **来源：**波兰国家 RCN 登记处（Rejestr Cen Nieruchomosci）
• **更新：**定期从 RCN 更新
• **每块地的背景信息：**分区规划、洪水和滑坡风险、遗产登记、建筑许可和施工活动、公共交通可达性、农业用地用途、周边环境、自然环境（附近森林和保护区）、地下情况（采矿地带和主要地下水储量）、土地用途和土壤质量分类，以及道路可达性——可通过地籍 ID 查询

故障排除

“Error: CENOGRAM_API_KEY is required” —— 这仅适用于 stdio 模式。请确保在 MCP 配置的 env 区块中设置了 CENOGRAM_API_KEY。对于 HTTP 远程模式，应将密钥放入 Authorization 标头。

npx 卡住或失败 —— 使用 node -v 检查 Node.js 版本。stdio 模式要求 Node.js >= 18。如果使用的是更早版本，请改用 HTTP 远程选项（无需 Node.js）。

地点返回 0 条结果 —— 该名称可能不是行政区划单位。区和街区是两种不同的区域：“Mokotow”是一个区，可以正常使用；“Sluzew”是区内的一个街区，无法使用。请使用 list_locations(search="...") 查找有效名称，或者对于小于一个区的区域，使用半径搜索（search_by_area）。

401 Unauthorized（HTTP 模式） —— 服务接受 API 密钥（Authorization: Bearer cngrm_...，需包含 Bearer 前缀和完整密钥，而不只是前缀），或接受已完成 OAuth 登录的客户端提供的 OAuth 访问令牌。如果缺少令牌，或令牌格式无法识别，就会返回 401；响应正文会链接至 cenogram.pl/api，可在此获取密钥。既没有密钥也没有 OAuth 登录的客户端（例如 Codex CLI）每次请求都会收到 401——请参阅上方的设置说明。

402 Payment Required —— 账户的令牌已用完。免费账户的响应会说明余额每周恢复至 50 的日期；在此之前，密钥和连接仍然有效。付费方案可解除限制——请参阅 cenogram.pl/api。

开发

git clone https://github.com/cenogram/mcp-server.git
cd mcp-server
npm install
npm test
npm run build

许可证

MIT