GEO-Website-Audit
Übersicht
Führt eine externe Prüfung der KI-Such-Sichtbarkeit einer Website in einem oder mehreren Ländern/Sprachmärkten allein anhand der URL durch und erstellt einen umsetzbaren Bericht für den Kunden.
Kernprinzip: Ressourcen nach Evidenzstärke verteilen. Die größten Hebel sind (in dieser Reihenfolge) crawlbar → indexierbar → für KI aufnehmbar → extern erwähnt – nicht das Umschreiben von Texten. Jede Empfehlung muss die Evidenznummer und -stärke aus references/evidence.md angeben.
Dieses Skill folgt dem offenen Agent-Skills-Format und kann in Claude Code, Codex, Cursor und anderen Tools verwendet werden – Installation mit bash <skill>/install.sh in das Skill-Verzeichnis des jeweiligen Tools. Alle Pfade beziehen sich auf das Verzeichnis, in dem sich diese SKILL.md befindet (als <skill> bezeichnet).
Wann nicht verwenden
- Vollständiges traditionelles SEO-Audit (Backlinks, Keyword-Rankings): Nur erwähnen, wenn GEO-relevant.
- Tatsächliche Sichtbarkeit über KI-Schnittstellen testen: Wird nicht durchgeführt; im Bericht werden nur manuelle Methoden genannt.
- Direkte Änderungen an der Kundenwebsite: Nur Bericht; maximal 1–2 Beispiel-Umschreibungen.
Erforderliche Umgebungsfähigkeiten
| Fähigkeit | Verwendung | Falls nicht vorhanden |
|---|---|---|
| Shell + Python 3 | Ausführen der Prüfskripte in <skill>/scripts/ (nur Standardbibliothek) | Kein Audit möglich; Benutzer informieren |
| Netzwerkzugriff | Skripte crawlen die Kundenwebsite | Schritt 1 erkennt Fehler; anhalten und Benutzer bitten, Netzwerk zu aktivieren |
| Websuche-Tool (in Claude Code: WebSearch) | Externe Erwähnungen | Abschnitt „Externe Erwähnungen" mit "Nicht prüfbar (keine Websuche in dieser Umgebung)" schreiben; Abschnitt nicht weglassen |
| Webseiten-Fetch-Tool (in Claude Code: WebFetch) | Externe Seiten lesen | Mit curl ersetzen |
| Datei-Schreib-Tool | Bericht schreiben | Mit Shell-Heredoc ersetzen |
| Chrome/Chromium (optional) | Rendering-Vergleich | Skript markiert automatisch "Nicht geprüft" |
Dateien
| Datei | Verwendung |
|---|---|
scripts/crawl_check.py | robots.txt auf Freigabe für KI-Crawler (RFC 9309), UA-Blockierung, Sitemap, Canonical, Noindex, HTTPS, llms.txt, ICP, hreflang (HTML/HTTP-Header/Sitemap – drei Quellen mit bidirektionaler Prüfung) |
scripts/render_diff.py | Verhältnis des Textinhalts ohne JS-Ausführung zum gerenderten Inhalt |
scripts/page_audit.py | Überschriftenhierarchie, Beweiseinheiten, strukturierte Daten, Autor und Aktualisierungsdatum, Canonical, hreflang; --save-html speichert rohes HTML |
references/checklist.md | Allgemeine Checkliste mit P0/P1/P2-Regeln |
references/markets/<code>.md | Marktprofile: cn us jp kr de fr es; für nicht profilierte Märkte: _generic.md |
references/evidence.md | Evidenzbibliothek E1–E16 |
references/ai-crawlers.md | Crawler-Verwendungszwecke, Engines ohne öffentlichen User-Agent, Grenzen getarnter User-Agents |
references/report-template.md | Berichtsstruktur und Schreibregeln (MUSS verwendet werden) |
Allgemeine Parameter aller Skripte: python3 <skill>/scripts/<skript>.py <url> [weitere url…] [--proxy URL] [--timeout sek] [--lang sprachtag] [--out datei.json]. Ausgabe als JSON auf stdout; Exit-Code immer 0. crawl_check.py akzeptiert nur eine URL, zusätzlich --markets cn,us,jp.
Prüfprozess
Zunächst das Ausgabeverzeichnis geo-report-<hostname>-<YYYYMMDD>/ erstellen (im aktuellen Arbeitsverzeichnis; <hostname> ist der unveränderte Hostname der endgültigen URL der Startseite, z. B. www.example.com); alle Rohdaten dort speichern. Die Berichtsdatei geo-report-<hostname>-<YYYYMMDD>.md liegt auf derselben Ebene.
-
Kontext sammeln
- URL ist Pflicht. Bei fehlender Marke/Hauptgeschäft einmal nachfragen; wenn der Benutzer nicht antwortet, aus der Startseite ableiten und im Bericht unter „Prüfumfang und Annahmen" aufführen.
- Berichtssprache = Sprache, in der der Benutzer das Audit startet; bei abweichender Vorgabe des Benutzers dessen Vorgabe verwenden.
- Zielmärkte (Liste der Marktcodes): Vom Benutzer genannte Märkte haben Priorität. Wenn nicht genannt, zuerst Schritt 2 ausführen, dann aus
crawl.json(hreflang und Sprachumschalter) ableiten und vom Benutzer bestätigen lassen. Ein Audit deckt standardmäßig maximal 3 Märkte ab; bei keiner Antwort: „dem Standardmarkt der Website entsprechender Markt + aus hreflang maximal 2 bereits profilierte Märkte (Reihenfolge: cn, us, jp, kr, de, fr, es)"; die restlichen als „in diesem Audit nicht geprüft" aufführen. Auf ausdrücklichen Wunsch des Benutzers mehr, aber Seitenzahl und Zeitbudget bleiben unverändert. - Märkte werden nach Land oder Region unterschieden.
zh-TW/zh-HK,en-GB(nicht-US-Englisch),de-AT/de-CH,fr-BE/fr-CAusw. verwenden_generic; Zuordnung siehe Abschnitt 1 inmarkets/_generic.md. - Netzwerk-Ausstiegsland des Prüfcomputers bestätigen (z. B.
curl -s https://ipinfo.io/country).
-
Crawl-Prüfung (gleichzeitig Netzwerk-Testlauf)
python3 <skill>/scripts/crawl_check.py <url> --markets <codeliste> --lang <sprachtag des ersten zielmarktes> --out <ausgabeverzeichnis>/crawl.json- Wenn
homepageundrobotsbeide Netzwerkfehler melden, ist die Umgebung offline: Stopp; dem Benutzer mitteilen, dass Netzwerk aktiviert werden muss (Aktivierung in Codex siehe README); keinen leeren Bericht erstellen. - Werte auswerten:
ai_crawlers(besonders mitrelevant: true),ua_blocking,homepage,robots.value.source,meta_robots,x_robots_tag,canonical,https,sitemap,icp,hreflang,other_domains. Bewertungsregeln inreferences/checklist.md; lokale Crawler in den Marktprofilen, Abschnitt 4. - Wenn
sitemap.value.truncatedtrue ist, istcountnur die gelesene Anzahl, nicht die Gesamtzahl aller Seiten. - Sprachversionen auf anderen Hosts: In
hreflang.declaredaufgeführte Versionen auf anderer Domain/Subdomain, die zu den ausgewählten Zielmärkten gehören, werden in dieses Audit einbezogen; deren Startseite wird erneut mitcrawl_check.pygeprüft, Ausgabe alscrawl-<hostname>.json. Andere Domains, die nicht im hreflang deklariert sind (other_domains), nur im Bericht erwähnen; separates Audit wird empfohlen.
- Wenn
-
Schlüsselseiten auswählen: Pro Zielmarkt mindestens 2 Seiten (die Sprachversion des Marktes), insgesamt höchstens 20. Priorität: Startseite, Kernprodukt-/Dienstleistungsseiten, Vergleichsseiten, Preisseiten, Über-uns-Seite, Inhaltsseiten. Quellen vorzugsweise Sitemap und Navigation.
-
Rendering-Vergleich: Jeweils 1–5 URLs, Timeout 30 s, Sprache des entsprechenden Marktes:
python3 <skill>/scripts/render_diff.py <url1> <url2> --timeout 30 --lang ja-JP --out <ausgabeverzeichnis>/render-1.json -
Einzelseiten-Audit und Text lesen:
python3 <skill>/scripts/page_audit.py <url1> <url2> … --lang ja-JP --save-html <ausgabeverzeichnis>/html --out <ausgabeverzeichnis>/pages-jp.json- Das Skript zählt nur und schließt Links und Überschriften in
<nav>und seitenweitem<header>,<footer>aus. - Zum Lesen des Texts die mit
--save-htmlgespeicherten Dateien verwenden; kein separates Crawl-Skript schreiben und keine Zwischendateien außerhalb des Ausgabeverzeichnisses ablegen. - Zu prüfende Aspekte: Vorhandensein von Definitonssätzen, Vergleichen, Schritten, überprüfbaren Daten; ob ein Absatz nur eine Behauptung enthält; versteckter Text (z. B. eingeklappte FAQs nur in JS-Daten, Zahlenanimationen zeigen 0 im HTML); ob die lokale Sprachversion echte Lokalisierung oder maschinelle Übersetzung ist; Lokalisierungspunkte aus Abschnitt 7 des Marktprofils.
- Das Skript zählt nur und schließt Links und Überschriften in
-
Indexierbarkeits-Check: Pro Zielmarkt 10–20 Fragen in der Landessprache ableiten (Fragenstil siehe Marktprofil Abschnitt 6), die die Phasen Bekanntheit/Vergleich/Entscheidung/After-Sales abdecken. Für jede Frage prüfen, ob eine Seite in der Sprachversion des Marktes eine direkte Antwort liefert; in die „Fragenabdeckungstabelle" des Berichts eintragen (Originalsprache + Übersetzung in Berichtssprache).
-
Externe Erwähnungen: Mit dem Websuche-Tool die Plattformen aus Abschnitt 5 des Marktprofils durchsuchen; jeweils „vorhanden / nicht vorhanden / nicht prüfbar" mit repräsentativem Link notieren. Plattformen mit Login nicht prüfen.
-
Audit-Konfiguration speichern: In
<ausgabeverzeichnis>/audit.jsonschreiben:{"target": "", "markets": ["jp", "us"], "report_language": "ja", "brand": "", "business": "", "pages": {"jp": ["…"], "us": ["…"]}, "questions": {"jp": ["…"], "us": ["…"]}, "offsite_queries": {"jp": ["…"], "us": ["…"]}, "extra_hosts": ["…"], "proxy_country": {"jp": "JP"}, "date": "YYYY-MM-DD"}proxy_countryerfasst nur das verwendete Ausstiegsland (bei keiner Verwendung{}), nicht die Proxy-Adresse. -
Bericht schreiben: Nach der Struktur von
references/report-template.md, in der Berichtssprache. Kapitelnummern sind fix; nicht zutreffende mit „Nicht zutreffend" kennzeichnen.
Wiederholungsmodus
Stellt der Benutzer ein früheres geo-report-<hostname>-<datum>/-Verzeichnis bereit, wird die darin enthaltene audit.json gelesen; dieselben Märkte, Schlüsselseiten, Fragen und Offsite-Suchbegriffe werden erneut verwendet; Schritte 2–7 werden wiederholt, und der Bericht enthält einen Abschnitt „Vorher-Nachher-Vergleich".
Alte audit.json-Dateien verwenden "market": "cn" | "global" | "both"; Umrechnung: "cn" → cn; "global" → us; "both" → cn,us. Der alte questions-Schlüssel global entspricht us.
Ratenbegrenzung und Zeitbudget
- Die Skripte enthalten integriertes Backoff: Bei 429 oder 503 mit Retry-After wird einmal gewartet und wiederholt, danach werden weitere Anfragen automatisch verlangsamt. Wenn Ergebnisse
rate_limited: trueenthalten oder mehrere Seiten hintereinander 429 zurückgeben:- Die Anzahl der verbleibenden Schlüsselseiten auf 2 pro Markt reduzieren;
- Im Bericht unter „Prüfumfang und Annahmen" vermerken: „Website limitiert Anfragen; Stichprobenumfang reduziert".
- Bei Drosselung kann ein einzelnes Skript mehrere Minuten laufen (Warten auf Retry-After). Shell-Timeout auf 10 Minuten setzen oder das Skript im Hintergrund ausführen; JSON-Ausgabe nicht durch Timeout-Abbruch verlieren.
- Das gesamte Audit sollte in 45 Minuten abgeschlossen sein. Bei Überschreitung keine weiteren Crawls starten; mit den vorhandenen Daten den Bericht schreiben und die nicht abgeschlossenen Prüfungen vermerken.
- Verboten: Zum Umgehen der Ratenbegrenzung Proxys oder Ausstiegs-IPs zu wechseln, den User-Agent zu ändern oder Wiederholungen zu beschleunigen.
- Nur in zwei Fällen darf
--proxyverwendet werden, um einen bestimmten Länderausstieg zu wählen: Erreichbarkeit des Zielmarktes prüfen; Website liefert je nach Standort unterschiedliche Inhalte. Das verwendete Ausstiegsland muss im Bericht vermerkt werden – nur das Land, nicht die Proxy-Adresse (Proxy-Adresse ist interne Information des Prüfers; Bericht undaudit.jsonwerden an den Kunden weitergegeben).
Bewertungshinweise
| Skriptergebnis | Bedeutung | Berichtsformulierung |
|---|---|---|
ai_crawlers: Such- oder benutzerausgelöste Crawler = fail | robots.txt blockiert eindeutig | P0 |
ai_crawlers: = unknown | robots.txt nicht lesbar | „Nicht prüfbar" und Grund nennen |
ai_crawlers: Trainings-Crawler = warn | Trainings-Crawler blockiert | Nur Vor-/Nachteile nennen |
ua_blocking = suspect | Browser-UA funktioniert, getarnter KI-UA wird blockiert | P1, „Verdacht auf Blockierung"; Kunde bitten, CDN/WAF oder Server-Logs zu prüfen |
ua_blocking = warn / unknown | Alle werden blockiert / Limit oder Fehler | Prüfung eingeschränkt |
homepage = unknown | Prüfcomputer durch WAF herausgefordert | Nicht „Website nicht erreichbar"; aus anderem Netzwerk prüfen |
render_diff: ratio < 0.5 | KI-Crawler sehen den Text praktisch nicht | P0; js_only_headings auflisten |
hreflang.alternates: fail / warn | Sprachversion nicht erreichbar / nicht bidirektional | P1 / P2 |
Beliebiges Feld = unknown | Konnte nicht geprüft werden | „Nicht prüfbar" und Grund nennen; keine Bewertung |
llms_txt | Nur Vorhandensein erfassen | In „Nicht empfohlen" aufführen |
raw_words / rendered_words | CJK-Schriftzeichen zählen als 1 pro Zeichen, andere Sprachen nach Wort | Wortanzahlen verschiedener Sprachen sind nicht direkt vergleichbar |
Richtlinien
- Jede Aussage benötigt eine Evidenz; jede Empfehlung muss Evidenznummer und -stärke nennen. Bei Zielmarkt ungleich
us: „(geschätzt)" anhängen, es sei denn, Abschnitt 8 des Marktprofils sagt etwas anderes. Bei nicht profilierten Märkten vermerken: „Dieser Markt ist nicht profiliert; Evidenz schwächer." - Nicht gecrawlte Inhalte mit „Nicht prüfbar" kennzeichnen; keine Bewertung aus dem Gedächtnis.
- Nicht empfohlen: Daten fälschen, Bewertungen fingieren, Bewertungen kaufen, für KI versteckte Anweisungen einfügen, Konkurrenten herabsetzen oder maschinelle Übersetzung für Massen-Mehrsprachigkeit verwenden (E13).
- llms.txt, FAQ-Schema, Schema.org, autoritativen Tonfall nicht als Kernempfehlungen behandeln (E10, E9, E7).
- Keine Traffic- oder Ranking-Versprechen machen (E15).
- Die Berichtssprache MUSS mit der Sprache der Benutzeranfrage übereinstimmen (es sei denn, der Benutzer gibt eine andere Sprache vor).
Häufige Fehler
suspectals definitive Blockierung behandeln: Nur eine eindeutige Blockierung in robots.txt ist P0.- Mit Google-Rankings auf KI-Sichtbarkeit schließen: Die Überschneidung ist gering (E13); Märkte und Engines getrennt betrachten.
- Fragen in der Berichtssprache ableiten: Ableitung der Fragen muss in der Landessprache des Zielmarktes und aus Sicht der lokalen Nutzer erfolgen.
- Nur Skriptzählungen als Grundlage für Schlussfolgerungen verwenden: Viele
numbersbedeuten nicht zwangsläufig überprüfbare Daten;external_linkskönnen auch Fußzeilen-Links in<div>-Elementen enthalten; den Text lesen. - Die
countder Sitemap als Gesamtseitenzahl behandeln: Beitruncated: truemuss dies vermerkt werden. - Bei Drosselung durchhalten: Seitenzahl gemäß Abschnitt „Ratenbegrenzung und Zeitbudget" reduzieren; keine eigenen Schleifen mit langem Warten schreiben.
- Sprachversionen auf anderen Hosts übersehen: Im hreflang deklarierte Zielmarktversionen auf anderen Domains müssen in das Audit einbezogen werden.