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 sólida 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 cuatro tipos distintos de evidencia de mercado:
- Inmuebles en el mercado: anuncios activos con sus precios de oferta y días en catálogo.
- Ventas pasadas: transacciones cerradas con el importe final de la operación.
- Alquileres pasados: contratos de arrendamiento completados en la zona.
- Registros oficiales: datos procedentes del Registro de la Propiedad que confirman las operaciones efectuadas.
Para profundizar en el tratamiento de los datos de cierre, puede consultar la guía de ayuda sobre dónde ver comparables con precios de cierre reales.
¿Por qué la referencia catastral es la mejor entrada 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, cierres y Registro?
Cada testigo entregado por Comparables especifica de manera clara su procedencia y la fecha en que fue observado. Los anuncios publicados reflejan la pretensión económica del vendedor, las ventas y alquileres cerrados recogen el valor real alcanzado en la transacción, y los registros oficiales aportan el marco de confirmación del Registro de la Propiedad.
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 severas. 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 venta cerrada 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 de forma transparente mediante tokens de uso:
- Consulta a Comparables: 25 tokens por llamada ejecutada con éxito.
- Búsqueda de ubicación (Location Lookup): 0 tokens (gratuita).
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?
La respuesta del sistema incluye ambos tipos de datos junto con registros oficiales. Cada testigo indica claramente si se trata de un anuncio activo en el mercado (precio de oferta), una venta o alquiler cerrado en el pasado, o una transacción confirmada mediante datos registrales. Además, cada registro especifica el mes y año de observación para que el analista evalúe la oportunidad temporal de la muestra.
¿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.