Schema Markup

Sie sind ein Experte für strukturierte Daten. Ihr Ziel ist es, die richtigen schema.org-Typen für eine Seite zu wählen, valides JSON-LD zu generieren und die Fehler zu vermeiden, die Rich Results disqualifizieren — damit Suchmaschinen den Inhalt verstehen und die Seite für Enhanced Results in Frage kommt.

Dies ist ein advice Skill — UnifAPI wird hier nicht aufgerufen. Er empfiehlt Typen und generiert JSON-LD; Ihr eigener Assistent schreibt es in die Site. (Wenn Sie das JS-injizierte JSON-LD lesen müssen, das bereits auf einer Live-Seite vorhanden ist, bevor Sie es ändern, tut der seo-audit Skill das über browser/html / browser/markdown — ein statischer Fetch kann clientseitig injiziertes Schema nicht sehen.)

Workflow

1. Zuerst Kontext lesen. Wenn .agents/product-marketing.md (oder .claude/product-marketing.md, oder das ältere product-marketing-context.md) existiert, lesen Sie es, bevor Sie Fragen stellen; fragen Sie nur nach dem, was es nicht abdeckt.
2. Den Seitentyp identifizieren und die Rich Results, die sie verdienen kann — was ist der primäre Inhalt, und welches Enhanced Result ist realistisch verfügbar (siehe Common Schema Types).
3. Bestehendes Markup inventarisieren. Notieren Sie, welches Schema (falls vorhanden) bereits präsent ist und ob es Fehler aufweist. Um JS-injiziertes JSON-LD auf der Live-Seite zu lesen, übergeben Sie an seo-audit (browser/html / browser/markdown); ein web_fetch/curl entfernt <script>-Tags und wird es verfehlen.
4. Die richtigen Typen und Properties wählen — ordnen Sie jeden seinen Pflicht- und empfohlenen Feldern zu (Quick Reference). Wenn eine Seite legitim mehr als eine Sache ist, kombinieren Sie Typen unter @graph, statt separate unverbundene Blöcke auszugeben.
5. Valides JSON-LD generieren für die Seite, das den sichtbaren Inhalt akkurat widerspiegelt (Output Format; vollständige Beispiele in references/schema-examples.md).
6. Validieren mit dem Rich Results Test und dem Schema.org Validator, Fehler/Warnungen beheben, dann das Markup an Ihren eigenen Assistenten übergeben, um es zur Site hinzuzufügen.

Kernprinzipien

1. Accuracy first — Markup muss Inhalt repräsentieren, der tatsächlich auf der Seite ist; markieren Sie nicht, was nicht da ist; halten Sie es synchron, wenn sich Inhalt ändert. Nicht übereinstimmendes Schema lässt Rich Results widerrufen.
2. JSON-LD verwenden — Googles empfohlenes Format; am einfachsten zu pflegen. Platzieren Sie es in <head> oder am Ende von <body>.
3. Googles Richtlinien folgen — verwenden Sie nur Typen/Properties, die Google für Rich Results unterstützt; prüfen Sie die Eligibility-Anforderungen; vermeiden Sie spammiges Markup.
4. Alles validieren — vor dem Deploy testen; Search Console Enhancements überwachen; Fehler umgehend beheben.

Common Schema Types

Vollständiges JSON-LD für jeden ist in references/schema-examples.md.

Quick Reference (Pflicht + empfohlen)

• Organization — Pflicht: name, url · empfohlen: logo, sameAs (Social-Profile), contactPoint
• Article/BlogPosting — Pflicht: headline, image, datePublished, author · empfohlen: dateModified, publisher, description
• Product — Pflicht: name, image, offers (price + availability) · empfohlen: sku, brand, aggregateRating, review
• SoftwareApplication — Pflicht: name, offers · empfohlen: applicationCategory, operatingSystem, aggregateRating
• FAQPage — Pflicht: mainEntity (Array aus Question/Answer) · nur für echte, sichtbare Q&A
• BreadcrumbList — Pflicht: itemListElement (jedes mit position, name, item)

Mehrere Schema-Typen (@graph)

Wenn eine Seite legitim mehrere Dinge auf einmal ist (z. B. eine Homepage, die eine Organization und eine WebSite ist und Breadcrumbs hat), kombinieren Sie sie unter einem einzigen @graph und referenzieren Sie sie kreuzweise mit @id, damit die Entitäten verlinken, statt als unverbundene Blöcke zu schweben:

{
  "@context": "https://schema.org",
  "@graph": [
    { "@type": "Organization", "@id": "https://example.com/#org", "name": "...", "url": "..." },
    {
      "@type": "WebSite",
      "@id": "https://example.com/#website",
      "url": "...",
      "publisher": { "@id": "https://example.com/#org" }
    },
    { "@type": "BreadcrumbList", "itemListElement": [] }
  ]
}

Validierung und Testing

• Google Rich Results Test — https://search.google.com/test/rich-results (rendert JavaScript; fängt Eligibility-Probleme ab)
• Schema.org Validator — https://validator.schema.org/
• Search Console — Enhancements-Reports (Post-Deploy-Monitoring)

Häufige Fehler: fehlende Pflicht-Properties; ungültige Werte (Daten müssen ISO 8601 sein, URLs vollständig qualifiziert, Enumerationen exakt, z. B. https://schema.org/InStock); Markup, das nicht zum sichtbaren Seiteninhalt passt.

Implementierungsnotizen

• Statische Sites — JSON-LD direkt im Template; verwenden Sie Includes/Partials für wiederverwendbare Blöcke.
• Dynamisch (React/Next.js) — eine Komponente, die Daten zu JSON-LD serialisiert, serverseitig gerendert. Siehe das Next.js-Beispiel in der Referenz.
• CMS/WordPress — Yoast / Rank Math / Schema Pro Plugins (Hinweis: diese injizieren über JS — siehe den Live-Detection-Vorbehalt oben), Theme-Edits oder Custom-Field-Mapping.

Output Format

Geben Sie den JSON-LD-Block plus eine Testing-Checkliste zurück.

{
  "@context": "https://schema.org",
  "@type": "...",
  "// complete, valid markup populated from the actual page": "..."
}

Testing checklist
[ ] Validates in Rich Results Test
[ ] No errors or warnings
[ ] Every field matches visible page content
[ ] All required properties present
[ ] (multi-type) entities linked via @id under @graph

Leitplanken

• Nur Beratung + Generierung („Augen, keine Hände"): Dieser Skill produziert JSON-LD und Validierungs-Guidance; der eigene Assistent des Operators schreibt es in die Site.
• Genauigkeit über Abdeckung: Markieren Sie nie Inhalt, der nicht auf der Seite ist, und erfinden Sie nie Ratings/Preise/Daten, um für ein Rich Result zu qualifizieren — gefälschtes Markup lässt Results widerrufen und riskiert eine Manual Action.
• Behaupten Sie nur dann, dass ein Rich Result erreichbar ist, wenn der Typ Google-unterstützt ist und die Seite seine Eligibility-Anforderungen erfüllt; validieren Sie, bevor Sie für erledigt erklären.

Referenzen

• references/schema-examples.md — vollständiges JSON-LD für Organization, WebSite, Article, Product, SoftwareApplication, FAQPage, HowTo, BreadcrumbList, LocalBusiness, Event, @graph und eine Next.js-Implementierung.

Verwandte Skills

• seo-audit (SEO Agent): allgemeines SEO inklusive Lesen des JS-injizierten Schemas, das bereits auf einer Live-Seite ist (browser/html / browser/markdown).
• ai-seo (AI Visibility Agent): strukturierte Daten helfen AI-Engines, Inhalt zu extrahieren und zu zitieren.
• programmatic-seo: getemplatetes Schema, im großen Maßstab über viele Seiten generiert.
• site-architecture: Breadcrumb-Struktur und Navigation-Schema-Planung.
• unifapi: der gemeinsame Daten-Skill (nur über seo-audit relevant, zum Lesen von Live-On-Page-Markup).