Welche SEO-Regeln gehören in AGENTS.md oder CLAUDE.md?

Legen Sie für jede neue Seite eine kurze Liste prüfbarer Regeln fest: eine Frage und eine H1, ein eindeutiger Titel und eine eindeutige Beschreibung, eine kanonische URL, hreflang, Text, der auf dem Server gerendert wird, JSON-LD, das zum sichtbaren Text passt, ein Eintrag in der Sitemap, belegte Fakten, und bestehende funktionierende Seiten bleiben unangetastet. Regeln leiten den Agenten an, sie beweisen aber nicht, dass die Live-Seite stimmt.

Fakten

AGENTS.md wird von über 60.000 Open-Source-Projekten genutzt und von der Agentic AI Foundation unter der Linux Foundation betreut, Stand 13.10.2026. (AGENTS.md)
Claude Code ab Version 2.1.277 liest AGENTS.md, wenn das Projekt keine CLAUDE.md hat. Eine CLAUDE.md kann sie mit der Zeile @AGENTS.md einbinden. (Claude Code Doku: So merkt sich Claude Ihr Projekt)
Anthropic rät, jede CLAUDE.md unter 200 Zeilen zu halten, und sagt, dass Claude sie als Kontext behandelt, nicht als erzwungene Konfiguration. (Claude Code Doku: So merkt sich Claude Ihr Projekt)
Codex fasst AGENTS.md-Dateien aus ~/.codex und vom Projektstamm abwärts zusammen, bis standardmäßig 32 KiB. (OpenAI Codex Doku: AGENTS.md)
Google sagt, dass strukturierte Daten die Seite wahrheitsgemäß abbilden müssen und keine Inhalte auszeichnen dürfen, die Leser nicht sehen können. (Google Search Central: Allgemeine Richtlinien für strukturierte Daten)

Welche Datei soll die Regeln enthalten, AGENTS.md oder CLAUDE.md?

Nutzen Sie AGENTS.md, wenn mehr als ein Coding-Agent im Repository arbeitet, denn Codex und Cursor lesen sie, und Claude Code liest oder importiert sie. Behalten Sie CLAUDE.md für Notizen, die nur Claude betreffen, mit einer Importzeile, damit Claude auch die gemeinsamen Regeln bekommt:

# CLAUDE.md
@AGENTS.md

Welche Regeln sollte ich übernehmen?

Diese Regeln sind kurz, konkret und prüfbar, so wie es die eigene Doku der Agenten empfiehlt. Fügen Sie sie als Abschnitt in die Datei ein:

## SEO rules for new pages

- Only add new content pages. Never change the home page or a page that already works.
- One question per page. The H1 is that question; the first paragraph answers it.
- Unique <title> (up to 60 characters) and meta description (70 to 165).
- Self-referencing rel="canonical" on every page.
- Each language version links the others with hreflang; canonical stays in its own language.
- The text is in the server-rendered HTML, not loaded only by JavaScript.
- JSON-LD describes only what the page visibly says.
- Every number or date in a fact links to the source that states it. Invent nothing.
- Add the page to the sitemap and link to it from a related page.
- A page is done when it is checked on the live URL, not when the build passes.

Warum jede dieser Regeln?

Jede Regel beantwortet eine bekannte Art, wie Seiten scheitern:

Regel	Warum
Kanonische URL auf jeder Seite	Google wertet rel=canonical als starkes Signal, eine Sitemap nur als schwaches
hreflang zwischen den Sprachen	Google nutzt hreflang-Alternativen für Sprachversionen, mit einer kanonischen URL in der jeweiligen Sprache
Text auf dem Server gerendert	Crawler, die kein JavaScript ausführen, sähen sonst eine leere Seite
JSON-LD passt zum sichtbaren Text	Die Richtlinien von Google für strukturierte Daten verbieten, verborgene Inhalte auszuzeichnen
Funktionierende Seiten nie anfassen	Eine Umschreibung kann Besucher kosten, die eine Seite bereits bringt

Was können Regeln nicht garantieren?

Regeln können das veröffentlichte Ergebnis nicht garantieren: Die eigene Doku von Claude Code sagt, dass die Datei Kontext ist, keine erzwungene Konfiguration. Ein fehlgeschlagenes Deployment, eine falsche kanonische URL oder ein leeres Rendering zeigt sich nur auf der Live-URL. Prüfen Sie deshalb jede Seite dort und beobachten Sie die Indexierung in der Search Console.

Schritt für Schritt

Die Datei wählen. Nutzen Sie AGENTS.md im Wurzelverzeichnis des Repositorys und ergänzen Sie @AGENTS.md in CLAUDE.md, falls Sie eine führen.
Die Regeln einfügen. Kopieren Sie den Regelblock und passen Sie Pfade und Sprachen an Ihre Website an.
Kurz halten. Bleiben Sie deutlich unter 200 Zeilen; verschieben Sie Regeln für einen einzelnen Ordner in eine verschachtelte Datei.
Live prüfen. Öffnen Sie nach jedem Deployment die neuen URLs und bestätigen Sie Titel, kanonische URL, Inhalt und JSON-LD.

Häufige Fehler

Vage Regeln wie „SEO-Best-Practices befolgen“ schreiben, die der Agent nicht prüfen kann.
CLAUDE.md und AGENTS.md nebeneinander führen, ohne Import, sodass Claude Code die gemeinsamen Regeln nie liest.
Ein langes SEO-Handbuch einfügen, das die wichtigen Regeln verschüttet.
Die Regeldatei als Beweis betrachten, dass die veröffentlichten Seiten stimmen.

So löst easyIndex das

easyIndex gibt Ihrem Coding-Agenten die Seitenregeln Schritt für Schritt über MCP, prüft jede Seite bei der Einreichung und kontrolliert sie nach der Veröffentlichung auf der Live-Website. Ein Schritt gilt nur als erledigt, wenn easyIndex den Nachweis prüft, nicht auf Grundlage des Berichts des Agenten.

easyIndex ändert nie Ihre Website oder Ihr Repository. Es funktioniert mit Claude Code, Codex, Cursor oder jedem MCP-Client, für 30 US$ pro Website und Monat nach einer kostenlosen Testphase von 7 Tagen.

Häufig gestellte Fragen

Liest Claude Code AGENTS.md?

Ja, ab Version 2.1.277, wenn es keine CLAUDE.md gibt. Mit einer CLAUDE.md fügen Sie die Zeile @AGENTS.md ein, um sie einzubinden.

Bringen diese Regeln meiner Website eine Zitierung in ChatGPT?

Keine Regel kann das versprechen. Sie machen Seiten klar und crawlbar. Ob ChatGPT sie zitiert, entscheidet ChatGPT.

Soll ich llms.txt in die Regeln aufnehmen?

Das ist optional. Wichtiger sind zuerst serverseitig gerenderte Seiten, kanonische URLs und eine Sitemap.

Kann ein Unterordner eigene Regeln haben?

Ja. Agenten lesen die nächste AGENTS.md im Verzeichnisbaum, deshalb kann eine verschachtelte Datei die Regeln für diesen Ordner enthalten.

Weiterlesen

Zuletzt geprüft am 13. Oktober 2026.