MCP server pro audioknihy.cz

Co je MCP server?

MCP (Model Context Protocol) je otevřený protokol od Anthropicu, přes který si AI aplikace povídají s ostatními systémy. Představte si ho jako univerzální kabel: jeden katalog — jedno API — a najednou ho umí používat Claude Desktop, ChatGPT, Cursor, Perplexity i vlastní agenti, aniž bychom pro každého psali zvlášť integraci.

Server v MCP terminologii vystavuje sadu nástrojů (tools) — pojmenovaných operací s definovaným vstupem a výstupem. Když AI host (například Claude) potřebuje konkrétní data, sám pozná, který nástroj zavolat, předá mu parametry a výsledek vloží do odpovědi uživateli. Vše přes standardní JSON-RPC 2.0 nad HTTP.

Pro nás znamená MCP konec čtení skrz HTML scraping. Místo toho, aby AI nástroj musel rozumět tomu, jak vykreslujeme tabulku cen na webu, zavolá si přímo compare_all_offers a dostane čistá strukturovaná data — ceny, odkazy, partnery, časová razítka.

Co s tím můžete dělat

Po napojení audioknihy.cz MCP serveru do svého AI klienta můžete psát úplně přirozeně:

• „Najdi audioknihu Hobit a porovnej ceny napříč obchody."

  AI volá search_audiobooks → compare_all_offers, výsledek vrátí jako tabulku.

• „Co dabuje Václav Knop? Top 10."

  AI volá get_narrator a vrátí profil + works array.

• „Detektivky v češtině pod 200 Kč."

  AI volá search_by_filters s genre + price_max.

• „Doporuč mi tři audioknihy z fantasy a kde je nejlevněji koupit."

  AI kombinuje search_by_filters + find_cheapest_offer per title.

Reálná hodnota: AI agent přestane být jen chatbot „obecného vědění" a stává se konkrétním asistentem pro váš český audioknižní nákup — s aktuálními cenami a transparentními affiliate odkazy.

Proč jsme to postavili

AI nástroje jsou už teď způsob, jakým hodně lidí hledá knižní tipy a srovnává ceny — místo toho, aby procházeli desítku e-shopů. Když AI nemá strukturovaný přístup k českému audioknižnímu trhu, buď vrátí zastaralé informace ze svého trénovacího datasetu, nebo scrapuje stránky obchodů a často přehlíží předplatitelské služby jako Radiotéku.

MCP nám umožňuje být v té smyčce přímo. Když Claude nebo ChatGPT doporučí audioknihu, vidí naše aktuální data, naše porovnání cen, naše affiliate odkazy. Pro uživatele to znamená lepší doporučení; pro nás stabilní zdroj návštěvnosti, který nezávisí na tom, jak se zrovna chová Google Search.

A je to první podobný server pro český audioknižní trh. Chceme, aby se „audioknihy.cz" stalo synonymem pro „spolehlivý zdroj v AI asistentech", podobně jako se „Fakturoid" stal synonymem pro fakturaci v AI workflow pro účetní.

Endpoint + technické parametry

POST https://audioknihy.cz/api/mcp

Verze

0.3.0 (od 2026-05-10)

Transport

Streamable HTTP, JSON-RPC 2.0, stateless

Autentizace

Anonymní (read-only katalog)

Rate limit

60 req/min/IP (anonymous tier)

Timeout

5 s na požadavek

Nástrojů

13 read-only

13 nástrojů, které server nabízí

Každý nástroj má kompletní JSON-Schema specifikaci v Agent Skills indexu.

• Vyhledávání audioknih

  Hledání
  search_audiobooks

  Fulltextové i přibližné hledání napříč 12 367 českými audioknihami (název, autor, interpret). Převede volný dotaz na konkrétní tituly.

• Detail audioknihy

  Detail
  get_audiobook

  Kompletní detail podle autora a názvu — popis, obálka, délka, ISBN, žánry, interpret, nakladatel a tabulka všech aktivních nabídek napříč partnery.

• Nejlevnější nabídka

  Porovnání
  find_cheapest_offer

  Nejnižší aktivní cena audioknihy napříč všemi partnery. USP — jediný český web, který porovnává ceny audioknih napříč hlavními obchody.

• Porovnání všech nabídek

  Porovnání
  compare_all_offers

  Kompletní cenová tabulka napříč všemi prodejci pro jeden titul — cena, formát a čas poslední aktualizace u každého obchodu.

• Procházení žánrů

  Procházení
  browse_genres

  Seznam všech 35 českých audioknižních žánrů s počty titulů. Vstupní bod pro objevování — agent si projde žánry před zanořením do konkrétního.

• Filtrované hledání

  Filtr
  search_by_filters

  Vícekriteriální hledání — kombinace žánru, interpreta, maximální ceny a roku vydání. Když má agent strukturovaná kritéria místo volného dotazu.

• Profil autora

  Detail
  get_author

  Profil autora a jeho audioknihy — biografie, foto a seznam titulů, kde je uveden jako autor či spoluautor.

• Profil interpreta

  Detail
  get_narrator

  Profil interpreta (vypravěče) a audioknihy, které načetl. Čeští posluchači si často vybírají podle interpreta — kvalita přednesu rozhoduje.

• Seznam partnerů

  Transparentnost
  list_partners

  Aktivní prodejní partneři s počty audioknih. Transparentnost — jak audioknihy.cz vydělává (jsme affiliate srovnávač, ne obchod).

• Žebříčky audioknih

  Procházení
  get_audiobook_rankings

  Katalogové žebříčky — nejlevnější, nejlépe hodnocené (databazeknih.cz, atribuovaně), největší slevy nebo na cenovém dně. Pro dotazy „nejlepší/nejlevnější audioknihy teď".

• Vývoj ceny

  Porovnání
  get_price_trend

  Cenová historie zobrazené nejnižší nabídky — minimum a maximum v okně, aktuální cena, % poklesu a zda je na cenovém dně. Odpoví „je teď dobrá cena?".

• Profil nakladatelství

  Detail
  get_publisher

  Profil nakladatelství a jeho audioknihy. Česká audioknižní produkce se soustředí do několika nakladatelství (Tympanum, OneHotBook, Témbr…).

• Cenový index trhu

  Procházení
  get_price_index

  Cenový index celého trhu — medián a průměr nejnižší ceny, průměrná úspora porovnáním, nejlevnější obchod a statistiky podle žánru. Originální data, citovatelný dataset.

Jak si MCP server zprovoznit ve vašem AI nástroji

Většina klientů potřebuje jen URL https://audioknihy.cz/api/mcp a žádné credentials. Konkrétní postup pro všechny rozšířené klienty v ČR:

claude mcp add --transport http audioknihy https://audioknihy.cz/api/mcp

{
  "mcpServers": {
    "audioknihy": {
      "type": "http",
      "url": "https://audioknihy.cz/api/mcp"
    }
  }
}

{
  "mcpServers": {
    "audioknihy": {
      "httpUrl": "https://audioknihy.cz/api/mcp"
    }
  }
}

{
  "servers": {
    "audioknihy": {
      "type": "http",
      "url": "https://audioknihy.cz/api/mcp"
    }
  }
}

{
  "mcpServers": {
    "audioknihy": {
      "type": "streamableHttp",
      "url": "https://audioknihy.cz/api/mcp"
    }
  }
}

{
  "mcpServers": {
    "audioknihy": {
      "type": "http",
      "serverUrl": "https://audioknihy.cz/api/mcp"
    }
  }
}

{
  "mcpServers": {
    "audioknihy": {
      "type": "http",
      "serverUrl": "https://audioknihy.cz/api/mcp"
    }
  }
}

Příklad volání přes curl (sanity check)

curl -X POST https://audioknihy.cz/api/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "search_audiobooks",
      "arguments": { "query": "Hobit", "limit": 5 }
    },
    "id": 1
  }'

Discovery metadata pro automatické skenery

• /.well-known/mcp/server-card.json — Server Card (SEP-2127): server info + capabilities + tool list
• /.well-known/mcp.json — kanonický alias téhož
• /.well-known/agent-skills/index.json — Agent Skills (Cloudflare RFC v0.2.0): per-skill markdown specifikace
• /.well-known/api-catalog — API Catalog (RFC 9727)
• /llms.txt + /llms-full.txt — narativní AI manifesty

Často kladené otázky

Co je MCP server?

MCP (Model Context Protocol) je otevřený protokol od Anthropicu, kterým AI aplikace mluví s externími systémy. Funguje jako univerzální kabel: jeden a tentýž audioknižní katalog tak zpřístupníme Claudu, ChatGPT, Cursoru i Perplexity současně, aniž bychom pro každého psali zvlášť integraci.

Co s tím můžu jako uživatel dělat?

Po napojení MCP serveru můžete v AI chatu psát přirozeně: „Najdi audioknihu Hobit a porovnej ceny", „Co dabuje Václav Knop?" nebo „Detektivky pod 200 Kč v češtině". AI vyhledá přímo v našem katalogu a vrátí strukturovanou odpověď s odkazy na jednotlivé obchody.

Potřebuju API klíč?

Ne. Anonymous tier je veřejný a zdarma — pouze rate-limit 60 požadavků za minutu na IP adresu. Pokud potřebujete vyšší limity (B2B, partnerský přístup), napište nám na /kontakt.

Funguje to i bez instalace? Jen v prohlížeči?

Ano — implementovali jsme i WebMCP. Když navštívíte audioknihy.cz v prohlížeči, který WebMCP podporuje (Chrome 146+ Canary, brzy stable), AI asistent v browseru získá přístup ke stejným nástrojům automaticky, bez konfigurace.

Co se stane, když AI doporučí audioknihu? Dostanete provizi?

Ano, jsme affiliate srovnávač — platí to stejné jako pro běžné návštěvy přes web. Nástroj list_partners (a každá odpověď s odkazem na obchod) vrací URL ve formátu /go/<partner>, abyste mohli AI agenta naučit transparentně sdělit, že nákup po kliknutí přináší audioknihy.cz provizi. Cena pro koncového zákazníka je vždy shodná s nákupem napřímo.