Implementace JSON-LD: formát, který AI systémy preferují

Schema markup říká strojům, co váš obsah znamená. Záleží ale na použitém formátu. Schema markup lze zapsat ve třech různých jazycích: Microdata, RDFa a JSON-LD. Většina webu používá Microdata, protože je staré a snadné. AI systémy preferují JSON-LD, protože je čisté, strukturované a jednoznačné.

JSON-LD znamená JSON for Linking Data. Je to formát vynalezený speciálně proto, aby strukturovaná data byla strojově čitelná, aniž by zahlcovala váš HTML kód. Zapisuje se v samostatné značce script. Váš viditelný obsah zůstává čistý. Strojově čitelná data sedí ve vlastním bloku. AI crawlery zpracovávají JSON-LD rychleji a spolehlivěji než jiné formáty. Pokud chcete, aby byl váš obsah citovatelný pro AI systémy, JSON-LD je způsob, jak toho dosáhnout.

Proč JSON-LD poráží jiné formáty schématu

Microdata vypadají takto. Atributy přidáváte přímo do značek HTML:

<div itemscope itemtype="https://schema.org/Article">
<h1 itemprop="headline">Article Title</h1>
<p itemprop="description">Article summary.</p>
</div>

Funguje to. Google to čte. Váš HTML se ale zaplní atributy schématu. Obsah a metadata jsou propletené.

JSON-LD je od sebe zcela odděluje:

<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "Article Title",
"description": "Article summary"
}
</script>

Váš HTML zůstává čistý. Strojově čitelná data jsou ve vlastní značce script. AI crawlery toto oddělení preferují. Je přehlednější. Je menší pravděpodobnost chyb. Zpracovává se rychleji.

RDFa je třetí formát, ale používá se zřídka. Je složitější než Microdata i JSON-LD. Ani Google, ani AI systémy ho nepreferují. RDFa přeskočte.

Jak AI systémy čtou JSON-LD

Když AI crawler navštíví vaši stránku, udělá dvě věci. Přečte váš viditelný obsah HTML. A zpracuje všechny značky script s JSON-LD, které najde.

JSON-LD mu říká: tato stránka je Article. Byla zveřejněna v tento den. Napsal ji tento autor. Hlavní téma je toto. Na této adrese URL je obrázek. Počet slov je tento. Všechna tato metadata pomáhají AI systému porozumět obsahu hlouběji, než by dokázal jen z textu.

Když se AI systém později rozhoduje, zda vás zacitovat, použije tato metadata. Správně naformátované schéma Article v JSON-LD s datem publikace, autorem a obrázkem je citováno častěji než stejný obsah bez schématu. Metadata dokazují, že jste původní zdroj.

Základní struktura JSON-LD

Každý blok JSON-LD má tři hlavní části. @context říká parseru, jaký slovník používáte (téměř vždy schema.org). @type říká, jaký druh věci popisujete. Vlastnosti popisují konkrétní atributy.

Základní schéma Article vypadá takto:

<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "Your Article Title",
"description": "Your article summary",
"image": "https://yoursite.com/image.jpg",
"datePublished": "2026-04-17",
"author": {
"@type": "Person",
"name": "Author Name"
},
"publisher": {
"@type": "Organization",
"name": "Your Brand",
"logo": {
"@type": "ImageObject",
"url": "https://yoursite.com/logo.jpg"
}
}
}
</script>

Tento blok JSON-LD sedí v hlavičce (head) vaší stránky (nebo kdekoli v těle). Říká crawleru vše, co potřebuje o článku vědět.

Kam umístit JSON-LD na stránce

Osvědčeným postupem je umístit JSON-LD do sekce head vašeho HTML, nad viditelný obsah. Crawler čte nejdřív head, takže metadata schématu získá ještě předtím, než začne zpracovávat tělo.

JSON-LD ale funguje kdekoli na stránce. V head. V těle. Před obsahem. Za obsahem. Nezáleží na tom. Pokud je JSON platný, crawlery ho najdou a zpracují.

Mnoho platforem pro obsah automaticky umisťuje JSON-LD do head, když vyplníte pole metadat. V CMS napíšete nadpis, popis a datum publikace. Platforma JSON-LD vygeneruje automaticky. Nepíšete ho ručně.

JSON-LD pro různé typy obsahu

Article je nejběžnější typ schématu, ale JSON-LD podporuje mnoho typů. Každý typ má jiné povinné a volitelné vlastnosti.

Schéma FAQPage

Pokud má vaše stránka sekci s často kladenými otázkami, použijte schéma FAQPage. Říká AI crawlerům přesně, kde jsou vaše otázky a odpovědi:

<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "What is JSON-LD?",
"acceptedAnswer": {
"@type": "Answer",
"text": "JSON-LD is a structured data format that AI systems prefer."
}
},
{
"@type": "Question",
"name": "Where do I put JSON-LD?",
"acceptedAnswer": {
"@type": "Answer",
"text": "In the head or body of your HTML page."
}
}
]
}
</script>

Schéma FAQPage zvyšuje pravděpodobnost, že AI systémy vaše otázky a odpovědi extrahují správně.

Schéma Product

Pro e-shop použijte schéma Product:

<script type="application/ld+json">
{
"@context": "https://schema.org/",
"@type": "Product",
"name": "Product Name",
"description": "Product description",
"image": "https://yoursite.com/product.jpg",
"brand": {
"@type": "Brand",
"name": "Your Brand"
},
"offers": {
"@type": "Offer",
"url": "https://yoursite.com/product",
"priceCurrency": "USD",
"price": "99.99"
}
}
</script>

Schéma Product říká AI nákupním agentům přesnou cenu, dostupnost a vlastnosti vašeho produktu.

Schéma HowTo

U návodů krok za krokem použijte schéma HowTo:

<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "HowTo",
"name": "How to Set Up JSON-LD",
"step": [
{
"@type": "HowToStep",
"name": "Step 1",
"text": "Add a script tag to your page head."
},
{
"@type": "HowToStep",
"name": "Step 2",
"text": "Write valid JSON inside the script tag."
}
]
}
</script>

Schéma HowTo pomáhá AI systémům pochopit pořadí a extrahovat kroky ve správném pořadí.

Časté chyby s JSON-LD

Nejčastější chybou je neplatný JSON. JSON má přísná syntaktická pravidla. Každý řetězec musí být v uvozovkách. Za každou vlastností musí následovat dvojtečka. Každá položka objektu nebo pole musí být oddělena čárkou. Vynechejte jedinou čárku a celý JSON se rozbije.

Svůj JSON před nasazením otestujte. Použijte nástroj pro validaci JSON. Vložte do něj svůj JSON-LD a řekne vám, zda obsahuje syntaktické chyby.

Druhou chybou je použití špatného @type. Pokud je vaše stránka příspěvek na blogu, použijte Article, ne BlogPosting. Pokud je to produkt, použijte Product, ne Item. Typ záleží, protože crawlery rozumějí struktuře podle typu různě.

Třetí chybou jsou chybějící povinné vlastnosti. Schéma Article vyžaduje nadpis (headline). Schéma Product vyžaduje cenu. HowTo vyžaduje alespoň jeden krok. V dokumentaci schema.org si u každého typu ověřte, co je povinné a co volitelné.

Validace a testování JSON-LD

Google má nástroj Rich Results Test. Vložíte adresu URL a zobrazí všechny JSON-LD, které na stránce našel. Řekne vám, zda je JSON platný. Řekne vám, zda nechybí nějaké povinné vlastnosti. Ukáže, jak vypadají zpracovaná data.

Také schema.org má validační nástroj. Vložte svůj JSON-LD a ověří syntaxi i shodu se schématem.

Většina platforem CMS má vestavěnou validaci. Pokud zveřejníte obsah s chybějícími povinnými vlastnostmi schématu, CMS vás před zveřejněním upozorní.

Často kladené otázky