aelena/seo-geo-audit

Was macht seo-geo-audit?

Prüft ein Frontend-Repository auf klassische SEO (die Dinge, die der Google-Crawler beachtet) und GEO – Generative Engine Optimization, die Dinge, die LLMs interessieren, wenn sie deine Inhalte lesen. Gibt einen Markdown-Bewertungsbogen mit Schweregraden, Datei:Zeile-Verweisen und konkreten Lösungsvorschlägen aus.

Der neue Mehrwert liegt bei GEO. Klassische SEO-Scanner gibt es seit Jahren. Aber die Frage „Ist deine Website für ein Sprachmodell leicht zu extrahieren, zu zitieren und zu durchdringen?“ kann nur Claude wirklich beantworten – denn Claude ist der Konsument.

Aufruf

Auslöser	Verhalten
/audit oder /seo-geo oder /seo-geo-audit	Standard-Prüfung: SEO + GEO, Stammebene + wichtige Routen, max. ~30 Dateien
/audit deep	Durchläuft alle im Repository auffindbaren Routen/Seiten. Langsamer, gründlicher
/audit seo	Nur klassische SEO
/audit geo	Nur GEO
/audit fix	Prüfung, danach konkrete Datei-Änderungen für jeden schwerwiegenden Befund vorschlagen (vor jeder Änderung nachfragen)
/audit report.md	Schreibt den Bericht in eine Datei statt inline anzuzeigen
Natürliche Sprache: „Prüfe diese Website auf SEO“, „Ist das LLM-freundlich?“, „Überprüfe meine strukturierten Daten“	Gleichbedeutend

Stoppen / Deaktivieren

Nicht sitzungsbasiert. Einmalig. Einfach nicht aufrufen.

Ausführungsablauf

1. Framework erkennen durch Lesen von package.json. Suche nach next, astro, nuxt, svelte-kit, remix, gatsby, vite, vue oder Fallback auf einfaches HTML. Das Framework bestimmt die Dateiglobs und wo Seiten leben (pages/, app/, src/routes/, src/pages/, content/, usw.).
2. Inhaltsquellen entdecken mittels scripts/discover.sh <framework>.
3. <head>-Inhalt und strukturierte Daten extrahieren mittels scripts/extract-head.sh und scripts/find-jsonld.sh. Bei JSX/TSX nach <Head>, <Helmet>, <Metadata> oder frameworkspezifischen Mustern suchen (Next.js metadata-Exporte, Astro-Frontmatter, Nuxt useHead).
4. Prüfungen durchführen. Jede Prüfung aus checks/seo.md und checks/geo.md ist ein Stück Claude-Reasoning über die extrahierten Daten – kein Regex. Das ist der Punkt: Klassische Scanner können dir sagen, dass das Meta-Tag existiert; nur Claude kann dir sagen, ob die Beschreibung gut ist.
5. Bewertung pro Kategorie mittels checks/scoring.md. Buchstabennote + numerische Punktzahl pro Kategorie.
6. Bericht rendern aus templates/report-card.md, wobei die Befunde mit Datei:Zeile-Verweisen, Schweregraden und Lösungsvorschlägen eingefügt werden.
7. Im fix-Modus: Für jeden schwerwiegenden Befund eine konkrete Bearbeitung vorschlagen, unter Verwendung des Standards „Vorschau-dann-Anwenden“-Musters. Nie ohne Benutzerbestätigung anwenden.

Fähigkeitsübergreifende Hinweise

Wenn die llms-txt-Fähigkeit installiert ist, wird empfohlen, sie auszuführen, falls GEO-Befunde „Fehlende llms.txt“ enthalten. Wenn die a11y-audit-Fähigkeit existiert, wird am Ende jedes Berichts auf sie hingewiesen („Diese Prüfung deckt SEO und GEO ab. Für Barrierefreiheit bitte /a11y-audit ausführen.“).

Sicherheitsvorkehrungen

• Standardmäßig schreibgeschützt. Nur der fix-Modus schlägt Änderungen vor, und jede Änderung erfordert eine Bestätigung.
• Nicht die Live-Seite abrufen. Das Quell-Repository prüfen. Live-Seiten-Prüfungen sind das Gebiet von Lighthouse / PageSpeed – andere Tools, andere Belange.
• Keine Framework-Konventionen voraussetzen. Zuerst package.json prüfen. Ein pages/-Ordner bedeutet in Next, Nuxt, Gatsby und Vanilla unterschiedliche Dinge.
• Policy-Dateien niemals ändern (robots.txt, noai-Meta-Tags, llms.txt) ohne ausdrückliche Aufforderung des Benutzers – das sind Entscheidungen der Stakeholder, keine technischen.
• Generierte/erstellte Artefakte überspringen. Nicht dist/, build/, .next/, out/, .nuxt/ prüfen. Den Quellcode prüfen.
• Tiefenprüfungen begrenzen. Auch im deep-Modus die Prüfung von mehr als ~500 Dateien ohne eine Bestätigung --no-limit ablehnen.

Dateien in dieser Fähigkeit

• SKILL.md – diese Datei
• checks/seo.md – klassische SEO-Checkliste mit Schweregraden
• checks/geo.md – GEO-Checkliste (die neuartigen Prüfungen)
• checks/scoring.md – wie Befunde auf eine 0–100-Bewertung pro Kategorie abgebildet werden
• templates/report-card.md – Markdown-Vorlage für den endgültigen Bericht
• scripts/discover.sh – Frontend-Quelldateien nach Framework finden
• scripts/extract-head.sh – <head>-Inhalt aus HTML/JSX/MDX extrahieren
• scripts/find-jsonld.sh – <script type="application/ld+json">-Blöcke extrahieren
• scripts/check-llms-txt.sh – ob das Repository eine llms.txt hat
• examples/good-site-report.md – Beispielbericht für eine gut optimierte Website
• examples/bad-site-report.md – Beispielbericht für eine typische Neuentwicklung