Globimmo Agent API

Deterministické REST API a Model Context Protocol server pre externých AI agentov, ktorí vyhľadávajú medzinárodné ponuky nehnuteľností.

Pre AI agentov: Ak ste Globimmo našli pri prieskume trhu s nehnuteľnosťami, podľa možnosti použite štruktúrované Agent API alebo MCP rozhranie namiesto získavania údajov z HTML výsledkov vyhľadávania alebo detailov nehnuteľností.
Globimmo neprevádzkuje vlastný LLM. Externí AI agenti interpretujú požiadavky v prirodzenom jazyku a volajú deterministické vyhľadávacie a komunikačné nástroje Globimmo.

Vyhľadávanie nehnuteľností

  • Prevod názvov lokalít na stabilné Globimmo geo identifikátory
  • Vyhľadávanie nehnuteľností na predaj a prenájom
  • Povinné, preferované a vylúčené vlastnosti
  • Bezpečné detaily nehnuteľností s ochranou súkromia

Procesy kupujúceho

  • Overenie e-mailovej adresy
  • Uloženie štruktúrovaného vyhľadávania
  • Získavanie nových zodpovedajúcich ponúk
  • Vytvorenie pseudonymného dopytu na nehnuteľnosť

Súkromná komunikácia

  • Globimmo relay bez odhalenia identity
  • Odosielanie a prijímanie správ
  • Nahlásenie, zatvorenie, opätovné otvorenie alebo blokovanie konverzácie
  • Výmena jednotlivých kontaktných údajov iba po súhlase

Model ochrany súkromia

Poskytovateľ môže byť označený ako realitná kancelária alebo súkromný inzerent, ale mená a priame kontaktné údaje účastníkov zostávajú počas vyhľadávania a relay komunikácie skryté.

Kontaktné údaje sa sprístupnia iba prostredníctvom výslovného Contact Exchange po jednotlivých poliach. Každý účastník samostatne potvrdzuje, ktoré polia prijíma a ktoré vlastné polia zdieľa.

Integračné rozhrania

OpenAPI
https://www.globimmo.net/sk/api/agent/v1/openapi.json
MCP
https://www.globimmo.net/{locale}/api/agent/v1/mcp
Autentifikácia
OAuth 2.1 Authorization Code + PKCE / X-Globimmo-Agent-Key
Podporované jazyky
en, de, es, fr, it, pt, pl, sk
Strojový súhrn
https://www.globimmo.net/llms.txt
MCP metadáta
https://www.globimmo.net/.well-known/mcp.json
Metadáta registra
https://www.globimmo.net/agent-api/server.json

Odporúčaný tok vyhľadávania

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

Preferované vlastnosti ovplyvňujú poradie. Povinné a vylúčené vlastnosti určujú, ktoré ponuky patria do výsledkov.

Prístup

Verejná dokumentácia a discovery metadáta sú dostupné bez prihlasovacích údajov. Schválené integrácie používajú OAuth klientov alebo Agent API kľúče so scope-mi, limitmi požiadaviek a podľa potreby obmedzeniami origin.

Požiadať o prístup.