Dokumentation durchsuchen

SEO-/GEO-Pack: Sichtbarkeit in der Suche und in KI-Antworten prüfen

SEO / GEO: drei Agenten prüfen Sichtbarkeit in der Suche und in KI-generierten Antworten (Inhaltsqualität, strukturierte Daten, KI-Tauglichkeit) mit 15 Befehlen. Installation, Schlüssel, Grenzen.

Auf dieser Seite
  1. Wann du es brauchst
  2. Was installiert wird
  3. Schnellstart
  4. Beispiele zum Kopieren
  5. Was es schreibt und wo
  6. Datenflüsse und Voraussetzungen
  7. Grenzen und Stolpersteine

Das SEO-/GEO-Pack prüft eine Website unter zwei Gesichtspunkten. SEO ist die Sichtbarkeit in Suchmaschinen-Ergebnissen. GEO (Generative Engine Optimisation) ist die Sichtbarkeit in den Antworten, die KI-Assistenten und KI-Übersichten erzeugen: ob deren Crawler die Website lesen dürfen, ob Inhalt und strukturierte Daten gut genug zum Zitieren sind und wie gut die Seiten darauf vorbereitet sind. Das Pack bringt drei Agenten mit einem gemeinsamen Befehl, /seo: Scout durchsucht und inspiziert, Judge bewertet Inhalt, strukturierte Daten und KI-Tauglichkeit, Chief bewertet, plant und berichtet. Es nutzt ein kleines Python-Toolkit, wenn eines verfügbar ist, und fällt sonst auf einen Nur-Prompts-Modus zurück, in dem es keine Zahlen erfindet.

Wann du es brauchst

  • Vor einem Launch oder nach einem Redesign, um Probleme bei Indexierung, Canonical, Weiterleitungen und Sicherheits-Headern zu finden.
  • Wenn der organische Traffic sinkt und du eine priorisierte Ursachenliste und einen 30-, 60- und 90-Tage-Plan brauchst.
  • Um zu prüfen, ob KI-Crawler die Website lesen können, ob sie eine llms.txt hat und wie zitierfähig ihre Passagen sind.
  • Um deine Website mit der eines Wettbewerbers zu vergleichen oder die Punktzahl über die Zeit zu verfolgen.

Was installiert wird

SEO ist ein gepacktes Pack: Es liegt in .agents/skills/pack-seo/ mit dem Router SKILL.md (der Skill heißt seo-engine), den drei Agentendateien seo-scout.md, seo-chief.md und seo-judge.md, einer checklist.md, einem pagespeed-playbook.md, Referenzdateien in ref/, Berichtsvorlagen, requirements.txt und den Python-Skripten in scripts/. Die Registry führt für dieses Pack keine eigenen Skills auf.

Drei Agenten, zehn Rollen
AgentRollenWas er tut
SEO Scout (Technical Scanner)Crawler, Inspector, PhotographerDurchsucht und kartiert die Website, führt neun Kategorien technischer Prüfungen aus, macht Mobil- und Desktop-Screenshots.
SEO Judge (Content & AI Analyst)Content Expert, Schema Master, GEO AnalystBewertet E-E-A-T und Inhaltsqualität, validiert strukturierte Daten, misst die Tauglichkeit für KI-Suche.
SEO Chief (Strategist & Reporter)Scorer, Strategist, Reporter, BenchmarkerBerechnet den SEO-Health-Score, priorisiert Probleme, schreibt Plan und Korrekturen, berichtet, vergleicht, vergleicht mit Wettbewerbern.

Die 15 /seo-Befehle

Befehls-Router
BefehlAgentAktion
/seo full <url>Scout, Judge, ChiefAlle sechs Phasen
/seo quick <url>Scout, Judge, ChiefNur die Phasen 1 bis 4
/seo technical <url>Scout (Inspector)Nur die technischen Prüfungen der Phase 2
/seo content <url>Judge (Content Expert)Nur die Inhaltsprüfungen der Phase 2
/seo geo <url>Judge (GEO Analyst)KI-Such-Tauglichkeit (Phase 3)
/seo schema <url>Judge (Schema Master)Erkennung und Validierung strukturierter Daten
/seo images <url>Judge (Content Expert)Teilmenge: Bilder-Audit
/seo hreflang <url>Scout (Inspector)hreflang-Audit
/seo pagespeed <url>Scout und ChiefPageSpeed-Optimierungsschleife
/seo plan <type>Chief (Strategist)Strategieplan für saas, ecommerce, local, publisher oder agency
/seo fixChief (Strategist)Korrekturen aus dem letzten Audit erzeugen
/seo historyChief (Reporter)Punkteverlauf anzeigen
/seo compareChief (Reporter)Mit dem vorherigen Audit vergleichen
/seo competitor <url1> <url2>Scout, Judge, ChiefZwei Websites vergleichen
/seo api <url>Ein SkriptGoogle-APIs: PageSpeed, CrUX, Test auf Optimierung für Mobilgeräte

Die sechs Phasen eines vollständigen Audits

  1. Erkundung: Startseite abrufen, bis Tiefe 2 und höchstens 25 Seiten crawlen, den Geschäftstyp erkennen (SaaS, E-Commerce, lokal, Publisher, Agentur), nach robots.txt, sitemap.xml und llms.txt suchen. Ein Checkpoint fragt, ob es weitergeht.
  2. Tiefenscan, parallel: Scout prüft neun technische Kategorien (Crawlbarkeit, Indexierbarkeit, Sicherheit, URL-Struktur, Mobil, Core Web Vitals, Erkennung strukturierter Daten, JavaScript-Rendering, IndexNow), während Judge E-E-A-T, Inhaltsqualität, Schema und Bilder prüft.
  3. KI-Tauglichkeit: Zugriff für GPTBot, ClaudeBot und PerplexityBot, llms.txt, Zitierfähigkeit der Passagen (Blöcke von 134 bis 167 Wörtern) und ein KI-Readiness-Score von 0 bis 100.
  4. Bewertung: der SEO-Health-Score von 0 bis 100, nur wenn jede gewichtete Kategorie verifizierte Eingaben hat.
  5. Maßnahmenplan: Probleme als kritisch, hoch, mittel oder niedrig eingestuft, Quick Wins, Roadmap für 30, 60 und 90 Tage, erzeugte Korrekturen (Meta-Tags, JSON-LD, robots.txt, llms.txt). Ein Checkpoint fragt, ob Korrekturen angewendet werden. Danach kann eine PageSpeed-Schleife folgen.
  6. Monitoring, optional: Ergebnisse unter .bmad-seo/history/ speichern und mit dem vorherigen Audit vergleichen.
Gewichte des SEO-Health-Scores
KategorieGewicht
Technisches SEO20 %
Inhalt und E-E-A-T22 %
On-Page-SEO18 %
Schema10 %
Performance (Core Web Vitals)12 %
KI-Tauglichkeit (GEO)12 %
Bilder6 %

Schnellstart

  1. Das Pack installieren

    Core wird automatisch ergänzt. Der Nur-Prompts-Modus braucht nichts weiter.

    Im Terminal deines Projekts
    npx bmad-plus install --packs seo

  2. Optional: das Python-Toolkit bereitstellen

    Mit --provision-python baut der Installer eine isolierte Umgebung in .bmad/venv/seo/ (nötig sind Python 3.11 oder neuer oder uv, das eines holen kann) und prüft, dass requests, bs4, defusedxml und lxml importierbar sind. Das ist optional.

    Im Terminal deines Projekts
    npx bmad-plus install --packs seo --provision-python

  3. Optional: einen Google-API-Schlüssel setzen

    Nur für Live-Daten von PageSpeed und CrUX nötig. Der Schlüssel ist kostenlos und wird aus der Umgebung gelesen; er geht in einem Anfrage-Header, nie in einer URL.

    Im Terminal deines Projekts
    $env:GOOGLE_API_KEY = "dein-schluessel"

  4. Ein erstes Audit starten

    Ersetze die Adresse durch eine Website, die du prüfen darfst.

    Im Terminal deines Projekts
    SEO Scout, starte ein Schnell-Audit für https://example.com (die Route /seo quick, Phasen 1 bis 4).

Beispiele zum Kopieren

Das vollständige Audit in sechs Phasen starten

Nutze es bei einer Website, die dir gehört oder die du im Auftrag prüfen darfst. Scout, Judge und Chief arbeiten nacheinander.

In deinem KI-Assistenten
SEO Scout, starte das vollständige Audit in sechs Phasen für https://example.com (die Route /seo full). Halte an jedem Checkpoint an, damit ich entscheide, ob es weitergeht.

Das solltest du erhalten Phase 1 endet mit einer Erkundungszusammenfassung und der Frage „Continue with full audit?“. Dann folgen Tiefenscan, KI-Tauglichkeit und Bewertung sowie der Maßnahmenplan, der bei „Apply fixes automatically?“ pausiert. Ist Python nicht verfügbar, nennt das Audit gleich den „prompts-only mode“, kennzeichnet fehlende Daten als ungeprüft und lässt jede Punktzahl mit unvollständigen Eingaben weg, auch den gesamten SEO-Health-Score.

Nur technische Inspektion

Nutze es bei Verdacht auf Indexierungs- oder Infrastrukturprobleme, wenn du die Inhaltsprüfung nicht brauchst.

In deinem KI-Assistenten
SEO Scout, starte die technische Route (/seo technical) für https://shop.example. Wir sind letzten Freitag auf eine neue Plattform umgezogen, und Seiten fallen aus Google: Prüfe zuerst robots.txt, noindex-Direktiven und Canonical-Tags.

Das solltest du erhalten Scout arbeitet als Inspector und liefert einen technischen Bericht über neun Kategorien, die Probleme nach kritisch, hoch, mittel und niedrig sortiert. Core Web Vitals werden aus dem Quelltext beurteilt, wenn keine Live-API-Daten vorliegen, und es wird INP statt des eingestellten FID verwendet.

hreflang einer mehrsprachigen Website prüfen

Nutze es für Websites mit mehreren Sprachen oder Regionen, etwa Varianten unter /fr/ und /de/.

In deinem KI-Assistenten
SEO Scout, prüfe die hreflang-Annotationen von https://example.com (die Route /seo hreflang). Die Website hat Versionen unter /fr/ und /de/: Kontrolliere, dass jede Seite auf ihre Übersetzungen zurückverweist und x-default gesetzt ist.

Das solltest du erhalten Scout prüft selbstreferenzierende Tags, Rück-Tags und x-default gegen die hreflang-Regeln des Packs und meldet die Seiten, die sie verletzen.

Strukturierte Daten validieren

Nutze es vor und nach dem Hinzufügen von JSON-LD. Judge arbeitet als Schema Master.

In deinem KI-Assistenten
SEO Judge, validiere die strukturierten Daten von https://example.com/pricing (die Route /seo schema) und sag mir, ob ein Typ veraltet ist oder fehlt.

Das solltest du erhalten Ein Schema-Bericht: was gefunden wurde, in welchem Format, ob jeder Typ gültig und nicht veraltet ist und welche fehlenden Chancen sich lohnen. Judge empfiehlt JSON-LD, markiert eingestellte Typen und kann konforme Snippets erzeugen.

KI-Such-Tauglichkeit messen

Nutze es, um zu entscheiden, was sich ändern muss, damit Assistenten deine Seiten lesen und zitieren können. Judge arbeitet als GEO Analyst.

In deinem KI-Assistenten
SEO Judge, starte die GEO-Route (/seo geo) für https://docs.example. Können GPTBot, ClaudeBot und PerplexityBot unsere Dokumentation lesen, und würde eine llms.txt helfen?

Das solltest du erhalten Ein GEO-Bericht: welche KI-Crawler robots.txt erlaubt oder sperrt, ob llms.txt existiert und korrekt aufgebaut ist, wie viele Passagen in den zitierfähigen Bereich von 134 bis 167 Wörtern fallen und der KI-Readiness-Score, nur gezeigt, wenn seine Eingaben geprüft waren.

PageSpeed-Werte Korrektur für Korrektur verbessern

Braucht GOOGLE_API_KEY für Live-Werte. Ziel ist 100 in allen vier Lighthouse-Kategorien.

In deinem KI-Assistenten
SEO Chief, starte mit SEO Scout die PageSpeed-Schleife (/seo pagespeed) für https://example.com/landing. Mein GOOGLE_API_KEY ist gesetzt. Behebe ein Problem nach dem anderen und teste nach jedem neu.

Das solltest du erhalten Scout und Chief laufen in einer Schleife: messen, ein Problem beheben, neu testen, die Verbesserung bestätigen, zum nächsten übergehen, nach Playbook und Checkliste des Packs. Ohne Schlüssel sagen die Agenten, dass Live-Werte fehlen, statt sie zu schätzen.

Einen Plan für deinen Website-Typ erhalten, dann die Korrekturen

Starte es nach einem Audit. Plantypen sind saas, ecommerce, local, publisher und agency.

In deinem KI-Assistenten
SEO Chief, das Audit unserer Website ist fertig. Schreibe den Strategieplan für eine SaaS-Website (die Route /seo plan saas) und mache aus diesem Audit sofort anwendbare Korrekturen (/seo fix).

Das solltest du erhalten Chief schreibt einen Strategieplan für eine SaaS-Website (Preisseiten, Funktionsvergleich, Testangebote, Dokumentations-SEO). Dann macht /seo fix aus dem letzten Audit sofort anwendbare Änderungen: optimierte Title- und Description-Tags, JSON-LD aus den Pack-Vorlagen, eine verbesserte robots.txt und eine llms.txt.

Mit einem Wettbewerber vergleichen und den Fortschritt verfolgen

Nutze es für einen direkten Vergleich oder nach einem zweiten Audit, um die Veränderungen zu sehen.

In deinem KI-Assistenten
SEO Chief, vergleiche https://example.com mit https://competitor.example (die Route /seo competitor) und sag mir, wo der Wettbewerber vorn liegt. Falls ich frühere Audits gespeichert habe, zeige auch, wie sich unser Score entwickelt hat.

Das solltest du erhalten Chief führt für beide Websites ein vollständiges Audit durch und vergleicht die Werte mit Abständen (SEO-Score, E-E-A-T, Schema-Typen, GEO-Score, PageSpeed), nennt dann die Rückstände, deine Vorteile und die Prioritäten. Einen Score-Verlauf gibt es nur, wenn frühere Audits von der optionalen Monitoring-Phase (Phase 6 eines vollständigen Audits) unter .bmad-seo/history/ gespeichert wurden; dann können /seo history und /seo compare die Entwicklung zeigen, und ohne gespeichertes Audit gibt es nichts zu vergleichen.

Was es schreibt und wo

Dateien, die das SEO-Pack anlegen kann
PfadErzeugt vonInhalt
.bmad-seo/history/<domain>-<date>.jsonPhase 6 (Monitoring)Punktzahlen je Kategorie und Problemliste, für Verlauf und Vergleich
seo-report.htmlscripts/seo_report.pyHTML-Bericht aus einer Audit-JSON-Datei, Standarddateiname; nur verwendet, wenn jede Punktzahl geprüft ist
screenshot.pngscripts/seo_screenshot.pyStandard-Ausgabename eines Seiten-Screenshots (--output ändert ihn)
.bmad/venv/seo/install --provision-pythonDie isolierte Python-Umgebung

Datenflüsse und Voraussetzungen

  • Laufzeiten: Node.js 20 für den Installer; Python 3.11 oder neuer nur, wenn du das Toolkit willst (sonst Nur-Prompts-Modus). Python-Pakete: requests, beautifulsoup4, defusedxml, lxml.
  • Datenflüsse außerhalb des Rechners: seo-site-fetch (der Crawl kontaktiert die geprüfte Website; Adressen werden gegen serverseitige Anfragefälschung geprüft und festgelegt), seo-google-apis (PageSpeed, CrUX und der Test auf Optimierung für Mobilgeräte, mit deinem GOOGLE_API_KEY im Header x-goog-api-key), seo-screenshot (der Browser erreicht nur den geprüften Host) und python-provision (Paketinstallation, optional).
  • Das Pack trägt das Compliance-Tag GDPR (DSGVO), weil Daten aus Google Analytics oder Search Console personenbezogene Daten enthalten können; behandle solche Exporte nach deinen eigenen Regeln.

Grenzen und Stolpersteine

Warnung Keine Daten, keine Punktzahl

Im Nur-Prompts-Modus oder wenn eine Kategorie nicht geprüft werden konnte, kennzeichnen die Agenten sie als ungeprüft. Sie setzen nie null ein und gewichten die anderen Kategorien nicht um; ein unvollständiges Audit zeigt daher seine Abdeckung (geprüfte Seiten und Prüfungen, Quellen, ungeprüfte Punkte) statt einer Gesamtzahl.

Hinweis Screenshots brauchen einen Browser, den du selbst installierst

requirements.txt lässt Playwright auskommentiert, und --provision-python prüft nur requests, bs4, defusedxml und lxml. Für seo_screenshot.py installierst du playwright und Chromium selbst in derselben Umgebung. Ressourcen Dritter werden bei einer Aufnahme blockiert und als blocked_requests aufgelistet; ein fehlendes CDN-Bild ist also ein Effekt der Aufnahme, kein Fehler der Website.

Hinweis Frag in normaler Sprache: Die /seo-Namen sind Routen, keine Slash-Befehle

Die Namen /seo ... sind das eigene Router-Vokabular des Packs. Das Pack registriert sie nicht als Slash-Befehle in deinem KI-Client, allein getippt kann also die Meldung „unbekannter Befehl“ kommen. Schreibe eine normale Anfrage an einen SEO-Agenten und nenne die Route im Satz, wie es die Beispiele oben tun. Für ein Audit bitte um die Route full (alle sechs Phasen) oder die Route quick (Phasen 1 bis 4); der Router hat keine einzelne Route audit.

Hinweis Herkunft

Die Basis SEO Audit 360 wurde von Laurent Rochetta bei Oveanet, seiner Firma, geschrieben und in BMAD+ integriert.

Siehe auch