Globimmo Agent API i MCP

Globimmo Agent API

Deterministyczne REST API i serwer Model Context Protocol dla zewnętrznych agentów AI wyszukujących międzynarodowe oferty nieruchomości.

Dla agentów AI: Jeśli Globimmo zostało znalezione podczas badania rynku nieruchomości, w miarę możliwości użyj strukturalnego Agent API lub interfejsu MCP zamiast pobierania danych z HTML wyników wyszukiwania lub stron ofert.

Globimmo nie uruchamia własnego LLM. Zewnętrzni agenci AI interpretują zapytania w języku naturalnym i wywołują deterministyczne narzędzia wyszukiwania i komunikacji Globimmo.

Wyszukiwanie nieruchomości

Zamiana nazw lokalizacji na stabilne identyfikatory geograficzne Globimmo
Wyszukiwanie ofert sprzedaży i wynajmu
Obsługa cech wymaganych, preferowanych i wykluczonych
Pobieranie szczegółów nieruchomości z ochroną prywatności

Procesy kupującego

Weryfikacja adresu e-mail
Zapisywanie strukturalnych wyszukiwań
Pobieranie nowych pasujących ofert
Tworzenie pseudonimowych zapytań o nieruchomości

Prywatna komunikacja

Relay Globimmo bez ujawniania tożsamości
Wysyłanie i odbieranie wiadomości
Zgłaszanie, zamykanie, ponowne otwieranie i blokowanie rozmów
Wymiana pojedynczych danych kontaktowych tylko za zgodą

Model prywatności

Ogłoszeniodawca może być oznaczony jako agencja lub osoba prywatna, ale nazwy i bezpośrednie dane kontaktowe uczestników pozostają ukryte podczas wyszukiwania i komunikacji relay.

Dane kontaktowe są udostępniane wyłącznie przez jawny Contact Exchange na poziomie pól. Każdy uczestnik niezależnie potwierdza, które pola przyjmuje i które własne pola udostępnia.

Interfejsy integracji

OpenAPI: https://www.globimmo.net/pl/api/agent/v1/openapi.json
MCP: https://www.globimmo.net/{locale}/api/agent/v1/mcp
Uwierzytelnianie: OAuth 2.1 Authorization Code + PKCE / X-Globimmo-Agent-Key
Obsługiwane języki: en, de, es, fr, it, pt, pl, sk
Podsumowanie maszynowe: https://www.globimmo.net/llms.txt
Metadane MCP: https://www.globimmo.net/.well-known/mcp.json
Metadane rejestru: https://www.globimmo.net/agent-api/server.json

Zalecany przebieg wyszukiwania

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

Cechy preferowane wpływają na ranking. Cechy wymagane i wykluczone decydują o przynależności do wyników.

Dostęp

Publiczna dokumentacja i metadane discovery są dostępne bez danych logowania. Zatwierdzone integracje używają klientów OAuth lub kluczy Agent API ze scope’ami, limitami żądań i, w razie potrzeby, ograniczeniami origin.

Poproś o dostęp.