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 14 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í. Jedna zpráva JSON-RPC na požadavek (dávky nepřijímáme), tělo do 64 kB. 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:
| Nástroj | Co dělá |
|---|---|
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. |
stranky | Seznam stránek webu — služby kanceláře, právní informace, o makléřce. Obsah konkrétní stránky vrátí nástroj stranka. |
stranka | Text jedné stránky webu v markdownu. Použij, když se někdo ptá na to, jak kancelář pracuje, co dělá při prodeji nebo co nabízí za služby. |
detail_projektu | Developerský projekt i se seznamem jednotek, které se v něm prodávají. |
detail_aktuality | Celý text jednoho článku, ne jen perex. |
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, s operationId u každé operace). Čtení je otevřené a bez klíče, jen prosíme o rozumné tempo — limit je 60 požadavků za minutu na adresu, společný pro API i konektor. Po překročení přijde 429 s hlavičkou Retry-After.
Všechny strojové adresy
| Adresa | Typ obsahu | Co tam je |
|---|---|---|
/llms.txt | text/markdown | Přehled webu — kdo jsme a co nabízíme. |
/llms-full.txt | text/markdown | Plný text všech stránek webu. |
/openapi.json | application/json | Strojový popis API (OpenAPI 3.1). |
/sitemap.xml | application/xml | Mapa webu — všechny URL s datem změny. |
/feed.xml | application/xml | Katalog nabídek ve formátu Meta. |
/api/v1/nabidky | application/json | Výpis nabídek s filtrem a stránkováním. |
/api/v1/nabidky/groo1516 | application/json | Detail nabídky: parametry, fotky, makléřka. |
/api/v1/ciselniky | application/json | Povolené hodnoty filtru. |
/api/v1/stranky | application/json | Seznam stránek webu. |
/api/v1/stranky/sluzby/prodej | application/json | Obsah jedné stránky v markdownu. |
/api/v1/poptavky | application/json | Co kancelář sama shání. |
/api/v1/projekty | application/json | Developerské projekty. |
/api/v1/projekty/21 | application/json | Projekt i s jednotkami v prodeji. |
/api/v1/aktuality | application/json | Novinky kanceláře. |
/api/v1/aktuality/16 | application/json | Článek i s plným textem. |
/api/v1/reference | application/json | Co napsali klienti. |
/api/v1/kontakt | application/json | Kontakt na kancelář. |
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 — do puntíku. Cena, kterou u nabídky neuvádíme, se v rozhraní neobjeví. Ulici vydáváme jen tam, kde ji ukazuje i stránka, číslo popisné ještě o stupeň méně často a PSČ vůbec. Nabídka se záměrně nepřesnou polohou má i zaokrouhlené souřadnice.
Jedna věc, ať někoho nezmate: filtr cena_do propustí i nabídky s cenou na vyžádání a neodlišuje prodej od pronájmu. Kolik jich ve výsledku je, říká pole cena_na_vyzadani; konektor to hlásí rovnou ve větě.
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.