ChaoticSurfer/seo-suite

Analyse: messen, diagnostizieren, berichten

Wandeln Sie First-Party-Daten (Search Console, Bing Webmaster, GA4, Server-Logs) in Entscheidungen um. Diagnostizieren Sie Einbrüche mit einem festgelegten Entscheidungsbaum anstelle von Ratespielen und messen Sie Änderungen ehrlich.

Wann verwenden / nicht verwenden

Verwenden Sie es für:

• Search Console-, Bing Webmaster- und GA4-Exporte.
• Traffic-Einbrüche und Fragen zu Algorithmus-Updates.
• CTR-Optimierungsziele.
• Kannibalisierung.
• Crawl-Log-Analyse.
• KPI-Dashboards.
• Vorher/Nachher-Tests.

Nicht geeignet für:

• Finden von On-Site-Mängeln → seo-technical, seo-audit. Dieses Skill ruft sie auf, wenn der Einbruchbaum darauf hinweist.
• Keyword-Ideen für neue Seiten → seo-keywords.
• Wettbewerbssichtbarkeit → seo-competitors.

Zu sammelnde Eingaben

• Search Console Leistungsexport(e).
  • UI-Export: Queries.csv / Pages.csv (nur die ersten 1.000 Zeilen).
  • API- oder Looker Studio-Export mit Query+Page-Zeilen: für Kannibalisierung erforderlich. API-Limit: 25.000 Zeilen/Anfrage, ~50.000 Zeilen/Tag/Typ (google-regeln §11).
  • Für Vergleiche: zwei Fenster gleicher Länge, auf Wochentage ausgerichtet, wobei die letzten 2–3 Tage ausgeschlossen werden (GSC-Daten hinken hinterher).
• Marken-Regex. Markenname plus Tippfehler, z. B. acme|acme ?corp|акме.
• Optional:
  • Bing Webmaster-Export (gleiche Form; funktioniert mit gsc_analyze).
  • GA4-Bericht über organische Landingpages.
  • Server-Zugriffslogs (.log / .gz).
  • Die Daten von Seitenänderungen, Deployments und Migrationen.
• Bei Einbrüchen: wann es begann, welcher Bereich/Land/Gerät und ob auch die Conversions gesunken sind.

Workflow

A. Chancenanalyse (GSC/Bing-Export)

1. Führen Sie die Analyse aus:

   mkdir -p seo-work
   python3 "${CLAUDE_PLUGIN_ROOT}/scripts/gsc_analyze.py" Queries.csv --brand "marke|mark" --min-impressions 50 > seo-work/gsc.json
   python3 "${CLAUDE_PLUGIN_ROOT}/scripts/gsc_analyze.py" query_page.csv --brand "marke" > seo-work/gsc-qp.json   # Kannibalisierung
   

   Flags: --striking-from 4 --striking-to 20 (Standardwerte); erhöhen Sie --min-impressions bei großen Websites.

2. Lesen Sie striking_distance (Positionen 4–20, sortiert nach est_extra_clicks_at_pos3 [Schätzung]). Dies sind die Seiten, die zuerst verbessert werden sollten. Übergeben Sie jede mit ihrer Query an seo-onpage / seo-content.

3. Lesen Sie ctr_underperformers. Top-10-Queries, deren CTR unter der Hälfte der eigenen mittleren CTR dieser Website für diese Position liegt (ctr_curve_used; sie greift auf Standardwerte zurück, wenn zu wenig Daten vorhanden sind).

   • Ursachen: schwacher Titel/Snippet, ein SERP-Feature oder AI Overview über dem Ergebnis oder eine Intent-Diskrepanz.
   • Überprüfen Sie die Live-SERP mit WebSearch, bevor Sie umschreiben.

4. question_queries: Material für FAQ-Abschnitte und Antwort-zuerst-Passagen (seo-content, seo-ai-search).

5. brand_split: Melden Sie Nicht-Marken-Klicks separat. Markennachfrage ist keine SEO-Leistung.

6. cannibalization: Eine Query, bei der 2+ Seiten jeweils ≥10 % der Impressionen erhalten. Entscheiden Sie von Fall zu Fall: zusammenführen + 301, die Intent unterscheiden oder interne Links auf die primäre Seite ausrichten. Nicht jede Aufteilung ist ein Problem: Wenn beide Seiten gut ranken, lassen Sie sie.

B. Periodenvergleich und Diagnose von Traffic-Einbrüchen

1. Führen Sie den Vergleich aus:

   python3 "${CLAUDE_PLUGIN_ROOT}/scripts/gsc_analyze.py" last_28d.csv --compare prev_28d.csv > seo-work/gsc-compare.json
   

   Jeder Verlierer erhält eine likely_cause:

   • "Rankings gesunken"
   • "Weniger Impressionen bei ähnlichem Rang" (Nachfrage oder ein SERP-Feature)
   • "CTR bei ähnlichem Rang gesunken"

   Dies sind Heuristiken: Formulieren Sie sie als "vereinbar mit".

2. Gehen Sie den Einbruchbaum der Reihe nach durch und stoppen Sie beim ersten Zweig, den die Beweise stützen. Dokumentieren Sie die Beweise für jeden Zweig:

   1. Ist der Einbruch real?

      • GSC-Klicks vs. GA4 organische Sitzungen, Vergleich der Trendrichtung (erwarten Sie eine Lücke von 10–20 % auf Niveauebene).
      • Ein Einbruch nur in GA4 → Tracking-/Einwilligungs-/Tag-Problem, kein SEO.
      • Überprüfen Sie das Vorjahresvergleich, um Saisonalität auszuschließen.

   2. Technisch. Parallel ausführen:

      • robots_check.py
      • sitemap_check.py
      • page_audit.py auf den Top-Verlust-URLs
      • crawl.py im betroffenen Bereich

      Achten Sie auf:

      • noindex, Canonical-Änderungen, 5xx/429, Robots-Blockaden, Redirect-Änderungen, eine Bot-Challenge (bot-challenge).
      • Deployments am Einbruchsdatum.
      • Den Search Console Seitenindexierungsbericht auf Sprünge bei "Ausgeschlossen" (seo-technical).

   3. Algorithmus-Update. Vergleichen Sie das Einbruchsdatum mit dem Dashboard zum Google-Suchstatus (https://status.search.google.com/ → Ranking-Vorfälle; abrufen). Die Form ist wichtig:

      • Eine seitenweite sprunghafte Änderung an einem Update-Datum fällt mit einer Systemneubewertung zusammen (hilfreicher Inhalt / Core / Spam). Siehe google-regeln §4.
      • Bereichsspezifische Änderungen deuten auf Probleme auf Seitenebene hin.
      • Sagen Sie niemals "abgestraft", es sei denn, die Search Console zeigt eine manuelle Maßnahme an.

   4. Saisonalität / Nachfrage. Jahresvergleich in der GSC (16 Monate Daten; google-regeln §11), plus Google Trends für die Hauptbegriffe. Impressionen runter bei stabilem Rang = Nachfrage.

   5. SERP-Verdrängung. Position stabil, aber CTR runter. WebSearch für die Queries:

      • AI Overview vorhanden? Neue Features (Video, PAA, Shopping, Foren)? Anzeigen?
      • Ist der Search Console-Bericht "Leistung der generativen KI-Suche" verfügbar? (google-regeln §10)

   6. Wettbewerber. Position an bestimmte URLs verloren → seo-competitors (compare_pages auf die Gewinner). Überprüfen Sie die Wayback CDX, wann sich ihre Seite geändert hat.

3. Verwenden Sie Logdaten, wenn verfügbar:

   python3 "${CLAUDE_PLUGIN_ROOT}/scripts/log_analyze.py" access.log access.log.1.gz --verify-dns --sitemap-urls seo-work/urls.txt > seo-work/logs.json
   

   Achten Sie auf:

   • Googlebot-Treffer pro Tag, die einbrechen (Crawl-Kapazitätsproblem: 5xx/429 oder ein langsamer Server; google-regeln §1).
   • Fehler, die an Bots gesendet werden.
   • Parameter-URL-Anteil (Crawl-Verschwendung).
   • Sitemap-Pfade, die nie gecrawlt wurden.
   • Gefälschte "Googlebot"-IPs (unverified_ips).
   • Ob AI-Bots (OAI-SearchBot, Claude-SearchBot, PerplexityBot) die Website überhaupt erreichen.

C. Berichterstattung und Dashboards

• KPIs. Trennen Sie führende von nachlaufenden Indikatoren:
  • Führend: indexierte Seiten (GSC), Impressionen, durchschnittliche Position für Ziel-Cluster, CWV-Bestehensquote, Crawl-Fehler.
  • Nachlaufend: Nicht-Marken-Klicks, organische Conversions/Umsatz (GA4), AI-Zitierungsrate (seo-ai-search).
• Kostenloses Dashboard: Looker Studio mit dem nativen Search Console Connector (Site + URL-Impressionstabellen) und dem GA4 Connector. Seiten:
  • Übersicht.
  • Nicht-Marken-Trend (Regex-Filter).
  • Cluster (URL-Pfad-Gruppierung).
  • Chancen (Positionen 4–20).
  • CWV (der CrUX Connector oder psi.py-Schnappschüsse).
• Monatsbericht: was sich geändert hat, warum (beweismarkiert), was wir getan haben (aus SEO-WORKLOG.md), was als nächstes ansteht.

D. Messen, ob eine SEO-Maßnahme gewirkt hat

1. Vorregistrieren. Notieren Sie vor der Änderung im Arbeitslogbuch:
   • Geänderte URLs.
   • Kontroll-URLs (ähnlich, unverändert).
   • Metrik (Klicks/Impressionen/CTR/Position für die Zielqueries).
   • Erwartete Richtung.
   • Fenster: ≥4 Wochen nach der Indexierung; überprüfen Sie das Datum des erneuten Crawls in der URL Inspection.
2. Exportieren Sie gleiche Fenster vorher und nachher für beide Gruppen und führen Sie dann gsc_analyze.py after.csv --compare before.csv für jede Gruppe aus.
3. Melden Sie die Änderung der Behandlung minus die Änderung der Kontrolle. Bei wenigen Seiten oder niedrigen Klicks sagen Sie "nicht eindeutig". Beanspruchen Sie niemals Kausalität aus einem einzelnen Vorher/Nachher.

Rank-Tracking

• Kostenlos: Durchschnittliche Search Console Position pro Query (impressionsgewichtet, alle Standorte). Gut für Trends; keine "Wo bin ich gerade"-Ansicht.

• Bezahlt: tägliche Positionen für eine feste Keyword-Liste, nach Standort/Gerät, mit SERP-Features. Rechtfertigen Sie es, wenn:

  • lokale oder städteübergreifende Ränge wichtig sind,
  • der Kundenvertrag Rangberichte benötigt, oder
  • Sie Keywords ohne Impressionen verfolgen müssen.

  Optionen: Semrush Position Tracking, Ahrefs Rank Tracker, SE Ranking oder die DataForSEO SERP-API für skriptgesteuerte Prüfungen (tools.md).

Prüfungen

Prüfung	Regel	Quelle
Vergleichsfenster gleiche Länge, wochentagsausgerichtet, letzte 2–3 Tage ausgeschlossen	GSC-Daten hinken 2–3 Tage hinterher	google-regeln §11 [Google-Dokument]
GSC-Aufbewahrung	16 Monate	google-regeln §11 [Google-Dokument]
"Strafe"-Behauptungen	nur mit einem Eintrag im Bericht zu manuellen Maßnahmen	google-regeln §4 [Google-Dokument]
AI Overviews/AI Mode-Traffic	innerhalb der Performance → Web gezählt; keine separaten Klicks	google-regeln §10 [Google-Dokument]
Googlebot-Crawlrate-Einbruch	fällt mit 5xx/429/langsamen Antworten zusammen	google-regeln §1 [Google-Dokument]
CTR-Erwartungen	zuerst die eigene Kurve der Website; Standardwerte sind heuristisch	Heuristik
Kannibalisierungs-Schwellenwert	≥2 Seiten ≥10 % Impressionen, ≥100 Impressionen	Heuristik

Daten: kostenlos vs. bezahlt

Kostenlos deckt hier fast alles ab. Search Console (+API), Bing Webmaster (+dessen AI Performance-Bericht, falls verfügbar; google-regeln §10), GA4, Looker Studio, Server-Logs, das Dashboard zum Google-Suchstatus, Google Trends.

Bezahlt fügt hinzu (siehe ${CLAUDE_PLUGIN_ROOT}/references/tools.md):

• Semrush / Ahrefs.
  • Wettbewerber-Sichtbarkeitsverlauf und Keyword-Bewegung (eigene Daten sind in der GSC besser).
  • Ihre Algorithmus-Volatilitätssensoren (Semrush Sensor), um zu sehen, ob ein Einbruch branchenweit ist.
  • Gerechtfertigt für die Frage "Sind nur wir betroffen?" während eines Updates.
  • Kostentaktik: Überprüfen Sie die kostenlose Sensor-Seite und den Organic Research-Verlauf eines einzelnen Wettbewerbers anstelle eines vollständigen Projekts.
• Rank-Tracker: siehe oben. Verfolgen Sie nur Geld-Keywords und begrenzen Sie Standorte/Geräte auf die, die wichtig sind. Die meisten Tools berechnen pro Keyword × Standort × Gerät × Häufigkeit, daher bevorzugen Sie wöchentlich gegenüber täglich für nicht volatile Sätze.
• Screaming Frog Log File Analyser (## Screaming Frog). Nützlich, wenn Logs riesig sind und der Benutzer eine GUI bevorzugt. log_analyze.py deckt die Kernfragen kostenlos ab.

Kennzeichnen Sie Traffic-Zahlen von Drittanbietern als [Anbieterdaten] / [Schätzung]. Sie sind modelliert, nicht gemessen.

Ausgabe

1. seo-work/gsc.json und ähnliche, plus eine kurze Zusammenfassung der Ergebnisse:
   • Top 10 Striking-Distance-Chancen: Query, Seite, geschätzte zusätzliche Klicks [Schätzung].
   • Top CTR-Korrekturen.
   • Kannibalisierungsentscheidungen.
2. Einbruchdiagnose: der Baum mit ✅/❌ und Beweisen pro Zweig, die wahrscheinlichste Erklärung in "vereinbar mit"-Sprache und nächste Aktionen, die an das richtige Skill weitergeleitet werden.
3. Eine KPI-/Dashboard-Spezifikation (Looker Studio-Datenquellen, Felder, Filter) oder ein Monatsberichtsentwurf.
4. Experimentaufzeichnung (Vorregistrierung + Ergebnis).

Fallstricke & Mythen

• Durchschnittsposition ist impressionsgewichtet über alle Queries/Standorte hinweg. Ein neues Ranking auf Seite 2 kann den Durchschnitt senken, während der Traffic steigt.
• UI-Exporte sind auf 1.000 Zeilen begrenzt und verbergen anonymisierte Queries, sodass die Summen nicht mit dem Diagramm übereinstimmen.
• Ein Einbruch an einem Update-Datum ist kein Beweis dafür, dass das Update die Ursache war. Schließen Sie zuerst technische und Tracking-Ursachen aus.
• Jahresvergleich schlägt Monatsvergleich für saisonale Geschäfte.
• Klicks sinken, während Impressionen halten, ist oft AI Overviews oder ein anderes SERP-Feature, kein Ranking-Verlust.
• GA4 "organisch" hängt vom Einwilligungsmodus und der Kanalgruppierung ab. Überprüfen Sie daher Konfigurationsänderungen am Einbruchsdatum.
• Optimieren Sie die CTR nicht mit Clickbait-Titeln. Google kann sie umschreiben (google-regeln §3).

Dokumentieren Sie die Arbeit

Fügen Sie an SEO-WORKLOG.md (${CLAUDE_PLUGIN_ROOT}/references/worklog.md) an:

• Verwendete Exporte (Datumsbereiche).
• Ausgeführte Skripte.
• Ergebnisse mit Beweismarkierungen.
• Diagnoseergebnis.
• Vorregistrierte Experimente.
• Nutzung kostenpflichtiger Tools.
• Das Datum für eine erneute Überprüfung (z. B. "GSC am 2026-11-21 neu abrufen für den Titel-Test").