JSON-LD: Formát pro implementaci schema.org v HTML

JSON-LD: co to je a proč ho používat

JSON-LD (JavaScript Object Notation for Linked Data) je standard W3C pro vyjádření propojených dat přímo v HTML dokumentu. Nejčastěji se používá pro vkládání slovníku schema.org do stránek tak, aby vyhledávače, asistenti (AIO/AEO) a jazykové modely (LLM) spolehlivě pochopily entitní význam obsahu. Na rozdíl od mikroformátů a RDFa nezasahuje do značkování prvků v DOM, je čitelný, přenositelný a snadno spravovatelný v build procesech.

Klíčové výhody JSON-LD pro moderní SEO a AIO/AEO

Oddělení prezentace od dat: strukturovaná data jsou v samostatném bloku a nenarušují vizuální šablony.
Stabilita při refaktoringu: změny HTML/CSS nevyžadují přepis datových atributů.
Jednoduché verzování a CI/CD: JSON je vhodný pro lintování, testy a generování.
Podpora vyhledávačů: Google, Bing a další doporučují JSON-LD pro schema.org.
Přístupnost pro LLM: modely snadno konzumují JSON a vytvářejí interní znalostní grafy stránek.

Architektura a základní prvky JSON-LD

@context: vždy "https://schema.org" (nebo "http://schema.org" pro zpětnou kompatibilitu).
@type: typ entity, např. Article, Product, Organization.
@id: stabilní identifikátor (ideálně kanonická URL s fragmentem), usnadňuje prolinkování.
@graph: pole entit tvořících lokální znalostní graf stránky.
IRI/URL pole: url, image, sameAs, mainEntityOfPage.

Nejčastěji používané typy schema.org

WebSite a WebPage: rámují web a aktuální stránku.
Organization/LocalBusiness: identita značky a provozovny.
BreadcrumbList: drobečková navigace.
Article/BlogPosting/NewsArticle: publikační obsah.
Product (+ Offer, AggregateRating): e-commerce.
FAQPage, HowTo, Event, JobPosting: rozšířené prvky vyhledávání.

Minimální příklad: základní entita stránky

Následující blok reprezentuje web, stránku a navigační drobečky v jednom souboru pomocí @graph:

Identita značky a propojení entit

Silná identita pomáhá konsolidovat signály napříč doménami. Použijte Organization/LocalBusiness s @id, url, logo, sameAs a propojte ho v @graph s WebSite, WebPage i s obsahem.

Článek pro LLM a vyhledávače: Article/BlogPosting

Publikační obsah by měl obsahovat metadata o autorství, datech, obrázku, předmětné kategorii a vazbu na stránku (mainEntityOfPage). U autorů použijte Person nebo Organization a stabilní @id.

E-commerce: Product, Offer a recenze

Pro produkty jsou důležité sku, brand, gtin, offers s priceCurrency/price a availability. Agregovaná hodnocení používají AggregateRating. Dbejte na shodu obsahu na stránce s daty (tzv. content-parity).

FAQ a HowTo: odbourání bariér pro AEO

Formáty FAQPage a HowTo pomáhají asistentům (AEO) generovat přímé odpovědi. Každá otázka/odpověď by měla odpovídat viditelnému obsahu.

Lokální firmy a události

U lokálního SEO doplňte address (PostalAddress), geo, openingHoursSpecification, telephone a propojte na Organization. U událostí uvádějte startDate/endDate, místo (Place), případně offers.

Modelování více entit pomocí @graph

@graph umožňuje vytvořit kompaktní lokální znalostní graf: každá entita má vlastní @id, propojení realizujete přes odkazy na @id. Tímto se vyhnete duplicitě a usnadníte inferenci LLM.

Stabilní identifikátory a kanonické URL

Používejte kanonickou URL s fragmentem (např. https://domena.tld/stranka#entity).
Neměňte @id při drobných úpravách obsahu; mění se pouze obsahová pole (dateModified a podobně).
U opakujících se prvků (autor, organizace) zvolte jednu autoritativní URI.

Mezijazykové a regionální varianty

U vícejazyčných webů zohledněte inLanguage a propojte jazykové verze přes WebPage uzly (i s url obsahujícími hreflang). Dávejte pozor na konzistenci názvu produktu, měny v Offer a lokální dostupnosti.

Generování JSON-LD na straně serveru a klienta

SSR/SSG: preferované – data jsou ihned dostupná pro crawlery i bez JS.
Hydratace klientem: pokud je nutná, vložte kompletní blok při první renderaci a minimalizujte pozdější mutace.
Headless CMS: ukládejte schémata jako šablony s parametry; validujte v pipeline.

Validace a testování

Pravidelně kontrolujte syntaktickou správnost JSON (lint) a požadavky pro rozšířené výsledky (rich results).
Automatizujte snapshot testy pro klíčové stránky (porovnání očekávaného a generovaného JSON-LD).
Monitorujte změny ve specifikacích schema.org a doporučeních vyhledávačů.

Nejčastější chyby a jak se jim vyhnout

Nekonzistence s obsahem: hodnoty v JSON-LD musí odpovídat viditelnému textu (cena, dostupnost, recenze).
Chybějící @id: bez stabilních identifikátorů je obtížné propojit entitní uzly.
Duplicitní entity: sloučte je přes společné @id a sameAs.
Přehnané typování: zvolte nejbližší specifický typ, ale nepřeplňujte irelevantními vlastnostmi.
Chybné datumy a měny: používejte ISO formáty (YYYY-MM-DD) a kódy ISO 4217.

JSON-LD pro konverzační náhledovost a LLM

Jazykové modely využívají JSON-LD jako explicitní vrstvu faktů: pomáhá rozlišit entity, stabilizuje názvy a vztahy a zkracuje cestu od extrakce k odpovědi. Pro asistenty (AIO/AEO) je důležité doplňovat:

sameAs na autoritativní profily (Wikidata, LinkedIn, oficiální sociální sítě).
about/mentions na jiné entity v článku.
knowsAbout u autorů/organizací pro tematickou expertízu.

Bezpečnost, transparentnost a zásady

Nezavádějte: strukturovaná data musí věrně odrážet stránku.
Nesdílejte citlivé osobní údaje bez právního základu.
Respektujte licence při odkazování na obrázky (ImageObject může obsahovat license).