Wie ergänze ich Schema-Markup (JSON-LD) mit Claude Code oder Codex?
Lassen Sie den Agenten JSON-LD in Ihren Seitenvorlagen aus denselben Daten erzeugen, die jede Seite anzeigt, mit nur den Typen und Werten, die ein Leser sehen kann, serverseitig gerendert. Schreiben Sie diese Regel in CLAUDE.md oder AGENTS.md, damit jede neue Seite sie bekommt. Testen Sie danach die veröffentlichte URL, nicht den Code, im Rich Results Test von Google.
Fakten
- Google empfiehlt JSON-LD unter seinen 3 unterstützten Formaten für strukturierte Daten, sofern der Aufbau Ihrer Website es erlaubt. (Google Search Central: Einführung in strukturierte Daten)
- Die Richtlinien von Google sagen, keine Inhalte auszuzeichnen, die Leser nicht sehen; Einträge ohne Pflichtangaben sind für Rich-Suchergebnisse nicht berechtigt. (Google Search Central: Allgemeine Richtlinien für strukturierte Daten)
- Google sagt, für das Erscheinen in den Übersichten mit KI oder im KI-Modus ist kein besonderes schema.org-Markup nötig, und strukturierte Daten sollten zum sichtbaren Text passen. (Google Search Central: AI features and your website)
- Organization-Markup gehört auf die Startseite oder eine Über-uns-Seite, hat keine Pflichtangaben, und das Logo muss mindestens 112 × 112 Pixel groß sein. (Google Search Central: Strukturierte Daten für Organization)
- Claude Code lädt die CLAUDE.md des Projekts in jeder Sitzung, neben dem automatischen Speicher (auto memory) mit bis zu 200 Zeilen oder 25 KB. (Claude-Code-Dokumentation: So merkt sich Claude Ihr Projekt)
- Codex liest AGENTS.md, bevor es irgendeine Arbeit beginnt, und begrenzt die kombinierten Anweisungen standardmäßig auf 32 KiB. (OpenAI-Codex-Dokumentation: Eigene Anweisungen mit AGENTS.md)
Welche Schema-Typen soll ich den Agenten ergänzen lassen?
Verlangen Sie den Typ, der zu dem passt, was jede Seite zeigt, und nichts weiter:
| Seite | Schema-Typ | Wichtige Eigenschaften |
|---|---|---|
| Startseite oder Über-uns-Seite | Organization (oder LocalBusiness) | name, url, logo, sameAs |
| Leitfaden oder Blogbeitrag | Article | headline, author, datePublished, dateModified, publisher |
| Produktseite | Product | name, offers mit dem Preis, den die Seite zeigt |
| Seite mit sichtbaren Fragen und Antworten | FAQPage | Nur die Fragen, die auf der Seite stehen |
Welchen Prompt soll ich Claude Code oder Codex geben?
Geben Sie ihm eine Regelmenge, die er auf jede Vorlage anwenden kann, mit einem Verbot erfundener Werte. Der Prompt bleibt auf Englisch, weil ihn der Agent liest:
Add JSON-LD structured data to this site. - Build it in the page templates from the same data the page renders. Never hardcode a value the page does not show. - Organization (name, url, logo, sameAs) on the home page only. - Article on guides and blog posts: headline, author, datePublished, dateModified (the real last change), publisher = the Organization. - Product, LocalBusiness or FAQPage only where that content is visible. - If a value is unknown, leave the property out. Do not invent it. - Render it on the server, in a <script type="application/ld+json">. - List every page you changed and the types each one now carries.
Wohin schreibe ich die Regel, damit auch neue Seiten Schema bekommen?
In die Anweisungsdatei, die der Agent von selbst lädt. Claude Code liest ./CLAUDE.md oder ./.claude/CLAUDE.md zu Beginn jeder Sitzung, und /init erstellt eine erste Fassung. Codex liest AGENTS.md aus dem Projektstamm, bevor es irgendeine Arbeit beginnt. Eine kurze Regel dort sorgt dafür, dass die nächste Seite des Agenten zur letzten passt.
Wie prüfe ich, dass der Agent nichts erfunden hat?
Testen Sie die veröffentlichte URL im Rich Results Test und vergleichen Sie dann jeden Wert mit der Seite, die ein Leser sieht. Ein URL-Test führt das JavaScript der Seite aus, eingefügter Code nicht. Prüfen Sie danach mit der URL-Prüfung in der Search Console, ob Google das Markup gefunden hat. Ein gültiger Test beweist nur die Syntax; die Werte müssen Sie selbst prüfen.
Bringt Schema-Markup ChatGPT oder die KI von Google dazu, meine Website zu zitieren?
Nicht von selbst. Google sagt, die Übersichten mit KI und der KI-Modus brauchen kein besonderes Schema, und für gültiges Markup garantiert Google keine Rich-Suchergebnisse. Korrektes JSON-LD hilft Suchmaschinen zu lesen, wer Sie sind und worum es auf der Seite geht. Zitiert wird weiterhin die Antwort auf der Seite.
Schritt für Schritt
- Seitentypen auflisten. Startseite, Über uns, Leitfäden, Produkte: je ein Schema-Typ.
- Dem Agenten den Prompt geben. Lassen Sie ihn JSON-LD in den Vorlagen aus den eigenen Daten der Seite erzeugen, ohne erfundene Werte.
- Die Regel speichern. Ergänzen Sie sie in CLAUDE.md oder AGENTS.md, damit künftige Seiten ihr folgen.
- Diff prüfen und veröffentlichen. Prüfen Sie, dass die Werte aus den Seitendaten stammen und nicht fest im Text stehen.
- Die Live-URL testen. Führen Sie den Rich Results Test auf der veröffentlichten Seite aus, danach die URL-Prüfung in der Search Console.
Häufige Fehler
- Den Agenten Bewertungen, Preise oder Autoren eintragen lassen, die die Seite nicht zeigt.
- FAQPage-Markup für Fragen ergänzen, die nicht auf der Seite stehen.
- Eingefügten Code statt der Live-URL testen. Dabei bleibt verborgen, was erst JavaScript rendert.
- dateModified bei jedem Build setzen statt dann, wenn sich der Inhalt geändert hat.
So löst easyIndex das
easyIndex ändert Ihre Website nie: Ihr Coding-Agent schreibt die Seiten und das Schema, und easyIndex prüft jede Seite beim Einreichen und kontrolliert sie nach der Veröffentlichung erneut auf der Live-Website, auch ob sie JSON-LD und ein echtes Aktualisierungsdatum trägt. Ein Schritt gilt nur auf dieser Grundlage als erledigt, nicht auf dem Bericht des Agenten.
Häufig gestellte Fragen
JSON-LD, Microdata oder RDFa?
JSON-LD. Google unterstützt alle drei und empfiehlt JSON-LD, wenn Ihr Aufbau es erlaubt.
Kann der Agent JSON-LD mit JavaScript einfügen?
Google verarbeitet JSON-LD, das nach dem Rendern vorhanden ist. Serverseitig gerendertes Markup ist aber sicherer für Crawler, die kein JavaScript ausführen.
Soll Organization auf jeder Seite stehen?
Google sieht es auf der Startseite oder einer Über-uns-Seite vor. Andere Seiten können darauf als publisher verweisen.
Funktioniert Cursor oder ein anderer Agent genauso?
Ja. Jeder Agent, der Ihre Vorlagen bearbeitet, kann demselben Prompt folgen; nur der Name der Anweisungsdatei ändert sich.
Weiterlesen
- Helfen strukturierte Daten (Schema), damit KI meine Website zitiert?
- Welche SEO-Regeln gehören in AGENTS.md oder CLAUDE.md?
- Wie führe ich ein technisches SEO- und KI-Sichtbarkeits-Audit mit Claude Code durch?
- Können ChatGPT und Claude meine JavaScript-Website sehen?
- Wie mache ich GEO mit Claude Code oder Codex?
- Wie funktioniert easyIndex, was brauche ich, und wie lange dauert es bis zu Ergebnissen?
Zuletzt geprüft am .