Strukturierte Daten validieren per MCP

validate_structured_data auf einzelne Entitätstypen oder spezifische Produkte und Kategorien eingrenzen — mit den neuen Parametern entity_type und entity_id.

Zuletzt aktualisiert: 2026-04-16

Strukturierte Daten validieren per MCP

Das MCP-Tool validate_structured_data prüft JSON-LD-Markup im Storefront. Es kann den gesamten Shop scannen oder gezielt auf einen Entitätstyp bzw. eine einzelne Entität eingeschränkt werden.

Weiterführende Informationen zum SEO-Audit-Workflow finden Sie unter KI-Agent → SEO-Audit per KI.


Alle strukturierten Daten prüfen

Ohne zusätzliche Parameter scannt das Tool den gesamten Shop — das Verhalten entspricht dem bisherigen Standard:

„Validiere alle strukturierten Daten im Shop."

Das Ergebnis ist eine Liste von Schema-Validierungsergebnissen: für jeden geprüften Entitätstyp wird zurückgegeben, wie viele Einträge gültig sind und welche konkreten Probleme gefunden wurden.


Nur Produkte oder nur Kategorien prüfen

Mit dem optionalen Parameter entity_type lässt sich der Scan auf einen Entitätstyp eingrenzen:

WertWas geprüft wird
productNur Produkt-Schema-Typen (z. B. Product, Offer)
categoryNur Kategorie-Schema-Typen (z. B. CollectionPage)

Beispiele:

„Validiere die strukturierten Daten nur für Produkte."

„Prüfe das JSON-LD-Markup aller Kategorien."


Eine einzelne Entität prüfen

Um genau ein Produkt oder eine Kategorie zu prüfen, geben Sie zusätzlich zu entity_type die numerische ID als entity_id an:

„Validiere die strukturierten Daten des Produkts mit der ID 42."

„Prüfe das Schema-Markup der Kategorie mit der ID 7."

Der Agent sucht die ID in der Produkt- bzw. Kategorie-Datenbank und gibt das Validierungsergebnis nur für diesen Eintrag zurück.


Parameter-Übersicht

ParameterTypPflichtBeschreibung
entity_type"product" | "category"NeinSchränkt den Scan auf einen Entitätstyp ein
entity_idString (wird intern zu Zahl umgewandelt)NeinSchränkt den Scan auf eine einzelne Entität ein

Hinweise

  • entity_id wird nur berücksichtigt, wenn gleichzeitig entity_type angegeben ist. Wird entity_id ohne entity_type übergeben, hat es keine Filterwirkung — der gesamte Shop wird gescannt.
  • entity_id muss als String übergeben werden (z. B. "42"); das Tool wandelt den Wert intern in eine Zahl um.
  • Das Tool ist schreibgeschützt: Es verändert weder die Entitäten noch die Audit-Ergebnisse in der Datenbank.