西班牙地籍API老旧SOAP被弃，开发者构建JSON封装与MCP

背景

西班牙的地籍数据（Catastro）虽然公开可获取，但其官方API自2003年起一直使用SOAP/XML协议，接口笨重、错误信息不遵循HTTP状态码规范、数据结构面向人工阅读而非机器消费。对于房地产科技（proptech）公司、不动产中介以及依赖API的AI代理来说，直接对接官方系统意味着大量时间浪费在解析XML和处理异常上，同时消耗不必要的token成本。

在此背景下，开发者构建了Predio——一个基于JSON的REST + MCP封装层，将西班牙地籍的SOAP能力转化为现代、结构化的API，并额外提供MCP（Model Context Protocol）服务器，使Claude、GPT等AI代理可以直接调用地籍数据。

核心内容

Predio是一个非官方服务，从西班牙地籍总局（Dirección General del Catastro，DGC）的官方电子站点获取数据，经过清洗、规范化和缓存后通过REST和MCP接口输出。其核心功能如下：

三种查询入口，统一输出格式

用户可以通过以下任意方式查询西班牙境内的不动产（urbano（城市）和 rústico（乡村）两种类型采用同一输出结构）：

• 根据地籍参考编号（Referencia Catastral）：20字符的RC码直接定位物业。
  curl https://api.prediohq.com/v1/inmueble/9872023VH5797S0001WX -H "x-api-key: $PREDIO_API_KEY"

• 根据坐标（经纬度）：传入WGS84或ETRS89坐标，返回该点所在的不动产。
  curl "https://api.prediohq.com/v1/inmueble/by-coords?lat=41.3915&lon=2.1620" -H "x-api-key: $PREDIO_API_KEY"

• 根据地址：提供省份、市镇、街道类型、名称和门牌号（仅限城市物业）。
  curl "https://api.prediohq.com/v1/inmueble/by-address?province=CIUDAD+REAL&municipality=SANTA+CRUZ+DE+MUDELA&streetType=CL&streetName=GLORIA&streetNumber=51" -H "x-api-key: $PREDIO_API_KEY"

输出特性

• 返回结构化、版本化的JSON（/v1），字段包括类别、用途、建筑面积（m²）、建造年份、地址、面积细分等。
• 错误信息以JSON呈现，使用标准HTTP状态码（404、422、402、401、502），绝不会返回XML或模糊的状态码。
• 支持 serve-stale 模式：当官方源宕机时，返回最近一次缓存的陈旧数据（标记为stale），保证集成不会中断。

双重协议支持

• REST：标准HTTP API，适用于传统应用集成。
• MCP：通过同一域名提供MCP服务器端点，AI代理（如Claude、GPT）可自动发现并调用工具（通过JSON Schema），无需手动适配。

定价模型

付费按使用量计费，1个信用点 = 1次成功响应（HTTP 200且有返回体）。业务错误（404/422）不计费，缓存命中及serve-stale也计费（因为提供了价值）。失败时不会中途切断响应，而是返回HTTP 402（Payment Required）错误。

价格分层（未含税，实际€/call随包变大降低）：

• Free Tier：0€/月，250信用点/月（无需绑定银行卡，注册后2分钟内即可发起首次调用）。
• 5€：2,500信用点（约0.002€/call）
• 9€：5,000信用点（约0.0018€/call）
• 29€：25,000信用点（约0.00116€/call）
• 99€：150,000信用点（约0.00066€/call）

支持自动充值以及Stripe预付包，X402支付方式即将跟进。

额外功能：地理环境预筛查（early access）

Predio还提供可选的环境图层叠加查询，包括洪水风险（SNCZI）、Natura 2000自然保护区、海岸线及公共牧场路径（vías pecuarias），结果以JSON返回并附带数据源和日期——用于土地尽职调查的快速预筛查，无需打开五个不同的地图查看器。

适用范围与限制

• 覆盖西班牙普通领土（territorio común）的城市和乡村不动产，总计约7,890万栋（截至2026年1月官方数据，其中城市约4,020万，乡村约3,870万）。
• 不包含巴斯克自治区（País Vasco）和纳瓦拉（Navarra），这两个地区拥有独立的省级地籍系统（catastro foral）。
• 数据来源为DGC的公共非保护数据，可依其许可证重用；Predio是非官方服务，不保证数据绝对准确。

关键要点

• Predio解决了西班牙地籍数据“公开但难用”的痛点，将2003年的SOAP/XML接口包装为现代JSON API，并额外提供MCP协议，大幅降低机器消费门槛。
• 三种查询方式（参考编号、坐标、地址）返回统一的结构化JSON，城市与乡村物业输出格式一致，简化集成。
• 错误处理标准化：使用HTTP状态码 + JSON错误体，不再有XML或模糊响应。
• 缓存与容错：serve-stale机制确保官方源宕机时仍能返回历史数据，避免系统中断。
• 定价透明且低门槛：免费套餐无需银行卡，允许开发者先测试再付费；按成功响应计费，业务错误免费。
• 专为AI代理设计：MCP端点使Claude、GPT等模型能自动发现和调用地籍查询工具，无需手动编写适配代码。
• 地理环境预筛查功能（early access）将多个官方数据层（洪水、自然保护区等）合并为一次API调用，提升土地尽职调查效率。
• 仅覆盖西班牙普通领土，不包括巴斯克和纳瓦拉。
• 数据公开且可重用，但Predio为非官方服务，用户需自行查阅DGC许可证条款。

意义与影响

1. 降低房地产科技门槛：以往proptech公司若要整合地籍数据，必须面对沉重的SOAP协议、非标准的错误处理和难以解析的XML。Predio提供了一个即插即用的JSON接口，使得中小型开发商甚至个人开发者也能快速接入官方地籍数据，加速房地产应用（如估值、产权查询、投资分析）的落地。

2. 赋能AI代理与自动化：MCP协议的引入意味着AI模型（如Claude、GPT）可以在对话中动态调用Predio工具，实时获取房产信息、评估土地风险。这种“代理即服务”的模式将数据查询从人工编码解放出来，推动AI在房地产、保险、法律等行业的自动化决策。

3. 推动地籍数据标准化消费：Predio的输出格式统一（城市/乡村相同结构）、错误码规范，实际上为西班牙地籍数据树立了一个事实上的标准接口。如果被广泛采用，可能倒逼官方未来改进其API设计。

4. 商业模式的启示：以“信用点+免费试用+按成功响应计费”的模式，既降低了试用门槛，又通过缓存和serve-stale将价值定价而非成本定价。这种风格在数据API领域具有参考价值。

5. 潜在局限性：不作为官方服务，数据实时性和准确性依赖于上游；排除巴斯克和纳瓦拉意味着覆盖不完整；环境预筛查功能尚在early access阶段。用户在使用时需结合官方渠道验证关键信息。