Cookie-Einstellungen

Notwendige Cookies halten die Seite am Laufen. Analytics zeigt, welche Seiten nützlich sind. Die Wahl lässt sich jederzeit im Footer ändern.

Cookie-Richtlinie dieser Website – alle Details: Cookie-Kategorien, wie wir Ihre Auswahl im Browser speichern und wie Sie Ihre Einwilligung widerrufen.

Notwendig

Grundfunktionen der Seite und Ihre Einwilligung. Immer aktiv.

Analyse

Hilft zu verstehen, wie die Seite genutzt wird. Wird nur nach Ihrer Zustimmung geladen.

GitHubZIP herunterladen

Strukturierte Daten und Schema-Validator

Prüfen Sie JSON-LD, Microdata und RDFa gegen das mitgelieferte Schema.org-Vokabular und lokale Regeln für Rich-Suchergebnisse von Google. Mit schema-build entwerfen Sie neues JSON-LD.

Auf GitHub ansehenSchnellstart

Was es leistet

  • SpiderHead Desktop-App: der Tab Schema der URL mit erkannten und ausgewerteten JSON-LD-Blöcken.
  • SpiderHead im Terminal: seohead schema-check

Zwei Validierungsebenen

Ebene eins prüft, ob das Markup gültiges Schema.org ist: Der Typ existiert, die Eigenschaft ist auf ihm erlaubt, geerbte Eigenschaften zählen mit und der Wert passt zum erwarteten Typ. Ebene zwei prüft die lokal sichtbaren Bedingungen für Rich-Suchergebnisse von Google, etwa Pflichteigenschaften. Eine bestandene Ebene zwei heißt nicht, dass Google das Rich-Suchergebnis anzeigt.

  • Mitgeliefertes Schema.org-Vokabular, funktioniert offline
  • Geerbte Eigenschaften werden berücksichtigt; ein author an einem Article ist deshalb kein Fehler.
  • Pflicht-Eigenschaften und Eigenschaften, von denen eine nötig ist, für Typen mit Rich-Suchergebnissen
  • Parse-Fehler werden gemeldet, wenn ein JSON-LD-Block kein gültiges JSON ist.

Das Markup als Graph

Entitäten werden über @id-Verweise verknüpft. Der Checker erfasst, welche Entitäten eine @id tragen, welche verknüpft sind, welche allein stehen und ob ein Verweis ins Leere zeigt. Eine isolierte Entität ist ein nützlicher Befund, weil Suchmaschinen sie nicht mit dem Rest der Seite verbinden können.

  • Entitäten ohne @id oder ohne Verbindung zum Rest
  • Verweise auf eine @id, die nicht existiert
  • Markup aus JSON-LD, Microdata und RDFa

Markup erstellen

schema-build entwirft einen zusammenhängenden @graph für den Seitentyp und nutzt dabei nur Fakten, die auf der Seite sichtbar sind. Es zeigt die Signale, auf die es sich stützt, und seine Sicherheit beim Typ. Ist die Vermutung schwach, legen Sie den Typ selbst mit --type fest und prüfen den Entwurf, bevor er live geht.

  • Fakten nur von der Seite
  • Typvermutung mit Signalen und Sicherheitsgrad
  • --type zum Überschreiben
  • Fehlende empfohlene Felder werden aufgelistet

Drei Schritte, ein gespeicherter Scan

  1. Gegen das Schema.org-Vokabular validieren

    schema-check liest die strukturierten Daten der Seite und prüft jeden Typ und jede Eigenschaft gegen das mitgelieferte Schema.org-Vokabular.

  2. Das Markup als Graph prüfen

    Das Tool erfasst, welche Entitäten eine @id tragen, welche verknüpft sind, welche allein stehen und ob ein @id-Verweis ins Leere zeigt.

  3. Fehlendes Markup ergänzen

    schema-build schlägt einen zusammenhängenden @graph vor, der nur Fakten aus der sichtbaren Seite nutzt, und listet die empfohlenen Felder auf, die noch fehlen.

Prüfungen in dieser Funktion

PrüfungBedeutungSchweregradBeleg
SCHEMA_VALIDATION_ERRORDie strukturierten Daten der Seite enthalten Validierungsfehler gegen das Schema.org-VokabularImportantAnzahl der Validierungsfehler pro Seite
STRUCTURED_DATA_PARSE_ERROREin JSON-LD-Block ist vorhanden, lässt sich aber nicht als gültiges JSON auslesen, daher ignorieren Suchmaschinen ihnImportantGefundene gegen ausgelesene Blöcke
STRUCTURED_DATA_MISSINGDie Seite enthält kein Schema.org-MarkupTipSeite ohne strukturierte Datenblöcke
Außerdem im Prüfungsregister
STRUCTURED_DATA_SCHEMA_ERRORSTRUCTURED_DATA_SCHEMA_WARNINGSTRUCTURED_DATA_RICH_RESULT_REQUIRED_MISSING

Ein Befehl

bash
seohead schema-check --url https://example.com/product

Zuerst installieren: Installationsanleitung. Jeder Befehl läuft auch als MCP-Tool für KI-Agenten.

Was Sie brauchen

  • Eine Seiten-URL oder das HTML selbst (Argument html) für eine Prüfung offline
  • Ein Typname für schema-build, wenn die Vermutung schwach ist
  • Keine API-Schlüssel

Grenzen

  • Eine statische Prüfung kann nicht erkennen, ob Google ein Rich-Suchergebnis tatsächlich anzeigt.
  • Das Tool sieht nur das HTML, das es erhält: Markup, das per JavaScript eingefügt wird, bleibt unerkannt, solange das HTML nicht vorher gerendert ist.
  • Die Verarbeitung von RDFa, HTML und Graphgröße ist begrenzt; erreicht sie ein Limit, liefert das Tool ein ausdrücklich unvollständiges Ergebnis.
  • schema-build entwirft Markup, es veröffentlicht es nicht.

Fragen

Was führe ich aus?
seohead schema-check --url https://example.com/product. Um Markup offline zu prüfen, übergeben Sie das HTML selbst im Argument html, zum Beispiel mit --input und einem JSON-Objekt.
Prüft das Tool auch die Eignung für Rich-Suchergebnisse?
Ja, lokal. Ebene eins ist das Schema.org-Vokabular: ob ein Typ existiert, ob eine Eigenschaft auf ihm erlaubt ist und ob ein Werttyp passt. Ebene zwei prüft die Pflicht-Eigenschaften für jeden Typ mit Rich-Suchergebnissen von Google, für den Regeln hinterlegt sind. Ob Google das Ergebnis anzeigt, kann das Tool nicht wissen.
Welche Markup-Formate werden gelesen?
JSON-LD, Microdata und RDFa. Ein JSON-LD-Block, der sich nicht auslesen lässt, wird als Parse-Fehler gemeldet, weil Suchmaschinen ihn ignorieren.
Erfindet schema-build Fakten für meine Seite?
Nein. Es baut den Graphen nur aus Fakten, die auf der Seite sichtbar sind. Es zeigt die Signale und seine Sicherheit. Ist die Typvermutung wenig sicher, legen Sie den Typ mit --type selbst fest.
Verändert es meine Website?
Nein. Beide Befehle lesen nur die Seite. Das JSON-LD, das es entwirft, ist ein Vorschlag, den Sie prüfen und selbst ausrollen.
Läuft das auch in einem Crawl?
Ja. Ein Crawl erfasst die Befunde zu strukturierten Daten pro Seite: fehlendes Markup, Parse-Fehler, Schema-Fehler und fehlende Pflicht-Eigenschaften für Rich-Suchergebnisse.

Weiterstöbern

Aus Blog und Glossar

Schema.org JSON-LD: Strukturierte Daten für die Google-SucheBlogSchema.orgGlossarJSON-LD: strukturierte Daten als verknüpftes JSONGlossarStrukturierte DatenGlossar

Mehr in dieser Gruppe · Audit

Technischer SEO-AuditFunktionWeiterleitungsprüfung: Ketten, Schleifen und 302-WeiterleitungenFunktionBroken-Link-Checker mit Quelle und PositionFunktionCanonical-Tag-PrüfungFunktionHreflang-CheckerFunktionPrüfung von Title und Meta-DescriptionFunktionPrüfung der ÜberschriftenstrukturFunktionPrüfung auf Duplicate und Thin ContentFunktionImage-SEO-Checker und OptimiererFunktionAudit der internen Verlinkung und Crawl-TiefeFunktionSeitengewicht- und GeschwindigkeitsprüfungenFunktionHTTPS- und Sicherheits-Header-PrüfungFunktionKI-Sichtbarkeit in der Suche (GEO/AEO)Funktion

Testen Sie es auf Ihrer eigenen Website

ZIP herunterladenAlle Funktionen