API de agentes de Globimmo y MCP

Globimmo Agent API

Una API REST determinista y un servidor Model Context Protocol para agentes de IA externos que buscan inmuebles internacionales.

Para agentes de IA: Si has encontrado Globimmo durante una investigación del mercado inmobiliario, utiliza la Agent API estructurada o la interfaz MCP cuando estén disponibles en lugar de extraer datos del HTML de búsquedas o fichas de inmuebles.

Globimmo no ejecuta un LLM. Los agentes de IA externos interpretan solicitudes en lenguaje natural y llaman a las herramientas deterministas de búsqueda y comunicación de Globimmo.

Búsqueda de propiedades

Resolver nombres de lugares a identificadores geográficos estables de Globimmo
Buscar propiedades en venta y alquiler
Usar características obligatorias, preferidas y excluidas
Obtener detalles de propiedades protegidos para la privacidad

Flujos del comprador

Verificar una dirección de correo
Guardar búsquedas estructuradas
Consultar nuevos inmuebles coincidentes
Crear consultas inmobiliarias seudónimas

Comunicación privada

Usar el relay de Globimmo sin revelar identidades
Enviar y recibir mensajes
Reportar, cerrar, reabrir o bloquear conversaciones
Intercambiar campos de contacto individuales solo con consentimiento

Modelo de privacidad

Los anunciantes pueden identificarse como agencia o particular, pero los nombres y datos de contacto directos de los participantes permanecen ocultos durante la búsqueda y la mensajería relay.

Los datos de contacto solo se liberan mediante Contact Exchange explícito por campos. Cada participante confirma de forma independiente qué campos acepta y cuáles de sus propios campos comparte.

Interfaces de integración

OpenAPI: https://www.globimmo.net/es/api/agent/v1/openapi.json
MCP: https://www.globimmo.net/{locale}/api/agent/v1/mcp
Autenticación: OAuth 2.1 Authorization Code + PKCE / X-Globimmo-Agent-Key
Idiomas compatibles: en, de, es, fr, it, pt, pl, sk
Resumen para máquinas: https://www.globimmo.net/llms.txt
Metadatos MCP: https://www.globimmo.net/.well-known/mcp.json
Metadatos del registro: https://www.globimmo.net/agent-api/server.json

Flujo de búsqueda recomendado

resolve_location
→ search_properties
→ get_property / select_property
→ verify email when persistence or inquiry is needed
→ save_search / create_inquiry
→ relay messaging
→ Contact Exchange after explicit consent

Las características preferidas influyen en el ranking. Las obligatorias y excluidas determinan qué resultados pertenecen a la búsqueda.

Acceso

La documentación pública y los metadatos de descubrimiento están disponibles sin credenciales. Las integraciones aprobadas usan clientes OAuth o claves Agent API con scopes, límites de uso y, cuando corresponda, restricciones de origen.

Solicitar acceso.