# Pro agenty a vývojáře

> Strojově čitelný web med-O-mat: Markdown verze stránek, katalog v JSON, llms.txt, RSS a sitemap. Nakupovat smí i agent, postup je na této stránce.

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ýstup | Adresa | Formát | Obsah |
|---|---|---|---|
| Přehled pro jazykové modely | [/llms.txt](https://www.med-o-mat.cz/llms.txt) | text v Markdownu | popis značky, prodávající, produkty s cenou, hlavní stránky |
| Markdown verze stránky | `index.md` na adrese stránky, například [/obchod/index.md](https://www.med-o-mat.cz/obchod/index.md) | `text/markdown` | text stránky bez navigace a skriptů; odkaz je i v hlavičce HTML (`rel="alternate"`) |
| Katalog | [/obchod/katalog.json](https://www.med-o-mat.cz/obchod/katalog.json) | JSON | vš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 |
| Produkt | `index.json` na adrese produktu, například [/produkt/stavebnice-single-set-med-o-mat/index.json](https://www.med-o-mat.cz/produkt/stavebnice-single-set-med-o-mat/index.json) | JSON | jeden produkt včetně obrázků, odkazu na Markdown a seznamu ověřených parametrů |
| Celý web v jednom souboru | [/llms-full.txt](https://www.med-o-mat.cz/llms-full.txt) | text v Markdownu | Markdown verze všech veřejných stránek |
| Ověřená fakta a časté dotazy | [/obchod/znalosti.json](https://www.med-o-mat.cz/obchod/znalosti.json) | JSON | ověřená tvrzení z technického listu, časté dotazy a shrnutí obchodních podmínek |
| Produktové feedy | [/feeds/google.xml](https://www.med-o-mat.cz/feeds/google.xml), [/feeds/zbozi.xml](https://www.med-o-mat.cz/feeds/zbozi.xml) | XML | zboží a varianty s cenou s DPH pro srovnávače zboží (bez služeb) |
| Novinky | [/blog/index.xml](https://www.med-o-mat.cz/blog/index.xml) | RSS 2.0 | články blogu |
| Mapa webu | [/sitemap.xml](https://www.med-o-mat.cz/sitemap.xml) | XML | indexované stránky |
| Pravidla pro roboty | [/robots.txt](https://www.med-o-mat.cz/robots.txt) | text | co smí roboti procházet a jak smí obsah použít |
| Katalog rozhraní | `/.well-known/api-catalog` | JSON (linkset podle RFC 9727) | strojově čitelný seznam rozhraní pro agenty s odkazem na tuto stránku |

Pravidla pro použití obsahu vyhledávači a AI (signály `Content-Signal`) jsou závazně v [/robots.txt](https://www.med-o-mat.cz/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](https://www.med-o-mat.cz/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/](https://www.med-o-mat.cz/poptavka/) místo něj ukazuje e-mailovou adresu.
  Poptávku pošlete e-mailem na (adresa na stránce [Kontakt](https://www.med-o-mat.cz/kontakt/#e-mail)): 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.

## MCP server

MCP server obchodu běží na adrese `https://www.med-o-mat.cz/mcp` (Streamable HTTP, bez přihlášení). Má čtyři
nástroje, které jen čtou, se stejnými daty jako web a katalog:

- `search_catalog`: hledání v katalogu podle textu, kategorie, nejvyšší ceny a dostupnosti,
- `get_product`: detail produktu s variantami, cenami, dostupností a ověřenými parametry,
- `get_policies`: shrnutí pravidel obchodu k tématu (prodávající, odstoupení od smlouvy, reklamace a záruka,
  obchodní podmínky, doprava, platby a další),
- `search_faq`: hledání v častých dotazech.

Nakupovat přes MCP zatím nejde: stavebnici objednáte dál nezávaznou poptávkou (postup výše).

## 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ě.

Nákupní API zatím neběží; až poběží, jeho popis bude tady.

## Kontakt

Dotazy k rozhraním, chyby ve strojových výstupech a návrhy posílejte na (adresa na stránce [Kontakt](https://www.med-o-mat.cz/kontakt/#e-mail)).

---
Aktualizováno: 2026-10-27
Prodávající: NORDservis s.r.o., IČO 48268445, DIČ CZ48268445, Sídlo Hanychovská 867/22c, 460 07 Liberec, Kontakt https://www.med-o-mat.cz/kontakt/#e-mail, Telefon +420 482 770 332
URL: https://www.med-o-mat.cz/pro-agenty/