Catastro GPS

Catastro GPS MCP 服务

为 AI Agent 提供来自 **29 个欧洲国家（包括巴斯克地区和纳瓦拉的地方地籍）**的官方地籍地块数据，只需一个 API 密钥：27 个国家可通过地籍编号查询，全部 29 个国家可通过坐标查询。在克罗地亚（ARKOD 农业地块）、瑞典（农业区块）和苏格兰（通过坐标查询），数据源并非完整地籍。

让你的 Agent 按地籍编号、地图上的点或邮政地址查询地块。它会返回地籍编号、位置、面积、土地用途和地块轮廓；还可以列出西班牙建筑中的每个住宅单元，读取地形起伏、保护区、气候常年值和卫星地表运动数据，估算太阳能和农业潜力，读取汇总后的市场价格，并为地块评分和比较。

• 29 个国家，一种调用格式。 ES、PT、FR、IT、DE、PL、NL、CH……以及西班牙中央 Catastro 不提供服务的两个地方地籍（PV、NA）。
• 国家为可选项。 系统会根据编号格式或坐标自动识别。当纯数字符合多个国家的格式时，API 会提示（CNV_AMBIGUOUS），而 resolve_reference 会免费告诉你符合哪些国家。
• 27 个国家支持地址搜索。 "Calle Gran Via 31, Madrid"、"8 boulevard du Port, Amiens" 或 "Damrak 1, 1012 LG Amsterdam" 都会转换为排序后的地块结果。
• 建筑，不只是地块。 get_units 会列出西班牙建筑中的每个住宅、商铺和车库，以及楼层、门牌、面积和共有份额系数。
• 每个答复都包含你的配额。 每个结果都会显示剩余月配额、预付余额和每分钟可用额度。
• 永久免费套餐。 每月 250 次免费调用，无需银行卡。查询失败不收费。

在 parcelgps.com/developers 获取密钥。

安装

远程服务，无需安装

服务运行于 https://mcp.parcelgps.com/mcp（Streamable HTTP）。每次工具调用都使用你自己的密钥，因此会计入你自己的配额。列出工具无需密钥。

Claude Code

claude mcp add --transport http parcel-gps https://mcp.parcelgps.com/mcp --header "Authorization: Bearer pk_live_your_key_here"

Cursor、VS Code、Windsurf（mcp.json）

{
  "mcpServers": {
    "parcel-gps": {
      "url": "https://mcp.parcelgps.com/mcp",
      "headers": { "Authorization": "Bearer pk_live_your_key_here" }
    }
  }
}

Claude.ai 和 ChatGPT 自定义连接器，或任何只接受 URL 的客户端：将密钥放入 URL，并妥善保密。

https://mcp.parcelgps.com/mcp?api_key=pk_live_your_key_here

也可以在 X-API-Key 标头中提供密钥。

Claude Desktop

{
  "mcpServers": {
    "catastro-gps": {
      "command": "npx",
      "args": ["-y", "catastro-gps-mcp"],
      "env": { "CATASTROGPS_API_KEY": "pk_live_your_key_here" }
    }
  }
}

Claude Code

claude mcp add catastro-gps --env CATASTROGPS_API_KEY=pk_live_your_key_here -- npx -y catastro-gps-mcp

Cursor、Windsurf、VS Code 和其他 MCP 客户端

使用相同的 npx -y catastro-gps-mcp 命令，并在环境中设置 CATASTROGPS_API_KEY。

工具

工具	功能说明	国家/地区
get_parcel	通过地籍参考编号 或 WGS84 坐标查询地块：参考编号、位置、地址、市镇、面积、土地用途、轮廓、农作物子地块数量和作物摘要（作物名称可通过 lang 指定语言）	全部 29 个国家/地区，包括巴斯克地区和纳瓦拉（英国和 HR 仅支持坐标）
search_address	输入自由格式的邮政地址，搜索按相关度排序的地块，并返回置信度，以及门牌号和市镇是否匹配	ES（包括 PV 和 NA 的入口）以及 FR、IT、DE、AT、NL、BE、PL、CH、CZ、DK、NO、FI、EE、LV、LT、SI、SK、BG、GR、CY、LU、LI、IS、IE、UK、PT
get_units	查询西班牙建筑中的所有单元（住宅、商铺、车库、储藏室）：楼梯、楼层、门牌、用途、面积、产权比例、年份。支持分页，每页 200 条	ES、PV、NA
resolve_reference	免费且不限额：判断文本是参考编号、坐标还是地名，并确定所属国家/地区	全部
get_parcel_subparcels	查询地块中的所有农作物或土地用途部分：作物代码、10 种语言的作物名称、原始标签、面积、土地用途类别、来源和（可选）轮廓。来源查询失败时返回 SUB_001，不收费	ES（包括 Bizkaia、Álava、Navarre、Gipuzkoa）、AT、DE、CZ、NL、FR、PT、SE、CH、FI、BE、IE、SI、EE、GR
get_parcel_sigpac	查询西班牙地块中的所有 SIGPAC 围栏单元（recinto）：10 种语言的土地用途代码和名称、面积（ha）、灌溉系数、坡度、海拔、CAP 牧场资格及区域、事件，以及（可选）轮廓。引用时注明 “Fuente: FEGA — SIGPAC”。SIGPAC 查询失败时返回 SIG_001，不收费	ES、PV、NA
get_crop_catalog	免费且不限额：查询所有作物代码，以及所选语言的名称和土地用途类别	所有作物目录
get_neighbors	查询与该地块接壤或环绕该地块的地块（最多 60 个），并返回参考编号和中心点	ES 数据来自地籍；其他地区使用我们自己的副本（不支持时为 supported: false）
list_provinces、list_municipalities、list_streets	查询西班牙地籍中的省、市镇（含 INE 代码）以及市镇街道	ES（共同领土）
get_boundaries	以 GeoJSON / [lat, lng] 环形坐标返回地块轮廓、质心和面积	30 个代码（除 UK 外全部支持）
get_terrain	查询地块轮廓上的地形（Copernicus DEM GLO-30）、Natura 2000 / 保护区（EEA）和 ERA5-Land 气候常值及近期变化	所有参考编号所属国家/地区，HR 除外；在 ES、PV、NA、PT、FR、IT、DE 以外的地区，请传入 latitude/longitude
get_ground_motion	查询卫星测量的地面运动（Copernicus EGMS，2020-2024）：沉降或抬升速度（mm/year）、下沉最快的网格单元、东西向运动、年度位移；无雷达反射器时会明确说明	与 get_terrain 相同
get_solar_potential	PVGIS 光伏估算：kWp、kWh/year、节省金额、投资回收期、CO2、倾角	ES、PV、NA、PT、FR、IT、DE
get_agriculture	土地用途、主要作物、NDVI 和参考作物价格（西班牙提供 SIGPAC 详情）	ES、PV、NA、PT、FR、IT、DE
get_market_data	农村土地价格，仅限付费 API 方案。绝不提供单笔交易或住房数据	ES、PV、NA：仅农村地块，允许小型农业建筑（crop_prices、zone_prices.rural）；其他情况均返回 MKT_001，不收费
get_investment_score	0-100 分的评分，包含评级和定性因素等级（高 / 中 / 低 / 不可用）	ES、PV、NA、PT、FR、IT、DE
get_value_history	查询地块随时间变化的面积和土地用途快照	ES、PV、NA、PT、FR、IT、DE、AT
compare_parcels	并排比较两到三个地块：位置、太阳能、农业、评分	ES、PT、FR、IT、DE（不包括 PV 或 NA）

配额、预付余额和限制

• 只有包含数据的成功答复才会消耗配额：未找到、校验错误、CNV_COVERAGE、CNV_AMBIGUOUS、5xx 错误以及不含数据的答复（available: false）均免费。resolve_reference 和 get_crop_catalog 从不消耗配额；如果地块没有子地块或 SIGPAC 数据，get_parcel_subparcels 和 get_parcel_sigpac 也免费。
• 每次成功调用消耗 1 个单位，但 get_units 除外（每个页面返回的单位消耗 1 个单位，最低消耗 1 个），compare_parcels 除外（每个找到的地块消耗 1 个）。
• 每个结果都包含一个从同一响应中读取的 quota 对象，其中有：remaining、limit、resets_at、plan，以及在适用时的 prepaid_overage、prepaid_balance_eur、overage_units_left、per_minute_remaining，还有适用于 get_units 且合同设有每个农场上限时的 finca_cap / finca_cap_used。
• 月度配额用尽后，如果你有预付余额，API 不会停止服务：每个额外单位都会从余额中扣除（可在 parcelgps.com/app/developer 充值）。如果配额已用完且没有余额，调用会返回 KEY_AUTH_004（HTTP 429，绝不会是 402）；错误信息会说明是需要充值还是升级，以及配额何时重置。
• 另有每分钟调用次数限制，具体取决于套餐（Free 为 10 次、Developer 为 60 次、Startup 为 120 次、Growth 为 300 次；同时还适用全局每 IP 限制）。超过限制时会返回 KEY_RATE_002，并告知需要等待的秒数。

市场、评分和历史工具能告诉你什么、不能告诉你什么

• get_market_data 仅适用于付费 API 套餐（Free 套餐的密钥会返回 KEY_PLAN_001，且不收费），并且只适用于农村土地价格：西班牙的农业地块（包括巴斯克地区和纳瓦拉），以及允许存在的小型农业建筑（棚屋、农场商店、池塘、温室）；返回的是土地价格，不对建筑进行估价。它会返回 crop_prices（地块各作物组的每公顷价格及其背后的销售数量）和 zone_prices.rural（该省农地每公顷价格）。住宅、工业或任何其他非农业地产均不受支持，会返回 MKT_001 且不收费；没有价格的农村土地和其他国家的土地也会如此。
• get_investment_score 会综合 API 针对地块所能获取的信息：所有可响应地区均提供太阳能潜力和农业用途信息；市场价格仅适用于法国、意大利和德国（NRW）。目前尚未计算可达性和风险，因此这两项会返回 not_available，评分只相对于已有数据的因素。你会获得分数、评级和定性因素等级，但不会获得权重。
• get_value_history 会在有人首次通过 Catastro GPS 查询该地块时开始记录（每 30 天最多生成一个快照）。从未有人查询过的地块会返回空列表。它会记录面积和土地用途；目前尚未记录官方地籍价值，因此 cadastral_value_eur 始终为 null，而 change_pct 表示面积变化。
• compare_parcels 仅对西班牙地块补充面积、土地用途和市镇信息；对葡萄牙、法国、意大利和德国的地块，则返回位置、太阳能、农业和评分信息。不包含市场价格。未找到的地块会返回错误，但仍会比较其他地块。

覆盖范围

截至 2026 年 10 月 1 日，各代码目前支持的范围（以生产环境数据为准）。“部分”表示官方数据源未覆盖整个地区。

Code	国家 / 地区	按参考编号查询	按坐标查询	地址搜索	备注
ES	西班牙（中央 Catastro）	是	是	是	建筑物和住宅可使用 get_units
PV	巴斯克地区（Araba、Bizkaia、Gipuzkoa）	是	是	使用 country: ES	福拉尔地籍；get_units 不含参与系数
NA	纳瓦拉	是	是	使用 country: ES	福拉尔地籍；get_units
FR	法国	是	是	是
IT	意大利	是	是	是
DE	德国	部分	部分	部分	16 个联邦州中覆盖 15 个：不包括巴伐利亚
AT	奥地利	是	是	是
NL	荷兰	是	是	是
BE	比利时	是	是（数据源较慢）	是
PL	波兰	是	是	是	TERYT 地块 ID
CH	瑞士	是	部分	是	不包括不公开地块信息的州（如沃州）
CZ DK NO FI EE	捷克、丹麦、挪威、芬兰、爱沙尼亚	是	是	是
LT SI SK BG	立陶宛、斯洛文尼亚、斯洛伐克、保加利亚	是	是	是
LU LI IS	卢森堡、列支敦士登、冰岛	是	是	是
CY	塞浦路斯	是	是	是，置信度较低	已映射的门牌号较少
LV	拉脱维亚	使用 country: LV	是	是
GR	希腊	使用 country: GR	是	是
PT	葡萄牙	是	部分	部分	地籍不覆盖里斯本、波尔图或科英布拉；DGT 数据源经常无法访问
IE	爱尔兰	使用 country: IE（SP_ID）	部分	部分
UK	英国	否	仅苏格兰	仅苏格兰	英格兰、威尔士和北爱尔兰尚未覆盖
HR	克罗地亚	否	仅 ARKOD 农业地块	否	没有开放地籍数据；不包括萨格勒布或里耶卡
SE	瑞典	农业地块	农业地块	否	不包括产权单元

匈牙利、罗马尼亚和欧洲其他地区尚未覆盖：查询这些地区的参考编号或坐标会返回 CNV_COVERAGE。数据来自各国官方地籍或 INSPIRE 服务（西班牙数据来自我们保存的 Catastro 副本），因此数据可用性取决于这些数据源；如果某个数据源中断，服务会返回 SERVICE_UNAVAILABLE，该错误免费。

可通过 catastrogps.es 订购官方登记文件（西班牙的 nota simple、意大利的 visura、葡萄牙的 certidão permanente 等）。目前这些文件尚未通过 API 或此服务提供。

示例

向你的 Agent 提问：

查找巴塞罗那 Calle Mallorca 213 的地籍地块，并告诉我其面积和边界。

列出 Dos Hermanas Avenida Jose Rodriguez de la Borbolla 10 这栋建筑内的所有公寓，并提供楼层、门牌和面积。

地块 30024A16000286 下方的地面是否正在下沉？它是否位于 Natura 2000 保护区内？

52.2297, 21.0122 处的地块是什么？面积是多少？

查询波兰地块 146510_8.0502.1/3，并告诉我其面积。

比较纳瓦拉和葡萄牙这两个乡村地块的太阳能潜力。

比较西班牙、法国和意大利的这三个地块，并告诉我哪一个的投资评分最高。

法国地块 75056000AB0001 周边的土地价格如何？

get_parcel 调用的返回内容（已缩短；数值仅供示例）：

{
  "reference": "9872023VH5797S0001WX",
  "country": "ES",
  "latitude": 40.4165,
  "longitude": -3.7038,
  "address": "CL MAYOR 1",
  "municipality": "MADRID",
  "region": "MADRID",
  "area_m2": 512,
  "land_use": "Residencial",
  "outline_lat_lng": [[40.41662, -3.70391], [40.41671, -3.70362], "..."],
  "google_maps_url": "https://maps.google.com/?q=40.4165,-3.7038"
}

每次调用都会访问英文 v1 REST API（https://api.parcelgps.com/v1/...），因此 agriculture、relief 或 ground_motion 等嵌套块使用与 API 文档相同的英文 camelCase 字段名。

错误会以代码和一句 Agent 可据此采取行动的说明返回，例如：

CNV_COVERAGE: That reference or point is in a country that is not covered yet.
SERVICE_UNAVAILABLE: The official cadastre for this country is not responding. Try again in a few minutes.
KEY_AUTH_004: Monthly quota used up and prepaid balance empty: top up at https://parcelgps.com/app/developer (or upgrade at https://www.parcelgps.com/developers).

定价

同一个密钥可用于此服务、REST API 和 SDK（npm 和 PyPI 上的 catastrogps）。

套餐	价格	每月调用次数
免费	€0，永久有效	250
开发者	每月 €19	5,000
Startup	每月 €49	15,000
Growth	每月 €99	50,000
Enterprise	联系我们	自定义

详情和注册：parcelgps.com/developers。

配置

变量	必填	默认值	说明
CATASTROGPS_API_KEY	是		你的 API 密钥
CATASTROGPS_TIMEOUT	否	20000	请求超时时间，单位为 ms。官方地籍系统可能响应较慢
CATASTROGPS_API_URL	否	https://api.parcelgps.com	API 基础 URL

开发

npm install
npm run lint
npm test
npm run test:coverage
npm run build
CATASTROGPS_API_KEY=pk_live_xxx node build/index.js
node build/http.js

许可证

MIT