JSON-LD: princip a využití v moderním SEO a webové prezentaci

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, asistentské systémy (AIO/AEO) a jazykové modely (LLM) spolehlivě pochopily entitní význam obsahu. Oproti mikroformátům a RDFa nezasahuje do značkování prvků v DOM, je čitelný, přenosný 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 linting, 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ámcují 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): ecommerce.
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í drobky 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 je v @graph s WebSite, WebPage i 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ětové kategorii a vazbu na stránku (mainEntityOfPage). U autorů použijte Person nebo Organization a stabilní @id.

Ecommerce: Product, Offer a recenze

Pro produkty jsou důležité sku, brand, gtin, offers s priceCurrency/price a availability. Agregované hodnocení používá 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římou odpověď. Každá otázka/odpověď by měla odpovídat viditelnému obsahu.

Lokální firmy a události

Pro lokální SEO doplňte address (PostalAddress), geo, openingHoursSpecification, telephone, a propojte na Organization. U událostí uvádějte startDate/endDate, místo (Place) a 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. Takto 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 jen obsahová pole (dateModified apod.).
U opakujících se prvků (autor, organizace) zvolte jednu autoritativní URI.

Mezijazykové a regionální variace

Při vícejazyčných webech zohledněte inLanguage a propojte jazykové verze přes WebPage uzly (také 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 prvotním renderu a minimalizujte pozdní mutace.
Headless CMS: ukládejte schémata jako šablony s parametry; validujte v pipeline.

Validace a testování

Průběžně 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.
Špatné datum a měny: používejte ISO formáty (YYYY-MM-DD) a ISO 4217 kódy.

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

Jazykové modely využívají JSON-LD jako explicitní vrstvu faktů: pomáhá disambiguovat 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.
Nezveřejňujte citlivé osobní údaje bez právního základu.
Respektujte licence při odkazování na obrázky (ImageObject může obsahovat license).