Die meisten Teams haben bereits einen Google-Ranking-Report. Es ist der Tab „Leistung" in der Search Console, nach Klicks sortiert und als Screenshot in eine Folie geklebt. Er zeigt Positionen. Er zeigt nicht, was sich geändert hat, warum es sich geändert hat und was jemand dagegen tun sollte.
Dieser Workflow löst das in einer Sitzung. Sie definieren ein Query-Set, geben Codex einen schriftlichen Report-Vertrag und lassen ihn jede Woche einen Report in derselben Form produzieren. Der erste Aufbau dauert etwa 90 Minuten. Jeder weitere Lauf dauert unter zehn.
Der ganze Ablauf: Rohdaten hinein, ein Report in fester Form heraus, eine menschliche Entscheidung am Ende.
Was am Ende steht
Für wen das ist: für alle, die das Reporting für eine Website verantworten und schon Zugriff auf die Search Console haben. Sie müssen keine Entwicklerin sein, brauchen aber einen Ort für Dateien, die Codex lesen kann.
Was Sie am Ende haben: eine gespeicherte Report-Vorlage, eine schriftliche Anweisungsdatei, der Codex bei jedem Lauf folgt, und einen fertigen Report für eine echte Woche.
Voraussetzungen: eine verifizierte Search-Console-Property, eine Liste von 20 bis 50 Queries, die Ihnen wirklich wichtig sind, ein Codex mit Zugriff auf einen Projektordner und Lesezugriff auf das Repository Ihrer eigenen Website, wenn Sie die fortgeschrittene Variante wollen.
Definition von fertig: Sie können den Report jemandem geben, der kein SEO macht, und diese Person kann Ihnen sagen, welche drei Queries sie ansehen soll und warum.
Zeit: etwa 90 Minuten für den ersten Aufbau, danach unter 10 Minuten pro Lauf.
Warum der Leistungs-Report kein Ranking-Report ist
Die Search Console liefert vier Spalten: Klicks, Impressionen, CTR und durchschnittliche Position. Das ist eine Messtabelle. Ein Ranking-Report muss eine andere Fragenmenge beantworten, und die Signale von 2026 haben diese Lücke größer gemacht als früher.
Die am 9. September 2026 veröffentlichte Zyppy-Expertenumfrage sammelte 13.665 Datenpunkte von 131 Praktikern. Klick- und Verhaltenssignale lagen bei 29,4%, Markensignale bei 27,0%, technische SEO-Gesundheit bei 17,5%. Zwei der drei Signale, die über der technischen Gesundheit liegen, sind in einer Positionsspalte unsichtbar. Unsere eigene Aufschlüsselung, was diese Zahlen ändern, steht im Praxisleitfaden, aber die Kurzfassung fürs Reporting lautet: Wenn Ihr Report nur Positionen zeigt, berichten Sie über das Signal, das sich am wenigsten bewegt hat.
Genau diese Lücke schließt Codex. Er sagt Ihnen nicht, warum Google etwas geändert hat. Er stellt die Belege für die Änderung konsistent genug zusammen, dass Sie es sagen können.
Vor dem Start: vier Entscheidungen
Treffen Sie diese, bevor Sie etwas schreiben, denn eine spätere Änderung bedeutet, den Report neu zu bauen.
- Das Query-Set. 20 bis 50 Queries, gruppiert in zwei oder drei Eimer, die zur Denkweise des Geschäfts passen. „Produkt", „Vergleich", „Support" funktioniert besser als „hohes / mittleres / niedriges Volumen".
- Das Vergleichsfenster. Vergleichen Sie die letzten 28 Tage mit den vorangegangenen 28 Tagen. Kürzere Fenster rauschen, längere verstecken die Änderung, die Sie suchen.
- Die Schwelle. Legen Sie fest, was als berichtenswert gilt. Eine Query, die sich um mehr als fünf Positionen bewegt, oder Impressionen, die sich um mehr als 30% bewegen, während Klicks flach bleiben, sind brauchbare Standardwerte.
- Der Speicherort. Ein Ordner, eine Namensregel.
reports/ranking/YYYY-MM-DD.mdplus ein Unterordnerdata/für die Rohdaten. Codex braucht einen konsistenten Ort zum Schreiben.
Schritt 1: Rohdaten exportieren
Öffnen Sie die Search Console, wählen Sie Ihre Property und gehen Sie auf Leistung. Setzen Sie den Zeitraum auf 56 Tage, damit ein Vergleich 28 gegen 28 aus einem einzigen Export möglich ist, und laden Sie dann über die Export-Schaltfläche die CSV des Tabs „Suchanfragen" herunter.
Machen Sie dasselbe für „Seiten" und für „Geräte", wenn Sie die Aufteilung Mobil gegen Desktop berichten wollen.
Erwartetes Ergebnis: drei CSV-Dateien in data/, benannt mit dem Exportdatum.
Qualitätsprüfung: Öffnen Sie die Query-CSV und prüfen Sie, dass die erste Datenzeile keine Query mit dem Wort "anonymous" ist. Die Search Console hält seltene Queries zurück, und diese Zeilen würden sonst als namenlose Bewegung im Report auftauchen.
Wenn es scheitert: Wenn der Export abgeschnitten ist, ist Ihr Zeitraum zu breit für das Zeilenlimit. Exportieren Sie 28-Tage-Fenster einzeln und lassen Sie Codex sie zusammenfügen.
Schritt 2: Den Report-Vertrag schreiben
Das ist der Schritt, der entscheidet, ob der Workflow die dritte Woche überlebt. Legen Sie den Vertrag in eine Datei, die Codex bei jedem Lauf liest — AGENTS.md im Projektstamm oder eine eigene Anweisungsdatei im Report-Ordner.
Der Vertrag braucht fünf Dinge und sonst nichts:
Vertragsblock | Was Sie schreiben | Warum es zählt |
|---|---|---|
Eingaben | Exakte Dateipfade und die Regel für den Zeitraum | Hindert den Agenten daran, ein Fenster zu erfinden |
Schwellen | Ihre Bänder, in Zahlen | Macht aus einer Tabelle eine Entscheidung |
Ausgabeform | Die drei Abschnitte, in dieser Reihenfolge | Hält Woche 30 mit Woche 1 vergleichbar |
Konfidenzregeln | Was zu sagen ist, wenn die Daten eine Änderung nicht erklären | Verhindert selbstsicheren Unsinn |
Grenzen | Was der Agent nicht tun darf | Nur Lesen, bis Sie ihm vertrauen |
Eine funktionierende Fassung sieht so aus:
## Vertrag für den Ranking-Report
Eingaben: data/queries-*.csv, data/pages-*.csv
Fenster: letzte 28 Tage gegen die vorangegangenen 28 Tage. Beide Daten im Kopf nennen.
Nur drei Dinge berichten:
1. Bewegte Queries: jede Query mit mehr als 5 Positionen Verschiebung, oder
Impressionen über 30% Anstieg bei flachen Klicks, oder jede Query, die aus
den Top 10 gefallen ist.
2. Wahrscheinliche Erklärung: nur die Daten aus den Dateien nutzen. Erklären die
Dateien die Bewegung nicht, schreibe "durch diese Daten nicht erklärt".
3. Nächste Woche prüfen: eine Zeile pro markierter Query, mit der genauen Seite
oder Query, die zu prüfen ist.
Niemals eine Ursache behaupten, die sich in den Daten nicht zeigen lässt. Niemals
eine Änderung an der Website empfehlen. Niemals Dateien außerhalb von
reports/ranking/ bearbeiten.Erwartetes Ergebnis: eine Anweisungsdatei, eingecheckt oder neben den Daten gespeichert.
Qualitätsprüfung: Lesen Sie den Vertrag laut vor. Wenn eine Zeile ohne Änderung auf eine andere Website passen würde, ist sie zu vage, um irgendetwas einzuschränken.
Wenn es scheitert: Wenn Codex immer weitere Abschnitte ergänzt, ist die Ausgabeform nicht spezifisch genug. Benennen Sie die drei Überschriften genau so, wie Sie sie haben wollen.
Die Anatomie des Reports. Der Fuß mit der Liste der tatsächlich genutzten Dateien ist der Teil, dem Prüfende am meisten vertrauen, und der Teil, den die meisten Vorlagen weglassen.
Schritt 3: Den ersten Report erzeugen
Richten Sie Codex auf den Ordner und bitten Sie um einen Report nach dem Vertrag. Bitten Sie um die Datei, nicht um eine Chat-Antwort, damit das Ergebnis prüfbar und diffbar ist.
Im ersten Lauf entdecken Sie, wie Ihre Daten wirklich aussehen. Rechnen Sie mit zwei bis drei Korrekturrunden. Das ist normal und der billigste Teil des ganzen Workflows.
Erwartetes Ergebnis: reports/ranking/YYYY-MM-DD.md mit Kopfzeile, drei Abschnitten und einem Fuß, der die genauen genutzten Dateien auflistet.
Qualitätsprüfung: Nehmen Sie zwei markierte Queries und prüfen Sie die Zahlen von Hand in der Search Console. Wenn sie übereinstimmen, ist die Pipeline solide. Wenn nicht, stoppen Sie und reparieren den Datenschritt. Debuggen Sie die Analyse nicht auf einer kaputten Eingabe.
Wenn es scheitert: Der häufigste Fehler ist ein Datumsversatz zwischen Export und Vertrag. Fixieren Sie beide Daten in jedem Lauf in der Kopfzeile, damit ein Versatz von zwei Tagen nicht stillschweigend einen flachen Monat in einen Zusammenbruch verwandelt.
Die erste Fassung, die ich gebaut habe, berichtete elf bewegte Queries in einer Woche, in der sich kaum etwas bewegt hatte. Der Vertrag war in Ordnung, der Export nicht. Eine 30-Tage-Datei gegen ein 28-Tage-Fenster ließ zwei fehlende Tage wie einen site-weiten Einbruch aussehen. Der Vertrag verweigert jetzt den Lauf, wenn die beiden Zeiträume nicht übereinstimmen, und dieser Fehler ist nicht wiedergekommen.
Schritt 4: Die Zeile ergänzen, die der Agent nicht schreiben kann
Jeder Report bekommt einen menschlichen Absatz: was wir letzte Woche ausgeliefert, geändert oder kaputt gemacht haben.
Das ist keine Dekoration. Es ist der schnellste Weg, einen Agenten zu erwischen, der Ihr eigenes Release einem Algorithmus-Update zuschreibt. Wenn der Report sagt, ein Cluster von Produktseiten sei abgefallen, und Ihre Notiz sagt, das Template wurde am Dienstag geändert, verengt sich die Erklärung sofort.
Erwartetes Ergebnis: zwei oder drei Sätze oben im Report, von einem Menschen geschrieben.
Qualitätsprüfung: Wenn sich Notiz und Bewegungsabschnitt widersprechen, ist dieser Widerspruch die wertvollste Zeile im Report. Lassen Sie ihn sichtbar, statt ihn zu glätten.
Schritt 5: Vor dem Versenden prüfen
Führen Sie diese drei Prüfungen aus, bevor der Report Ihren Schreibtisch verlässt.
- Daten. Beide Fenster in der Kopfzeile genannt, übereinstimmend mit dem Export.
- Zwei Stichproben. Zwei markierte Queries von Hand geprüft.
- Eine Widerspruchsprüfung. Verweist eine behauptete Erklärung auf Daten, die nicht in der Dateiliste am Fuß stehen?
Wenn alle drei bestehen, kann der Report geteilt werden. Er ist ein Entwurf Ihres Urteils, kein Ersatz dafür.
Der fortgeschrittene Pfad, wenn Sie bereit sind
Fahren Sie den Workflow zuerst vier Wochen von Hand. Automatisieren Sie erst, nachdem Sie dieselbe Fehlerklasse zweimal korrigiert haben.
Danach sind die Verbesserungen schrittweise:
- Den Lauf planen. Ein wöchentlich geplanter Lauf schreibt den Report, bevor Sie Ihr Notebook öffnen. Halten Sie den menschlichen Absatz als Pflichtfeld, damit der Report ohne ihn nicht rausgehen kann.
- Momentaufnahmen in die Versionsverwaltung legen. Jeder Lauf wird ein Commit. Der Diff zwischen zwei Wochen liest sich schneller als jeder der beiden Reports.
- Eine zweite Property ergänzen. Wettbewerber- oder Marken-Queries liegen in einem eigenen Report mit demselben Vertrag, nicht eingemischt in den Hauptreport.
- Ein externes Signal ergänzen. Eine Prüfung auf Markensuche oder Antwortanteil macht das Markensignal aus der Umfrage 2026 messbar statt theoretisch.
Was nicht automatisiert werden sollte: der Empfehlungsschritt. In dem Moment, in dem ein Agent beginnt, Änderungen an der Website vorzuschlagen, sind Sie vom Berichten ins Veröffentlichen übergegangen, und der Prüfaufwand wächst schneller als die gesparte Zeit.
Fehlerbehebung
Symptom | Wahrscheinliche Ursache | Behebung |
|---|---|---|
Jede Query scheint gefallen zu sein | Datumsversatz zwischen den Exporten | Beide Fenster im Vertrag und in der Kopfzeile fixieren |
Der Report ist leer | Schwellen zu streng für Ihr Traffic-Niveau | Impressionen-Schwelle senken, bevor Sie die Positionsschwelle senken |
Jede Woche dieselben fünf Queries | Das Query-Set ist zu eng | Long-Tail- und Vergleichs-Queries in die Eimer aufnehmen |
Bewegung ohne Erklärung | Bei Queries mit niedrigem Volumen normal | Die Ausgabe „durch diese Daten nicht erklärt" behalten und weitergehen |
Zahlen weichen von der Search Console ab | Property- oder Filterabweichung im Export | Immer aus derselben Property und demselben Filtersatz exportieren |
Den Workflow instand halten
Drei Pflegeroutinen halten ihn über das erste Quartal hinaus nützlich.
Das Query-Set jedes Quartal überprüfen. Ein Report, der den Prioritäten des letzten Jahres nachläuft, ist eine Geschichtsstunde, kein Ranking-Report.
Den Vertrag neu lesen, wenn sich die Search Console ändert. Google aktualisiert die Oberfläche des Leistungs-Reports und die Exportfelder regelmäßig. Wenn ein Feld verschwindet, braucht der Vertrag noch am selben Tag eine Änderung.
Alte Reports behalten. Den Report dieses Quartals mit demselben Quartal des Vorjahres zu vergleichen ist der einzige günstige Weg, einen echten Rückgang von Saisonalität zu trennen.
Häufige Fragen (FAQ)
Brauche ich unbedingt Codex? Nein. Der Workflow funktioniert mit jedem Agenten, der Dateien lesen, nach Zeitplan laufen und ein prüfbares Ergebnis schreiben kann. Codex passt gut, wenn Ihre Website ohnehin in einem Repository liegt, weil der Report dann ein Commit wird, den Sie vergleichen können.
Geht das nur mit kostenlosen Werkzeugen? Ja. Der ganze Workflow läuft auf den kostenlosen Daten der Search Console plus dem Agenten. Ein bezahlter Rank-Tracker ist erst nötig, wenn Sie Wettbewerberpositionen oder Positionen wollen, die Sie in Ihrer eigenen Property nicht sehen.
Worin unterscheidet sich das vom Leistungs-Report der Search Console? Der Leistungs-Report zeigt Ihnen eine Tabelle. Dieser Workflow erzeugt eine Entscheidung: welche Queries eine Schwelle überschritten haben, was die Daten erklären und was nicht, und was nächste Woche zu prüfen ist. Außerdem führt er ein Protokoll, was die Oberfläche nicht tut.
Was, wenn meine Website sehr wenig Traffic hat? Senken Sie die Impressionen-Schwelle und vergleichen Sie 28 Tage mit denselben 28 Tagen des Vorjahres statt mit den vorangegangenen 28. Websites mit wenig Volumen gewinnen mehr Signal aus Jahresvergleichen als aus Wochenvergleichen.
Sollte der Report AI Overviews oder KI-Zitate enthalten? Wenn Sie möchten, ergänzen Sie einen eigenen Abschnitt mit eigenem Vertrag. Halten Sie ihn aus dem Positions-Report heraus, weil Quellen und Messung anders sind und die Mischung beide schwerer lesbar macht.
Autor: Leo Harrington, Übersetzer für SEO-Analytik für über 500 Management-Reports bei Auspia. Leo schreibt darüber, wie man Suchdaten in Reports verwandelt, nach denen auch Nicht-Fachleute handeln können.
