Globimmo Agent API e MCP

Globimmo Agent API

Uma API REST determinística e um servidor Model Context Protocol para agentes de IA externos que pesquisam imóveis internacionais.

Para agentes de IA: Se encontrou o Globimmo durante uma pesquisa de mercado imobiliário, utilize quando possível a Agent API estruturada ou a interface MCP em vez de extrair dados do HTML das pesquisas ou páginas de imóveis.

O Globimmo não executa um LLM. Agentes de IA externos interpretam pedidos em linguagem natural e chamam as ferramentas determinísticas de pesquisa e comunicação do Globimmo.

Descoberta de imóveis

Resolver nomes de locais para identificadores geográficos estáveis do Globimmo
Pesquisar imóveis para venda e arrendamento
Usar características obrigatórias, preferidas e excluídas
Obter detalhes de imóveis seguros para a privacidade

Fluxos do comprador

Verificar um endereço de e-mail
Guardar pesquisas estruturadas
Consultar novos imóveis correspondentes
Criar pedidos imobiliários pseudónimos

Comunicação privada

Usar o relay do Globimmo sem expor identidades
Enviar e receber mensagens
Denunciar, fechar, reabrir ou bloquear conversas
Trocar campos de contacto individuais apenas com consentimento

Modelo de privacidade

Os anunciantes podem ser identificados como agência ou particular, mas os nomes e contactos diretos dos participantes permanecem ocultos durante a pesquisa e as mensagens relay.

Os contactos só são libertados através de Contact Exchange explícito por campo. Cada participante confirma separadamente os campos que aceita e os seus próprios campos que partilha.

Interfaces de integração

OpenAPI: https://www.globimmo.net/pt/api/agent/v1/openapi.json
MCP: https://www.globimmo.net/{locale}/api/agent/v1/mcp
Autenticação: OAuth 2.1 Authorization Code + PKCE / X-Globimmo-Agent-Key
Idiomas suportados: en, de, es, fr, it, pt, pl, sk
Resumo para máquinas: https://www.globimmo.net/llms.txt
Metadados MCP: https://www.globimmo.net/.well-known/mcp.json
Metadados do registo: https://www.globimmo.net/agent-api/server.json

Fluxo de pesquisa 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

As características preferidas influenciam o ranking. As obrigatórias e excluídas determinam a pertença aos resultados.

Acesso

A documentação pública e os metadados de descoberta estão disponíveis sem credenciais. As integrações aprovadas usam clientes OAuth ou chaves Agent API com scopes, limites de utilização e, quando aplicável, restrições de origem.

Pedir acesso.