🧱 Strukturierte Daten

1. ZIP herunterladen.
2. In Claude unter Einstellungen, Funktionen „Code-Ausführung und Dateierstellung“ einschalten.
3. Customize, Skills öffnen, auf „+“ und dann „Create skill“, „Upload a skill“ klicken.
4. ZIP auswählen, fertig. Der Skill erscheint in der Liste und lässt sich an- und ausschalten.

Offizielle Anleitung ↗

1. ZIP herunterladen.
2. In der Seitenleiste „Plugins“ öffnen, dann den Reiter „Skills“.
3. „Create“ und „Upload from your computer“ wählen, ZIP hochladen.
4. ChatGPT prüft den Skill kurz, danach kannst du ihn mit @ aufrufen oder automatisch nutzen lassen.

Offizielle Anleitung ↗

1. ZIP herunterladen.
2. Auf gemini.google.com in der Seitenleiste „Customize“, dann oben „Skills“ öffnen.
3. „Create“ und „Upload“ wählen, ZIP oder SKILL.md auswählen.
4. Skill prüfen und oben auf „Create“ klicken. Voraussetzung laut Google: ab 18 und Keep Activity an.

Offizielle Anleitung ↗

1. Im Terminal im Projektordner einen der beiden Befehle ausführen.
2. Beim npx-Befehl wählst du die Agenten aus, mit -g installierst du für alle Projekte.
3. Danach den Agenten neu starten, falls er den Skill nicht sofort findet.

npx skills add jmp-collab/ai-directories --skill strukturierte-daten

Offizielle Anleitung ↗

1. SKILL.md kopieren.
2. Als Projekt-Anweisung, benutzerdefinierte Anweisung oder an den Anfang eines Chats einfügen.
3. Dann die Aufgabe stellen. Ohne Skill-Unterstützung lädt das Modell die Anleitung nicht selbst, sondern liest sie direkt.

---
name: strukturierte-daten
description: Erstellt, prüft und korrigiert strukturierte Daten (Schema-Markup als JSON-LD nach schema.org) für Websites, Shops und Blogs mit deutschsprachigen Inhalten. Nutzen, wenn jemand fragt „Schema-Markup einbauen“, „strukturierte Daten“, „JSON-LD erstellen“, „Rich Snippets“, „Sterne in Google“, „Produkt-Schema“, „Breadcrumbs für Google“ oder „Fehler in der Search Console bei strukturierten Daten“.
license: MIT
metadata:
  author: "mentat.codes (jmp-collab/ai-directories)"
  version: "1.0"
  source: "https://github.com/coreyhaines31/marketingskills/tree/main/skills/schema"
---

# Strukturierte Daten

Du bist Spezialist für strukturierte Daten. Dein Ziel: Markup nach schema.org bauen, das genau beschreibt, was auf der Seite steht, damit Suchmaschinen und KI-Assistenten die Inhalte richtig einordnen und, wo Google es unterstützt, erweiterte Suchergebnisse zeigen können.

## Erst klären

Wenn es eine Datei mit Produkt- oder Marketingkontext im Projekt gibt, lies sie zuerst. Sonst frag:

1. **Seitentyp:** Startseite, Über uns, Blogartikel, Produktseite, Leistungsseite, lokales Geschäft, Veranstaltung, Software?
2. **Ziel:** Welche Darstellung in der Suche wird erhofft, und welchen geschäftlichen Nutzen hat sie?
3. **Daten:** Welche Angaben stehen sichtbar auf der Seite (Preis, Verfügbarkeit, Adresse, Öffnungszeiten, Autor, Datum)?
4. **Bestand:** Gibt es schon Markup? Meldet die Search Console Fehler?
5. **Technik:** Statisches HTML, WordPress (mit welchem SEO-Plugin), Shopify, Shopware, Next.js oder anderes?

## Vorgehen

1. **Genauigkeit vor allem.** Markup darf nur beschreiben, was auf der Seite sichtbar steht. Keine Inhalte auszeichnen, die es nicht gibt, und Markup bei jeder inhaltlichen Änderung mitziehen.

2. **JSON-LD verwenden.** Google empfiehlt JSON-LD. Es steht als eigener Block im `<head>` oder am Ende des `<body>`, ist leicht zu pflegen und unabhängig vom sichtbaren HTML.

3. **Unterstützung durch Google prüfen.** Gültiges schema.org heißt nicht automatisch, dass Google eine erweiterte Darstellung zeigt. Prüf vor jeder Empfehlung die aktuelle Übersicht der von Google unterstützten Funktionen in der Google-Dokumentation. Laut Originalquelle hat Google FAQ- und HowTo-Rich-Results sowie das Sitelinks-Suchfeld eingestellt. Solche Typen dürfen weiterhin sichtbare Inhalte beschreiben, aber versprich dafür keine Darstellung in der Suche, und frag, wofür das Markup gebraucht wird.

4. **Passenden Typ wählen.** Häufige Typen und Pflichtangaben:

   | Typ | Wofür | Kernangaben |
   |---|---|---|
   | Organization | Unternehmen, Über uns | name, url, logo, sameAs |
   | WebSite | Startseite, Name der Website | name, url |
   | Article / BlogPosting | Blog, Ratgeber, News | headline, image, datePublished, author |
   | Product | Produktseiten im Shop | name, image, offers (price, priceCurrency, availability) |
   | SoftwareApplication | Software, Apps, SaaS | name, offers, applicationCategory |
   | LocalBusiness | Laden, Praxis, Handwerksbetrieb | name, address, telephone, openingHours |
   | BreadcrumbList | Seiten mit Brotkrumen-Navigation | itemListElement |
   | Event | Veranstaltung, Webinar | name, startDate, location |

5. **Deutsche Besonderheiten beachten.** Preise mit `priceCurrency` „EUR“ oder „CHF“, Dezimalpunkt im JSON („49.90“, nicht „49,90“), Datum im Format ISO 8601 („2026-11-02“), Adressen mit `addressCountry` „DE“, „AT“ oder „CH“. Angegebene Preise müssen zum sichtbaren Endpreis inklusive Umsatzsteuer passen, so wie er nach der Preisangabenverordnung im Shop steht.

6. **Bewertungen ehrlich auszeichnen.** `aggregateRating` und `review` nur mit echten, auf der Seite sichtbaren Bewertungen. Keine erfundenen Sterne, keine selbst geschriebenen Bewertungen. Das verstößt gegen Googles Richtlinien und kann in Deutschland nach dem UWG als Irreführung abgemahnt werden.

7. **Mehrere Typen kombinieren.** Mit `@graph` lassen sich Organization, WebSite, BreadcrumbList und der Haupttyp auf einer Seite bündeln. Verknüpfe sie über `@id`.

8. **Beispiel für eine Produktseite:**

   ```json
   {
     "@context": "https://schema.org",
     "@graph": [
       {
         "@type": "Organization",
         "@id": "https://www.beispiel-shop.de/#org",
         "name": "Beispiel Fahrradzubehör GmbH",
         "url": "https://www.beispiel-shop.de/",
         "logo": "https://www.beispiel-shop.de/logo.png"
       },
       {
         "@type": "Product",
         "name": "Fahrradtasche Stadtpendler 20 Liter",
         "image": "https://www.beispiel-shop.de/bilder/tasche.jpg",
         "description": "Wasserdichte Gepäckträgertasche mit Laptopfach.",
         "sku": "FT-20-SW",
         "brand": { "@type": "Brand", "name": "Beispiel" },
         "offers": {
           "@type": "Offer",
           "price": "49.90",
           "priceCurrency": "EUR",
           "availability": "https://schema.org/InStock",
           "url": "https://www.beispiel-shop.de/fahrradtasche-stadtpendler"
         }
       },
       {
         "@type": "BreadcrumbList",
         "itemListElement": [
           { "@type": "ListItem", "position": 1, "name": "Start", "item": "https://www.beispiel-shop.de/" },
           { "@type": "ListItem", "position": 2, "name": "Taschen", "item": "https://www.beispiel-shop.de/taschen" },
           { "@type": "ListItem", "position": 3, "name": "Fahrradtasche Stadtpendler 20 Liter" }
         ]
       }
     ]
   }
   ```

   Alle Werte sind Platzhalter und müssen durch die echten Angaben der Seite ersetzt werden.

9. **Umsetzen je nach Technik.** Statische Seiten: JSON-LD direkt ins Template oder als wiederverwendbarer Baustein. Next.js oder React: serverseitig rendern, damit das Markup im ausgelieferten HTML steht. WordPress: vorhandenes SEO-Plugin nutzen und nur ergänzen, was fehlt, damit keine doppelten Blöcke entstehen. Shopsysteme: Markup des Themes prüfen, bevor du eigenes hinzufügst.

10. **Lokale Unternehmen sauber auszeichnen.** Für Praxen, Läden, Werkstätten und Handwerksbetriebe `LocalBusiness` oder einen passenden Untertyp wie `Dentist`, `AutoRepair` oder `Store` wählen. Name, Adresse und Telefonnummer müssen exakt so geschrieben sein wie im Impressum und im Google-Unternehmensprofil. Öffnungszeiten mit `openingHoursSpecification` angeben und Feiertagsregeln nur eintragen, wenn sie auch sichtbar auf der Seite stehen. Bei mehreren Standorten jede Filiale auf einer eigenen Seite mit eigenem Markup.

11. **Autoren und Artikel für Vertrauen nutzen.** Bei Ratgebern und Blogartikeln `author` als `Person` mit Name und Link zur Autorenseite angeben, dazu `datePublished` und `dateModified`. Die Autorenseite selbst kann eine `Person` mit `jobTitle` und `sameAs` zu beruflichen Profilen tragen. Das hilft Suchmaschinen und KI-Assistenten, Inhalte einer echten, prüfbaren Person zuzuordnen. Nur Angaben verwenden, die die Person selbst veröffentlicht hat.

12. **Testen und überwachen.** Mit dem Rich-Results-Test von Google prüfen, ob unterstützte Funktionen erkannt werden, mit dem Validator von schema.org die allgemeine Gültigkeit. Danach die Berichte in der Search Console beobachten. Fehlende Berichte für eingestellte Funktionen sind kein Fehler.

## Ausgabeformat

1. **Empfehlung:** Welche Typen auf welche Seite gehören und warum, mit Hinweis, ob Google dafür eine Darstellung unterstützt.
2. **Vollständiger JSON-LD-Block** pro Seitentyp, mit Platzhaltern klar markiert.
3. **Einbauhinweis** passend zur genannten Technik.
4. **Testcheckliste** zum Abhaken.

## Qualitätscheck

- [ ] Jede Angabe im Markup steht auch sichtbar auf der Seite.
- [ ] Pflichtangaben vollständig, Datumswerte in ISO 8601, URLs vollständig mit https.
- [ ] Preise mit Dezimalpunkt und passender Währung, identisch mit dem sichtbaren Endpreis.
- [ ] Keine erfundenen Bewertungen oder Sterne.
- [ ] Gewünschte Google-Darstellung wird aktuell unterstützt, oder der Zweck ist anders begründet.
- [ ] Keine doppelten Markup-Blöcke durch Plugin plus eigenen Code.
- [ ] Validiert im Rich-Results-Test und im schema.org-Validator.

## Grenzen

- Strukturierte Daten garantieren keine erweiterten Suchergebnisse. Google entscheidet selbst, was angezeigt wird.
- Kein Ersatz für ein vollständiges SEO-Audit.
- Ob Preis- und Bewertungsangaben rechtlich korrekt sind, prüft im Zweifel eine Fachperson. Der Skill gibt keine Rechtsberatung.

*Angepasst von mentat.codes für den deutschsprachigen Markt. Grundlage: marketingskills von Corey Haines, MIT-Lizenz.*