Fyn es un mini proyecto experimental: una demostración de cómo los portales inmobiliarios podrían exponer su inventario a agentes de IA mediante herramientas estructuradas, sin obligar al modelo a navegar una interfaz pensada para humanos.
La hipótesis
Si el inventario inmobiliario se ofreciera como una herramienta fiable, tipada y trazable, una IA podría encargarse de planificar la búsqueda mientras el portal conserva el control de sus datos, reglas y experiencia final.
01 · Contrato MCP
Una herramienta describe qué puede pedir el modelo
Fyn publica search_properties mediante Model Context Protocol. Su esquema define campos como municipios, operación, presupuesto, habitaciones, tipos de inmueble y preferencias. El texto libre aporta contexto, pero la ejecución depende de restricciones estructuradas y validadas.
En el prototipo: MCP SDK + Zod, con transporte Streamable HTTP.
02 · Planificación
La IA decide cómo convertir la intención en una búsqueda
El modelo interpreta expresiones ambiguas —«cerca de naturaleza», «con vida de barrio» o «acepto reforma»— y elige ubicaciones, filtros duros y preferencias blandas. Fyn no usa otro LLM en el backend: recibe ese plan y lo ejecuta de forma determinista.
La separación importa: el modelo razona; la herramienta valida y ejecuta.
03 · Adaptadores
Cada portal necesita una traducción distinta
Un registro de conectores convierte el contrato común a las capacidades reales de cada fuente. Hoy el experimento trabaja con páginas públicas y comportamientos específicos por portal; en un escenario ideal, estos adaptadores consumirían APIs oficiales diseñadas para agentes.
Los conectores son reemplazables: la interfaz común no depende del origen.
04 · Normalización
Datos heterogéneos entran en un mismo modelo
Los campos disponibles se transforman en ListingCard: identificador, portal, URL, precio, habitaciones, tipo, imágenes y fecha de observación. Los filtros duros se aplican antes del ranking para evitar que una buena puntuación esconda un incumplimiento básico.
El contrato normalizado permite combinar fuentes sin borrar su procedencia.
05 · Ranking y diagnóstico
El resultado incluye razones y también fallos
Un scoring explícito pondera presupuesto, habitaciones, ubicación y señales textuales como luz, vistas o exterior. La respuesta añade why_matched y cobertura por ubicación y fuente, incluyendo bloqueos, cambios de esquema, ausencia de resultados o indisponibilidad.
La transparencia del fallo es parte del resultado, no un detalle interno.
Qué intenta demostrar
Una posible capa de interacción para portales en la era de los agentes.
01
Herramientas, no scraping
El destino deseable son APIs oficiales para agentes, con permisos, límites y contratos estables.
02
Planificación fuera del portal
El usuario conserva su conversación y la IA compone búsquedas sobre inventario autorizado.
03
Control para la fuente
El portal puede decidir campos, cuotas, atribución, enlaces, acceso y reglas comerciales.
04
Resultados verificables
Cada propiedad mantiene su fuente y el usuario termina el proceso en el anuncio original.
El prototipo está abierto a inspección.
Consulta el contrato MCP y prueba el endpoint para entender qué funciona hoy y dónde están los límites.