# NovéKnihy.com

> Český knihkupecký katalog: nové knihy, e-knihy a bazarové kusy, 579 titulů
> v prodeji a rejstřík 8 354 autorů a 1 637 nakladatelství. Obchod umí
> obsloužit i AI agenta -- čtení katalogu, košík i dokončení nákupu přes JSON API.

Stránky jsou česky. Každá kniha má jednu adresu a drží pod ní všechna svá
vydání; ceny a dostupnost jsou vždy u konkrétního vydání, ne u díla.

## Katalog pro čtení

- [Všechny knihy](https://www.noveknihy.com/cs/knihy): výpis katalogu od nejnovějších.
- [Autoři](https://www.noveknihy.com/cs/autori): rejstřík autorů, každý s vlastní stránkou.
- [Nakladatelství](https://www.noveknihy.com/cs/nakladatele): rejstřík nakladatelů.
- [Vyhledávání](https://www.noveknihy.com/advanced_search.php): fulltext nad názvy, autory, anotacemi a ISBN vydání.

## Jak je popsaná kniha

- Adresa knihy je `https://www.noveknihy.com/cs/knihy/nazev-autor` -- bez čísel a bez kategorie.
- Jedna stránka = jedno dílo. Vydání (tisk, dotisk, e-kniha, bazarový kus)
  jsou její části; každé má svého nakladatele, rok, ISBN, vazbu, počet
  stran, překladatele a často i předmluvu, doslov nebo ilustrace.
- Na konkrétní vydání se dá odkázat kotvou: `https://www.noveknihy.com/cs/knihy/nazev-autor#vydani-34`.
- Anotace mluví o díle. Co je zvláštního na jednom tisku -- přepracovaný
  překlad, ilustrace, věnování -- stojí u toho vydání.

## JSON pro agenty

- [Popis rozhraní (OpenAPI)](https://www.noveknihy.com/agent/openapi.json): všechny endpointy a schémata.
- [Discovery dokument](https://www.noveknihy.com/.well-known/agentic-commerce.json): strojový rozcestník.
- [Hledání](https://www.noveknihy.com/agent/search.php?q={dotaz}): výsledky jako JSON.
- [Detail knihy](https://www.noveknihy.com/agent/product.php?id={id}): včetně pole `editions[]` se všemi vydáními, cenami a odkazem do košíku.
- [Košík](https://www.noveknihy.com/agent/cart.php) a [pokladna](https://www.noveknihy.com/agent/checkout.php): nákup jménem přihlášeného zákazníka.
- [Vydání tokenu](https://www.noveknihy.com/account_agent_tokens.php): token si zakládá zákazník ve svém účtu; posílá se jako `Authorization: Bearer`.

Agent nakupuje jen v mezích výdajového mandátu, který mu zákazník u tokenu
nastaví. Samostatný JSON-RPC MCP transport zatím není -- klient s OpenAPI
a Bearer tokenem použije `openapi.json`. Nástroje WebMCP jsou přímo na
stránkách obchodu, bez instalace serveru.

## Strukturovaná data na stránkách

- Stránka knihy nese JSON-LD typu `["Product", "Book"]`.
- Každé vydání je v `workExample[]`: `bookEdition`, `datePublished`, `isbn`,
  `numberOfPages`, `bookFormat`, `inLanguage`, `publisher`, `translator`,
  `illustrator` a `contributor` s rolí.
- Nabídka je `offers` s cenou, měnou, dostupností a stavem (nové/bazar).

## Nákup

- [Košík](https://www.noveknihy.com/shopping_cart.php) a [nákup bez registrace](https://www.noveknihy.com/checkout_guest.php): stačí e-mail.
- [Doprava a vrácení](https://www.noveknihy.com/shipping.php), [obchodní podmínky](https://www.noveknihy.com/conditions.php).
- [Jak doporučujeme knihy](https://www.noveknihy.com/personalisation.php): co se o návštěvníkovi ukládá a proč.

## Další

- [Nákup s AI](https://www.noveknihy.com/ai.php): totéž pro člověka -- jak obchod přidat do klienta.
- [Dokumentace](https://www.noveknihy.com/cs/dokumentace/): jak je obchod postavený.
- [Kontakt](https://www.noveknihy.com/contact_us.php)