Search Console Insights (Upload-Import)

Search Console Insights wertet deine Google-Search-Console-Exporte aus, ohne dass du die API verbinden musst. Du lädst die ZIP-Datei hoch, das Modul erkennt automatisch den Typ (Leistung oder Indexierung), berechnet deterministisch priorisierte Insights und lässt die KI jede Empfehlung in Klartext mit konkretem Beispiel erklären.

Was es kann

• Zwei Export-Typen, Auto-Erkennung — Leistung („Performance on Search": Suchanfragen, Seiten, Länder, Geräte, Darstellung, Diagramm) und Indexierung („Coverage": indexiert vs. nicht-indexiert über Zeit, kritische Probleme). Den Typ erkennen wir am Datei-/Spalten-Aufbau automatisch.
• Chancen-Erkennung (Leistung) — Striking Distance (Positionen 11–20 mit Potenzial), CTR-Ausreißer (hohe Impressionen, zu niedrige CTR → Title/Meta-Chance), „viel gesehen, kaum geklickt", Marke vs. Nicht-Marke, Positions-Verteilung, Klick-Trend.
• Fehler-Erkennung (Indexierung) — Indexierungs-Trend, 404er, Weiterleitungen, „durch noindex ausgeschlossen", „gecrawlt – zurzeit nicht indexiert" u. a. — nach betroffenen Seiten priorisiert.
• Deterministische Zahlen + KI-Erklärung — alle Kennzahlen werden in PHP berechnet (keine erfundenen Werte); die KI erklärt jede Karte verständlich und liefert konkrete Maßnahmen mit Beispiel (z. B. ein vorgeschlagener Title).
• Projekt-Zuordnung & Filter — jeden Upload einem Projekt zuordnen (beim Hochladen oder nachträglich) und das Dashboard pro Projekt filtern.

Wann nutzen

• Du hast keine OAuth-Anbindung, willst aber trotzdem deine GSC-Daten auswerten.
• Schneller Überblick über Quick Wins (Seite-2-Keywords, CTR-Chancen) und Indexierungs-Probleme.
• Kunden-/Projekt-getrennte Auswertung mehrerer Properties.

Workflow im UI

1. Exportieren — in der Google Search Console den Leistungs- oder Indexierungs-Bericht als ZIP exportieren.
2. Hochladen — unter /search-console die ZIP hochladen (max. 25 MB); optional ein Projekt zuordnen.
3. Auswerten — KPIs, Trend-Chart und Insight-Karten erscheinen; die KI-Erklärungen werden im Hintergrund ergänzt (ai-Queue).
4. Umsetzen — Karten nach Wirkung (Impact) abarbeiten; jede Karte nennt einen konkreten nächsten Schritt mit Beispiel.

Über den AI-Chat / die API

Der Rankion-Agent kann das Modul direkt nutzen:

• GET /api/v1/search-console — listet alle Uploads des Teams (optional ?project_id=). Liefert je Upload type, property, Zeitraum, Zeilenzahlen und die id.
• GET /api/v1/search-console/{id} — liefert die Insights eines Uploads: deterministische metrics plus ai_summary und ai_actions (Maßnahme + Beispiel) je Karte.

Typische Chat-Frage: „Schau dir die Search-Console-Daten von <Domain> an und hilf mir, sie zu verbessern." → Agent listet Uploads, wählt den passenden und holt die Insights.

Wichtig zu wissen (Datenrealität)

• Der GSC-UI-Export ist auf 1.000 Zeilen pro Tabelle begrenzt und ca. 45 % der Suchanfragen sind anonymisiert → Gesamtsummen sind systematisch untertrieben. Das Modul zeigt deshalb relative Chancen, keine exakten Totals.
• Kannibalisierung und Query-Page-Mismatch brauchen Query+Page in einer Zeile (nur über API/Bulk-Export) und sind aus dem reinen Upload nicht zuverlässig ableitbar.
• Echte Index-/Coverage-Fehler stehen vollständig nur im GSC-Indexierungsbericht; der Upload liefert daraus die kritischen Problem-Kategorien mit Seitenzahlen.