"price": "$14.50" kann verhindern, dass Google deinen Produktpreis liest. Ein einziges überflüssiges Komma am Ende macht den gesamten Block unlesbar, und ein Typ namens "Organisation" wird einfach ignoriert. Dieser Skill findet diese und zehn weitere Fehler in strukturierten Daten deiner Seiten und Vorlagen vor der Veröffentlichung. Er erklärt jede Korrektur in einfachen Worten, damit Marketing- und SEO-Teams ohne Codekenntnisse handeln können.

Dein Agent führt einen Scanner für schema.org-JSON-LD in deinen HTML-Seiten, Seitenvorlagen (Shopify Liquid, Jinja und Django, Nunjucks, Handlebars, ERB, EJS, Twig, PHP und Blade, Hugo- und Go-Templates, Vue, Svelte und Astro) und .jsonld-Dateien aus. Er folgt der Dokumentation von Google Search Central für jeden Rich-Suchergebnistyp mit Stand November 2026, versteht @graph, Elementlisten, Elemente mit mehreren Typen, @id-Verweise und in Produkte eingebettete Angebote. Template-Platzhalter wie {{ product.title }} behandelt er als unbekannte Werte, nicht als Fehler. Er benennt eingestellte Google-Funktionen klar: FAQ-Rich-Suchergebnisse endeten im Mai 2026 und How-to-Ergebnisse 2023. Darauf weist er hin, statt sie zu versprechen. Er ruft keine Seiten ab und kontaktiert Google nicht. Das Ergebnis lautet BLOCK, REVIEW oder NOT FLAGGED, jeweils mit Datei, Zeile, Begründung und einem sichereren Vorgehen.

Was geprüft wird

BLOCKIEREN (vor der Auslieferung beheben)

• J01: nicht parsebares JSON (überflüssige oder fehlende Kommas, einfache Anführungszeichen, Kommentare)

• J02: von Google vorgeschriebene Eigenschaften für Rich-Suchergebnisse zu Product, Offer, AggregateOffer, Review, AggregateRating, BreadcrumbList-Elementen, Event, LocalBusiness, Recipe, JobPosting, VideoObject und SoftwareApplication

• J03: JSON-LD in einem script-Element mit falschem Typ, etwa application/json

• J04: schema.org-Elemente ohne @context

• J05: falsch geschriebene Typen oder falsche Groß-/Kleinschreibung (Organisation, product, Website) und Elemente ohne @type

PRÜFEN (vor der Veröffentlichung prüfen)

• J11: fehlende empfohlene Eigenschaften (image, brand, priceCurrency, availability, author, Datumsangaben, logo und weitere) sowie Breadcrumbs mit nur einem Eintrag außerhalb der Startseite

• J12: Preise mit Währungszeichen, Buchstaben oder Tausendertrennzeichen sowie Währungscodes außerhalb von ISO 4217

• J13: Datumsangaben, Zeitspannen und Öffnungszeiten außerhalb von ISO 8601, einschließlich P30M für 30 Minuten

• J14: relative URLs, localhost- oder Staging-URLs und example.com-Platzhalter

• J15: Bewertungen außerhalb ihrer Skala, Dezimalkommas und null Rezensionen

• J16: Werte außerhalb von Googles Listen (availability, itemCondition, eventStatus, employmentType, dayOfWeek, App-Kategorie)

• J17: Markup für Rich-Suchergebnisse, die Google nicht mehr oder im jeweiligen Fall nicht anzeigt (FAQ, How-to, reine Onlineveranstaltungen, selbst vergebene Bewertungssterne eines Unternehmens)

• J18: ein nicht standardkonformer @context wie "schema.org" ohne https://

Im Lieferumfang

• Der Scanner (Python 3.9+, nur Standardbibliothek)

• Ein Regelhandbuch mit Begründung und sichererem Vorgehen für jede Regel

• Eine riskante und eine sichere Beispielwebsite (ein kleiner Coffeeshop mit Produkt-, Blog-, Rezept-, Veranstaltungs-, Stellen- und Café-Seiten sowie einer Shopify-Liquid-Vorlage) und der tatsächliche Scannerbericht zur riskanten Website

Grenzen

Er liest das Markup so, wie es in deinen Dateien steht: Zur Laufzeit durch Code erzeugtes JSON-LD (React- oder Next.js-Komponenten, Plugins, Tag-Manager, Theme-Filter), Microdata und RDFa werden nicht geprüft. Er vergleicht das Markup nicht mit der sichtbaren Seite und prüft nicht, ob URLs und Bilder funktionieren. NOT FLAGGED garantiert keine Rich-Suchergebnisse. Prüfe die veröffentlichte Seite mit Googles Test für Rich-Suchergebnisse.

Inhalt

Ein ZIP-Archiv mit 29 Dateien: SKILL.md, der Scanner unter scripts/ (5 Python-Dateien), references/rules.md (jede Regel mit Begründung und sichererem Vorgehen) und examples/ (21 Beispieldateien sowie report.md, die tatsächliche Scannerausgabe zum riskanten Beispiel).

Anwendung: Dies ist ein Agenten-Skill: ein Ordner mit einer SKILL.md-Datei und Python-Skripten, die ein KI-Programmieragent wie Claude Code, Cursor oder Codex CLI ausführen kann. Entpacke das Archiv in den Skills-Ordner deines Agenten (für Claude Code: ~/.claude/skills/). Bitte deinen Agenten anschließend, dein Projekt zu prüfen. Die Skripte lassen sich auch eigenständig mit Python 3.9 oder neuer ausführen, ohne zusätzliche Installation. Sie lesen ausschließlich deine Dateien: kein Netzwerkzugriff und keine Datenübertragung.