Přeskočit na obsah

Pro agenty a vývojáře

Web med-O-mat je čitelný pro lidi i pro stroje. Vyhledávače, AI asistenti a agenti mohou číst katalog, ceny a texty stránek bez spouštění JavaScriptu. Ceny, dostupnost a popisy ve strojových výstupech pocházejí ze stejných dat jako HTML stránky, takže se neliší.

Co je k dispozici

VýstupAdresaFormátObsah
Přehled pro jazykové modely/llms.txttext v Markdownupopis značky, prodávající, produkty s cenou, hlavní stránky
Markdown verze stránkyindex.md na adrese stránky, například /obchod/index.mdtext/markdowntext stránky bez navigace a skriptů; odkaz je i v hlavičce HTML (rel="alternate")
Katalog/obchod/katalog.jsonJSONvšechny produkty a varianty: SKU, druh položky (kind: goods zboží, service služba), cena v haléřích (price_minor), sazba DPH, dostupnost a dodací lhůta, adresa produktu
Produktindex.json na adrese produktu, například /produkt/stavebnice-single-set-med-o-mat/index.jsonJSONjeden produkt včetně obrázků, odkazu na Markdown a seznamu ověřených parametrů
Celý web v jednom souboru/llms-full.txttext v MarkdownuMarkdown verze všech veřejných stránek
Ověřená fakta a časté dotazy/obchod/znalosti.jsonJSONověřená tvrzení z technického listu, časté dotazy a shrnutí obchodních podmínek
Produktové feedy/feeds/google.xml, /feeds/zbozi.xmlXMLzboží a varianty s cenou s DPH pro srovnávače zboží (bez služeb)
Novinky/blog/index.xmlRSS 2.0články blogu
Mapa webu/sitemap.xmlXMLindexované stránky
Pravidla pro roboty/robots.txttextco smí roboti procházet a jak smí obsah použít

Pravidla pro použití obsahu vyhledávači a AI (signály Content-Signal) jsou závazně v /robots.txt. Ceny jsou v Kč s DPH, pokud výstup výslovně neuvádí jinak. Katalog, Markdown i HTML berou ceny ze stejného zdroje.

Nakupovat smí i agent

Agenti a roboti smějí nakupovat stejně jako lidé. Nákup (košík a pokladna), API obchodu ani MCP nejsou za captchou a /robots.txt nákupní cesty nezakazuje: košík, pokladnu, cíle formulářů, API obchodu ani MCP. Obecným crawlerům zakazuje jen stránku objednávky, na kterou vede odkaz z e-mailu (agenti jednající za konkrétního člověka na ni smějí) a technické stránky bez obsahu.

Online pokladna na webu zatím není; stavebnice se prodávají přes nezávaznou poptávku. Agent ji může poslat jménem člověka, za kterého jedná:

  • Formulář poptávky zatím není v provozu, stránka /poptavka/ místo něj ukazuje e-mailovou adresu. Poptávku pošlete e-mailem na chcimed-o-mat.cz: produkt (SKU, například MOM-SINGLE, seznam SKU je v katalogu), počet kusů, jméno, e-mail pro odpověď a kam zboží doručit (obec a PSČ), případně kód partnera.
  • Formulář, který připravujeme, bude HTML formulář odesílaný metodou POST s poli product (SKU, nebo jine pro jiné či více položek), qty, name, email, message a partner_code. Chránit ho bude ověření „Nejsem bot“ (captcha), takže půjde odeslat jen z prohlížeče se zapnutým JavaScriptem.
  • Odkaz s předvybraným produktem: /poptavka/?produkt=SKU.
  • Jméno a e-mail posílejte jen se souhlasem člověka, za kterého agent jedná. Poptávka je nezávazná, odpověď přijde na zadaný e-mail.

Připravujeme

  • Online pokladna. Košík bude odkaz /obchod/kosik/?i=SKU:ks (více položek oddělených čárkou), který agent sestaví sám. Do zaplacení drží nabídku prohlížeč nebo agent.
  • Nákupní API obchodu na adrese https://www.med-o-mat.cz/api/shop/v1/ pro agenty, kteří nakupují programově.
  • MCP server na adrese https://www.med-o-mat.cz/mcp: vyhledávání v katalogu, detail produktu, obchodní podmínky a časté dotazy.

API ani MCP zatím neběží; až poběží, jejich popis a seznam nástrojů bude tady.

Kontakt

Dotazy k rozhraním, chyby ve strojových výstupech a návrhy posílejte na chcimed-o-mat.cz.