API de Comparables y servidor MCP:
testigos y valor estimado desde una referencia catastral
Obtenga testigos de tasación y el valor estimado de una vivienda a partir de su referencia catastral, punto o dirección mediante la API REST de CASAFARI o el servidor MCP.
El producto Comparables de CASAFARI devuelve una selección de testigos con su fuente y mes de observación, junto con un valor estimado del inmueble, a partir de unas coordenadas, una dirección o una referencia catastral. Está disponible mediante cuatro operaciones REST o a través de un servidor MCP para Claude y ChatGPT (Casafari MCP). Cada consulta a Comparables consume 25 tokens, mientras que la resolución de ubicaciones mediante Location Lookup es gratuita.
Una profesional de una sociedad de tasación en Valencia recibe un encargo con apenas una referencia catastral y una fecha límite para el día siguiente. Antes de iniciar la inspección presencial, necesita una muestra de inmuebles comparables en el mismo entorno urbano. Identificar manualmente cada test de mercado en los portales exige horas de filtrado y verificación. Con la integración de la API de Comparables de CASAFARI, ese análisis previo se genera en pocos segundos.
¿Qué devuelve Comparables cuando se le pide una valoración?
Al realizar una consulta a la API o al servidor MCP de Comparables, el sistema requiere un único identificador de entrada: un punto geográfico expresado en coordenadas, una dirección postal completa o, en el caso de España, una referencia catastral. A partir de esta información, la herramienta procesa el mercado circundante y entrega una respuesta estructurada con dos elementos fundamentales: un conjunto detallado de testigos y un valor estimado del inmueble.
En la práctica técnica de la valoración inmobiliaria en España se utiliza el término «testigo», mientras que a nivel internacional y en los productos informáticos de CASAFARI se emplea el vocablo «comparables». Ambos conceptos hacen referencia a la misma evidencia de mercado necesaria para aplicar el método de comparación.
La respuesta incluye tres tipos distintos de evidencia de mercado:
- Inmuebles en el mercado: inmuebles en el mercado con sus precios de oferta y días en catálogo.
- Inmuebles retirados por venta: inmuebles retirados tras su venta, con su último precio de oferta.
- Inmuebles retirados por alquiler: inmuebles retirados tras su arrendamiento, con su último precio de oferta.
¿Por qué la referencia catastral es la entrada idónea en España?
La referencia catastral es el código oficial y obligatorio asignado por la Dirección General del Catastro a cada inmueble. Consta de 20 caracteres alfanuméricos que identifican de forma unívoca a una finca urbana en todo el territorio nacional, figurando en los recibos del Impuesto sobre Bienes Inmuebles (IBI) y en las escrituras públicas.
El uso de direcciones postales suele presentar ambigüedades: denominaciones de calles duplicadas, variaciones en el callejero municipal o discrepancias en la identificación de plantas y puertas («bajo B» frente a «bajo izquierda»). La referencia catastral elimina estas desviaciones de localización al posicionar el análisis directamente sobre la unidad finca concreta.
Aunque la referencia catastral constituye la vía de entrada idónea para el mercado español, el sistema admite también búsquedas por punto o dirección. La resolución de nombres de zonas y términos geográficos se efectúa mediante Location Lookup, un servicio que no consume tokens dentro de la plataforma. Para una explicación detallada del flujo, consulte la publicación sobre cómo ayuda la referencia catastral en la valoración inmobiliaria y la documentación técnica sobre el uso de la referencia catastral en la documentación de Comparables & Valuation en developers.casafari.com (en inglés).
¿De dónde salen los testigos: anuncios e historial de publicación?
Cada testigo entregado por Comparables especifica de manera clara su procedencia y la fecha en que fue observado. Los anuncios publicados y la historia de publicación muestran los precios de oferta del mercado y sus modificaciones en el tiempo. Comparables muestra precios de oferta; los precios de cierre registrados están disponibles a través de Comparables with Transactions.
Esta precisión en las fechas resulta crítica bajo el marco normativo español. La Orden ECO/805/2003 en el BOE (cuyo texto consolidado fue actualizado en junio de 2025) regula las valoraciones para garantía hipotecaria y exige en la Sección 3.ª de su capítulo II (artículos 20 a 22) el empleo de un mínimo de seis testigos representativos del mercado actual.
El ritmo de evolución de los precios hace que un testigo desactualizado introduzca desviaciones significativas. Según la Estadística Registral Inmobiliaria del Colegio de Registradores, 2T 2026 (publicada el 5 de agosto de 2026), el precio medio registrado de la vivienda en España se situó en 2.487 €/m², con un crecimiento interanual del +9,2 % (+2,4 % trimestral). Asimismo, la nota de prensa del Índice de Precios de Vivienda del INE, segundo trimestre de 2026 (publicada el 7 de septiembre de 2026) registró un incremento interanual del +12,2 % (+12,9 % en vivienda usada). Un testigo observado doce meses atrás acumula un desfase cercano al 10 % antes de cualquier ponderación física o de ubicación.
La herramienta facilita la selección homologable de testigos que el profesional requiere, sin sustituir el criterio técnico final del tasador. Para ampliar información sobre la adaptación de la plataforma al sector, puede leer los productos de CASAFARI para el tasador inmobiliario.
¿Cómo lo usan tasadoras, bancos y proptechs por REST?
Las organizaciones integran las cuatro operaciones REST de Comparables en sus flujos operativos según sus necesidades de negocio:
- Sociedades de tasación: automatizan el volcado inicial de la tabla de testigos previa a la visita del inmueble.
- Departamentos de riesgo y valoración bancaria: efectúan análisis previos de colaterales hipotecarios y revalorizaciones periódicas de carteras de inmuebles.
- Empresas proptech: incorporan la estimación automática de valor en sistemas de captación de clientes, concesión de préstamos o plataformas transaccionales.
- Agencias inmobiliarias: generan análisis comparativos de mercado orientados al cliente final, apoyándose en el caso de uso para convertir comparables en un informe CMA (en inglés).
El acceso a la API requiere obtener credenciales tras crear una cuenta y obtener claves en platform.casafari.com. Para más detalles de integración técnica, puede revisar las APIs de datos inmobiliarios de CASAFARI y la guía sobre cómo hacer una valoración de inmuebles con CASAFARI.
¿Cómo se pregunta en Claude o ChatGPT con el servidor MCP?
Para los profesionales y analistas que trabajan directamente en asistentes de inteligencia artificial, CASAFARI ofrece una herramienta MCP unificada accesible en el punto de enlace https://platform.casafari.com/mcp/comparables.
Para vincular el servidor MCP en Claude Code, ejecute la siguiente orden en su terminal:
claude mcp add --transport http casafari-comparables https://platform.casafari.com/mcp/comparables
Una vez configurado el conector, puede realizar peticiones en lenguaje natural directamente en la conversación con el asistente:
«Proporciona seis testigos de mercado y un valor estimado para la vivienda con referencia catastral 9872009VK4797S0001WX.»
El modelo invocará la herramienta MCP de CASAFARI y devolverá los testigos filtrados junto con el cálculo estimado. Puede consultar los detalles de este entorno en la página sobre Casafari MCP, datos inmobiliarios para agentes de IA.
¿Cuánto cuesta cada llamada en tokens?
El consumo de los servicios API y MCP se gestiona mediante tokens de uso:
- Consulta a Comparables: 25 tokens por llamada ejecutada con éxito.
- Búsqueda de ubicación (Location Lookup): 0 tokens (gratuita).
- Comparables with Transactions: 65 tokens por consulta.
Cuando necesite incluir también precios de cierre registrados, utilice Comparables with Transactions a 65 tokens por consulta a través del servidor MCP https://platform.casafari.com/mcp/comparables-transactions. Este servicio añade precios de cierre registrados de cuatro países: España (escrituras notariales, Notariado), Francia (DVF, el registro público de compraventas), Italia (compraventas registradas de la Agenzia delle Entrate) y Polonia (RCN, el registro oficial de precios inmobiliarios del país). Cada cifra indica de forma transparente si se trata de un precio de oferta o de cierre, identificando claramente su fuente.
Los tokens forman parte del plan contratado y su saldo disponible se gestiona desde el panel de control. Al configurar la autenticación en las llamadas REST, recuerde emplear sus access tokens conforme al estándar de la plataforma. Para comprobar las funcionalidades de estudio de mercado en la interfaz web, visite la herramienta de valoraciones y estudio de mercado de CASAFARI y la valoración inmobiliaria online de CASAFARI.
Para comenzar a trabajar con la API de Comparables o integrar el servidor MCP en sus asistentes de análisis, puede solicitar su acceso y consultar los planes disponibles registrándose en platform.casafari.com.
Preguntas frecuentes
¿Qué diferencia hay entre un comparable y un testigo de tasación?
No existe diferencia sustancial en cuanto al concepto de fondo. El término «testigo» es la denominación tradicional empleada en la práctica técnica de la valoración en España y en la Orden ECO/805/2003, mientras que «comparable» es el vocablo habitual en el ámbito internacional y en las herramientas informáticas. El producto Comparables de CASAFARI entrega los testigos especificando su fuente, precio y fecha de observación para cumplir los requerimientos normativos.
¿Se puede valorar un piso solo con la referencia catastral?
Sí, la referencia catastral de 20 caracteres asignada por la Dirección General del Catastro es uno de los tres parámetros de entrada admitidos por el sistema, junto con las coordenadas geográficas y la dirección postal. Su uso elimina las ambigüedades de la calle y sitúa el análisis sobre la unidad finca exacta. La resolución del inmueble a partir de la referencia catastral permite obtener de inmediato el conjunto de testigos y el valor estimado.
¿Los comparables incluyen precios de cierre reales o solo precios de anuncio?
No, Comparables únicamente incluye precios de oferta de mercado, tanto de inmuebles en el mercado como de inmuebles retirados tras su venta o alquiler (con su último precio de oferta). Si requiere precios de cierre registrados oficiales, estos están disponibles a través de Comparables with Transactions, que incorpora las escrituras notariales en España (Notariado), el registro público DVF en Francia, las compraventas registradas en Italia de la Agenzia delle Entrate y el RCN, el registro oficial de precios inmobiliarios de Polonia.
¿Sirve el valor estimado de CASAFARI como tasación oficial para una hipoteca?
No, el valor estimado devuelto por la API es un cálculo automatizado de apoyo al análisis de mercado. Una tasación formal con validez para garantía hipotecaria debe ser emitida por una sociedad de tasación y firmada por un profesional competente conforme a la Orden ECO/805/2003. Comparables agiliza la fase previa de recopilación de testigos y análisis de datos que utiliza el tasador en su informe.
¿Cuánto cuesta una llamada a Comparables y cómo se consiguen los tokens?
Cada llamada con éxito a la API o al servidor MCP de Comparables consume 25 tokens, mientras que las consultas de búsqueda geográfica en Location Lookup no consumen tokens. El saldo de tokens se administra mediante la suscripción elegida dentro de la consola de usuario en platform.casafari.com, donde se gestionan las claves de acceso y los consumos.
¿Cómo conecto Comparables a Claude o ChatGPT?
La conexión con asistentes de IA se realiza mediante el servidor MCP disponible en el punto de enlace https://platform.casafari.com/mcp/comparables. En Claude Code se añade mediante la orden de terminal «claude mcp add --transport http casafari-comparables https://platform.casafari.com/mcp/comparables». En ChatGPT u otros entornos compatibles con MCP se utiliza el mismo punto de conexión HTTP proporcionado por la plataforma.