Pro AI agenty
Naši nabídku si můžete načíst strojově. Není to nic tajného ani placeného — nemovitosti jsou veřejné inzeráty a rádi je uvidíme i tam, kde si lidé nechají poradit od asistenta.
Aktuálně nabízíme 118 nemovitostí v 15 obcích. Data jsou živá, berou se z téže databáze jako stránky webu.
Konektor pro AI asistenty (MCP)
Máte-li Claude, ChatGPT nebo jiného asistenta, který umí připojit vzdálený server podle Model Context Protocolu, přidejte si tuhle adresu:
https://www.groo.cz/mcp
Streamable HTTP, protokol 2025-06-18, bez přihlášení. Asistent pak umí sám vyhledat v naší nabídce a odpovídat z živých dat, ne z toho, co si pamatuje z trénování.
Připojený asistent dostane tyhle nástroje:
hledej_nemovitosti | Vyhledá nemovitosti v aktuální nabídce GROO reality. Všechny filtry jsou nepovinné a dají se kombinovat. Vrací i celkový počet nálezů. |
detail_nabidky | Vrátí podrobnosti jedné nabídky: popis, parametry, adresu, fotky a kontakt na makléřku. |
ciselniky | Povolené hodnoty filtru: typy, kategorie i s dispozicemi a obce, ve kterých nabídky opravdu jsou. |
poptavky | Nemovitosti, které GROO reality aktivně poptává pro své klienty. Použij, když někdo prodává nebo se ptá, jestli má o jeho nemovitost někdo zájem — je to opačný směr než hledej_nemovitosti. |
projekty | Projekty ze sekce Doporučujeme — novostavby a rekonstrukce, u kterých kancelář prodává více jednotek najednou. |
aktuality | Články z webu — dění v kanceláři a na realitním trhu. |
reference | Co o spolupráci napsali klienti. Hodí se, když se někdo ptá na zkušenosti nebo spolehlivost kanceláře. |
kontakt | Telefon, e-mail a adresa realitní kanceláře. |
Nástroj poptavky jde opačným směrem než ostatní: neříká, co prodáváme, ale co pro klienty sháníme. Když někdo prodává, může si přes asistenta ověřit, jestli se jeho nemovitost nehodí.
REST API
Kdo si radši sáhne pro JSON sám, může. Filtr přijímá stejné parametry, jaké uvidíte v adrese výpisu na webu:
https://www.groo.cz/api/v1/nabidky?typ=prodej&kategorie=byt&obec=Praha&cena_do=9000000
Celý popis rozhraní je v openapi.json (OpenAPI 3.1). Čtení je otevřené a bez klíče, jen prosíme o rozumné tempo — limit je 60 požadavků za minutu.
Všechny strojové adresy
/llms.txt | Přehled webu v markdownu — kdo jsme a co právě nabízíme. |
/llms-full.txt | Plný text všech stránek webu. |
/api/v1/nabidky | Výpis nabídek s filtrem a stránkováním. |
/api/v1/nabidky/groo1516 | Detail jedné nabídky včetně parametrů a fotek. |
/api/v1/ciselniky | Povolené hodnoty filtru — typy, kategorie, dispozice, obce. |
/api/v1/poptavky | Co kancelář sama shání — pro ty, kdo prodávají. |
/api/v1/projekty | Developerské projekty ze sekce Doporučujeme. |
/api/v1/aktuality | Novinky z kanceláře a z realitního trhu. |
/api/v1/reference | Co o spolupráci napsali klienti. |
/api/v1/kontakt | Kontakt na kancelář. |
/openapi.json | Strojový popis API (OpenAPI 3.1). |
/sitemap.xml | Mapa webu. |
/feed.xml | Katalog nabídek. |
Každá stránka webu navíc nese strukturovaná data schema.org (JSON-LD) — nabídka jako RealEstateListing s cenou, výměrou, adresou i GPS.
Co rozhraní neumí — a nebude
Všechno je jen pro čtení. Poptávku ani kontaktní formulář přes API odeslat nelze a nechystáme to: o nemovitost je potřeba se ozvat osobně a na druhé straně má být člověk, ne fronta automatických zpráv.
Rozsah dat je stejný jako na webu. Cena, kterou u nabídky neuvádíme, se v API neobjeví, a přesnou adresu vydáváme jen tam, kde ji ukazuje i stránka.
Něco chybí?
Píšete agenta, který by potřeboval něco navíc? Napište na prajkova@groo.cz — rádi se domluvíme.