GSC Portfolio Audit
Beantwortet die Frage „Wie läuft es überall?“ für jede Eigenschaft eines Search Console-Kontos – eine Frage, die die einzelseitigen Tools ohne Dutzende manueller Exporte nicht beantworten können.
Einrichtung
Erfordert ein OAuth-Refresh-Token mit https://www.googleapis.com/auth/webmasters.readonly:
export GOOGLE_GSC_CLIENT_ID=... # oder GOOGLE_CLIENT_ID
export GOOGLE_GSC_CLIENT_SECRET=... # oder GOOGLE_CLIENT_SECRET
export GOOGLE_REFRESH_TOKEN=...
export GSC_EXCLUDE="olddomain.com" # optional, durch Komma getrennt
pip install requests
Der häufigste Einrichtungsfehler ist unauthorized_client beim Token-Refresh. Dies bedeutet, dass das Refresh-Token für einen anderen OAuth-Client ausgestellt wurde als die ID/das Secret, mit dem Sie es kombinieren. Konten, die im Laufe der Zeit Google-Integrationen hinzugefügt haben, haben normalerweise mehrere Clients; verwenden Sie das Paar, das das Token ausgestellt hat.
Ausführen
python3 scripts/audit_gsc.py # vollständig: Ranking + Keyword-Diff für die Top 12
python3 scripts/audit_gsc.py portfolio # nur die Rangliste
python3 scripts/audit_gsc.py queries --site sc-domain:example.com
python3 scripts/audit_gsc.py --days 90 # Quartal im Vergleich
Flags: --days (Fenster, verglichen mit dem unmittelbar vorhergehenden Fenster), --site (wiederholbar), --top, --limit, --min-clicks.
Abschnitte und ihre Bedeutung
| Abschnitt | Lesart |
|---|---|
| NEU | Suchanfragen ohne Klicks im vorherigen Zeitraum. Hier kommt das tatsächliche Wachstum her. |
| STEIGEND | Um ≥50 % gestiegen. Prüfen Sie, ob sich auch die Position verändert hat – wenn nicht, ist die Nachfrage gestiegen, nicht Ihr Ranking. |
| FALLEND | Um ≥40 % von einer realen Basis gefallen. Die Position verrät die Art: Ranking gefallen = Ranking-Verlust; Ranking gehalten, aber Klicks eingebrochen = etwas hat die Klicks oberhalb von Ihnen abgefangen (AI Overview, ein neues SERP-Feature oder die Suchanfrage hat sich geändert). |
| VERLOREN | Wurde zuvor gerankt, jetzt keine Daten. |
| CTR-LÜCKE | ≥1.500 Impressionen, Top 10, unter 2 % CTR. Titel- und Beschreibungsoptimierung – die günstigsten Gewinne, die es gibt. |
Interpretation
- Berichten Sie zuerst über Klicks, dann über Impressionen. Eine große Eigenschaft kann die Portfolio-Impressionen so stark beeinflussen, dass das Wachstum aller anderen verdeckt wird.
- Trennen Sie Marken- von Nicht-Marken-Keywords. Eine Website, deren gesamtes Keyword-Set nur aus dem eigenen Namen besteht (oder Tippfehlern eines Konkurrenten), hat keine Akquisitionsmaschine, egal wie gut die Klickzahlen aussehen. Sagen Sie das im Bericht deutlich.
- Ein kompletter Zusammenbruch einer Website bei ihrem eigenen Namen ist normalerweise kein SEO-Problem. Prüfen Sie die Inhaberschaft, bevor Sie Rankings diagnostizieren:
whois <domain> | grep -i "registrar\|updated date"plus ob die Domain noch aufgelöst wird. Abgelaufene, übertragene oder umstrittene Domains erzeugen eine charakteristische Ranking-Klippe, die keine SEO-Arbeit beheben kann. - „Neu“ in der Portfolio-Tabelle bedeutet null Klicks im vorherigen Zeitraum – für eine kürzlich gestartete Website ist das ein Start, keine Datenlücke.
- Überspringen Sie keine Suchanfragen in Sprachen, die Sie nicht lesen können. Bei Websites mit mehreren Märkten liegt das Wachstum normalerweise im nicht-englischen Long-Tail-Bereich; übersetzen Sie die interessanten, anstatt sie herauszufiltern.
- Eine Eigenschaft, die 403 zurückgibt, ist für die Auflistung, aber nicht für die Suchanalyse verifiziert. Das Skript meldet dies, anstatt es zu verstecken.
Hinweise
- GSC-Daten haben eine Verzögerung von etwa 3 Tagen; das Skript gleicht dies automatisch aus.
- Beide Zeiträume werden pro Eigenschaft parallel abgerufen, sodass ein Konto mit 40 Eigenschaften nur Sekunden dauert.
- Die Anzahl der Abfragezeilen ist auf 25.000 pro Zeitraum begrenzt, weit über dem, was eine einzelne Website in einem 28-Tage-Fenster zurückgibt.