LW IT Solutions logo LW IT Solutions logo LW IT Solutions
« Blog-Übersicht /Digital Marketing/Tutorials / Strukturierte Website-Daten mit JSON-LD prüfen: Was Suchmaschinen...
Diesen Artikel in anderen Sprachen lesen:

Strukturierte Website-Daten mit JSON-LD prüfen: Was Suchmaschinen auslesen können

Strukturierte Website-Daten mit JSON-LD prüfen: Was Suchmaschinen auslesen könnenStrukturierte Website-Daten mit JSON-LD prüfen: Was Suchmaschinen auslesen können

Management Summary

Strukturierte Daten beschreiben Website-Inhalte für Suchmaschinen, etwa als Artikel, Organisation oder Bild. JSON-LD ist ein Format, das solche Angaben neben dem sichtbaren Seiteninhalt bereitstellt. Das kann besondere Suchdarstellungen unterstützen, garantiert diese jedoch nicht. Der Beitrag erklärt, warum das Zählen von Datenblöcken keine Qualitätsbewertung ersetzt. Die Angaben müssen zum Inhalt und zum empfangenden Dienst passen; eine begrenzte Untersuchung kann zudem Teile der Informationen übersehen.

Inhalt
  1. Was ein Nichtfund bedeutet
  2. 243 Blöcke sind keine 243 eindeutigen Dinge
  3. Welche Typen der Auswerter auflistete
  4. Drei Ebenen der Prüfung
  5. Kennungen, Kontext und Typen
  6. Datums- und Brotkrumenhinweise richtig bewerten
  7. HTML auslesen, ohne Validierung vorzutäuschen
  8. Fragen und Antworten
  9. Quellen

JSON-LD ergänzt HTML um maschinenlesbare Angaben, etwa zu Artikeln, Organisationen oder Bildern. Ein solcher Datenblock wird im Browser nicht als JavaScript ausgeführt. Suchmaschinen können die Angaben auswerten; eine Nutzung durch sämtliche Vorschau- oder Assistenzdienste ist damit nicht zugesichert.

Die historische Messung vom 6. September 2026 untersuchte das ausgelieferte HTML von zwanzig Domains ohne JavaScript-Ausführung. Gefunden wurden 243 JSON-LD-Blöcke. Der begrenzte Auswerter führte daraus 97 Objekte auf.

Zwanzig Domains, neun Antworten mit Funden, 243 Blöcke und 97 begrenzte Werkzeugeinträge
Historische Werkzeugausgabe, keine vollständige Graphzählung oder Freigabe für Suchdarstellungen.

Was ein Nichtfund bedeutet

Neun Antworten enthielten erkannte JSON-LD-Blöcke, elf nicht. Unter den elf Nichtfunden waren jedoch zwei Antworten mit HTTP 403: Stack Overflow und Allegro. Diese Sperrantworten erlauben keine Aussage über das JSON-LD der regulären Startseiten. Für die übrigen neun Antworten gilt lediglich: Im gelesenen HTML erkannte das Werkzeug keinen passenden Block.

Auch ein erfolgreicher Abruf ohne JSON-LD beweist keine fehlende Maschinenlesbarkeit. Microdata, RDFa und andere Metadaten wurden nicht untersucht. Ob JSON-LD sinnvoll ist, hängt von Inhalt und gewünschter Nutzung ab. Korrekte Strukturdaten können bestimmte Suchdarstellungen ermöglichen, garantieren aber weder eine solche Darstellung noch einen Rankingvorteil.

243 Blöcke sind keine 243 eindeutigen Dinge

Ein Block ist hier ein erkanntes <script type="application/ld+json">-Element. Ein Block kann mehrere Objekte enthalten, beispielsweise in @graph. Umgekehrt können mehrere Blöcke dasselbe Objekt über dieselbe Kennung beschreiben.

Die Zeit-Seite lieferte 164 erkannte Blöcke, Heise 67; die übrigen sieben Antworten zusammen zwölf. Der Auswerter listete pro Seite höchstens vierzig Objekte. Zeit und Heise erreichten beide diese Grenze. Verschachtelte Objekte in Eigenschaften wie author werden nicht vollständig durchlaufen; gleiche Kennungen werden nicht zusammengeführt. Die 97 Einträge sind deshalb ein Werkzeugzähler, keine vollständige Zahl eindeutiger JSON-LD-Knoten.

Welche Typen der Auswerter auflistete

Die 97 Einträge umfassen 41 ItemList, 37 ImageObject, sechs WebSite, drei Organization, drei NewsMediaOrganization, vier WebPage sowie jeweils eine CollectionPage, ProfilePage und Person. Listen und Bilder stellen damit 78 der 97 Einträge. Die Begrenzung auf frühe Objekte kann diese Verteilung erheblich beeinflussen.

ItemList beschreibt eine Liste, ImageObject ein Bild. Der Typ allein beweist weder eine festgelegte Reihenfolge noch vollständige Bildmaße oder die Zulassung zu einem Nachrichtenkarussell. Solche Aussagen benötigen passende Eigenschaften und die Regeln des konkreten Empfängers.

Drei Ebenen der Prüfung

Eine belastbare Prüfung trennt gültiges JSON, die Bedeutung nach JSON-LD und Schema.org sowie zusätzliche Anforderungen eines Suchfeatures. Die damalige Werkzeugliste meldete dreizehn Einträge als vollständig, einen Eintrag mit fehlenden Feldern und 83 ohne eigene Feldliste. Beim betroffenen WebSite-Eintrag wurden name und url beanstandet. Diese Zähler sind keine allgemeine Qualitätsfreigabe.

Die eingebauten Listen entsprechen nicht durchgehend aktuellen Google-Anforderungen. Beispielsweise nennt Google für Article derzeit empfohlene Eigenschaften und ausdrücklich keine Pflichtfelder. Das Werkzeug verlangt trotzdem unter anderem Autor, Bild und Veröffentlichungsdatum. Ein solcher Hinweis sollte gegen die aktuelle Feature-Dokumentation geprüft werden.

Kennungen, Kontext und Typen

Relative Kennungen sind in JSON-LD erlaubt. Bei der Dokumentadresse https://example.com/about verweist "@id": "#organization" auf https://example.com/about#organization, sofern keine abweichende Basis gilt. Für seitenübergreifend stabile Referenzen sind bewusst gewählte absolute Kennungen oft übersichtlicher; Fragmente sind jedoch kein grundsätzlicher Fehler.

Ein Kontext legt fest, was Feldnamen bedeuten, etwa aus welchem Begriffssystem das Feld name stammt. Der Kontext kann für enthaltene Objekte gelten und muss nicht an jedem Objekt wiederholt werden. Auch ein Objekt ohne ausdrücklichen Typ kann gültige JSON-LD-Daten enthalten. Spezielle Suchdarstellungen können trotzdem einen bestimmten Typ verlangen. Ein vollständiger JSON-LD-Prozessor löst solche Zusammenhänge auf; der einfache Werkzeugabgleich auf die Zeichenfolge schema.org ersetzt diese Verarbeitung nicht.

Datums- und Brotkrumenhinweise richtig bewerten

Datumswerte benötigen die zum Feld passende Form und bei Zeitangaben eine eindeutige Zeitzone. Ein frühes Änderungsdatum kann etwa durch Planung, Import oder falsch interpretierte Zeitzonen entstehen. Sachlich richtige Zeitpunkte sollten erhalten bleiben; ein Datum allein zur Beruhigung eines Prüfers nach vorn zu setzen wäre keine Korrektur. Der vorhandene Parser akzeptiert zudem manche ungültigen Kalendertage.

Brotkrumen zeigen die Einordnung einer Seite, etwa Startseite → Artikel → Aktueller Artikel. Für diese Angaben verlangt Google unter anderem Namen und Positionen. Beim letzten Eintrag darf das Ziel item fehlen. Eine Nummerierungslücke verdient Prüfung, beweist aber nicht, dass jeder Empfänger alle folgenden Einträge verwirft. HTML innerhalb eines Textwerts muss ebenfalls nach Eigenschaft und Empfänger beurteilt werden; eine universelle Darstellungsregel existiert nicht.

HTML auslesen, ohne Validierung vorzutäuschen

Das folgende Python-3-Beispiel liest eine lokal gespeicherte HTML-Datei in UTF-8. Ein HTML-Parser erkennt mehrzeilige Blöcke und unterschiedliche Attributreihenfolgen. Fehlerhaftes JSON wird gemeldet; spätere Blöcke werden weiter gelesen. Das Beispiel prüft nur die JSON-Syntax, führt kein JavaScript aus und verarbeitet weder Kontexte noch den vollständigen JSON-LD-Graphen.

Python
import json
import sys
from html.parser import HTMLParser
from pathlib import Path

class Blocks(HTMLParser):
    def __init__(self):
        super().__init__(convert_charrefs=False)
        self.active = False
        self.parts = []
        self.blocks = []

    def handle_starttag(self, tag, attrs):
        if tag == "script":
            kind = dict(attrs).get("type") or ""
            self.active = kind.strip().lower() == "application/ld+json"
            self.parts = []

    def handle_data(self, data):
        if self.active:
            self.parts.append(data)

    def handle_endtag(self, tag):
        if tag == "script" and self.active:
            self.blocks.append("".join(self.parts))
            self.active = False
            self.parts = []

def invalid_constant(value):
    raise ValueError(f"Not a JSON constant: {value}")

parser = Blocks()
parser.feed(Path(sys.argv[1]).read_text(encoding="utf-8"))
parser.close()
failed = False
for number, raw in enumerate(parser.blocks, 1):
    print(f"Block {number}")
    try:
        data = json.loads(raw, parse_constant=invalid_constant)
    except ValueError as error:
        print(f"Invalid JSON: {error}", file=sys.stderr)
        failed = True
        continue
    print(json.dumps(data, ensure_ascii=False, indent=2))
print(f"Complete JSON-LD script blocks: {len(parser.blocks)}")
raise SystemExit(1 if failed else 0)

Aufruf: python3 jsonld-read.py page.html. Die Datei page.html enthält zuvor gespeichertes HTML. Nicht abgeschlossene Script-Elemente werden nicht als vollständige Blöcke ausgegeben.

Der Strukturdaten-Prüfer für JSON-LD liefert einen ersten Überblick mit den beschriebenen Grenzen. In der historischen Messung wurde außerdem die Spiegel-Antwort am HTML-Limit von 1,5 MiB gekürzt. Nachgeladene Daten fehlen in dieser Sicht grundsätzlich.

Fragen und Antworten

Müssen zusammengehörige Daten in einem einzigen Block stehen?

Nein. Die JSON-LD-Spezifikation verlangt bei der allgemeinen Verarbeitung eingebetteter Daten die Zusammenführung aller passenden Script-Blöcke. Ein gemeinsamer Graph kann die Pflege erleichtern, ist aber keine Voraussetzung für gültige Verknüpfungen. Einschränkungen einzelner Verbraucher müssen gesondert geprüft werden.

Blockiert eine strenge CSP JSON-LD?

Ein korrekt als application/ld+json deklarierter Datenblock wird nicht als Script ausgeführt und benötigt dafür keinen Script-Nonce oder Hash. JavaScript, das den Block erst erzeugt, unterliegt dagegen weiterhin der CSP.

Welche Inhalte dürfen ausgezeichnet werden?

Für Google-Suchdarstellungen müssen die Angaben relevant sein und den tatsächlichen Seiteninhalt korrekt wiedergeben. Irreführende oder versteckte ausgezeichnete Inhalte können die Eignung verhindern. Die JSON-LD-Syntax allein bewertet diese inhaltliche Übereinstimmung nicht.

Sind dynamisch erzeugte Blöcke grundsätzlich unsichtbar?

Nein. Google unterstützt auch per JavaScript erzeugte Strukturdaten. Entscheidend ist die erfolgreiche Verarbeitung beim Rendering. Ein Abruf ohne JavaScript zeigt nur den ausgelieferten Zustand; das Verhalten anderer Empfänger muss gesondert geprüft werden.

Lukas Wojcik

Lukas Wojcik

Systems architect and technology enthusiast specializing in scalable tracking solutions, GMP Stack (GA4 & GTM), and robust backend architectures. Advocate for clean code and privacy-first design.

Kontakt

Eine Frage oder eine Idee für ein Webprojekt? Schreib mir kurz, worum es geht. Das Formular nutzt reCAPTCHA und formconfirmed zum Schutz vor Spam.

Kommentar schreiben

Erfahrungen aus der Praxis und Rückfragen zur Umsetzung sind hier willkommen.

Die E-Mail-Adresse wird nicht veröffentlicht. Pflichtfelder sind mit einem Stern versehen.

LUKASWOJCIK.COM · NEWSLETTER

Neue Ideen im Postfach

Neue Blogartikel, praktische Tools und Einblicke in die Projekte.

Themen auswählen (optional)
Ohne Auswahl: alle Themen.

Erst nach Bestätigung per E-Mail. · Datenschutz

Datenschutz · Newsletter

E-Mail-Adresse, Sprache, Themenauswahl sowie Anmelde- und Bestätigungszeit werden für den Newsletter gespeichert. Versand nur nach Double-Opt-in. Jede Ausgabe enthält eine sofortige Abmeldung. Formconfirmed prüft die Anmeldung auf Spam; dafür werden Formularsignale und die E-Mail-Adresse verarbeitet. Keine Öffnungs- oder Klicktracking-Pixel im Newsletter.

Vollständige Datenschutzerklärung öffnen ↗