Cookie-Einstellungen

Notwendige Cookies halten die Seite am Laufen. Analytics zeigt, welche Seiten nützlich sind. Die Wahl lässt sich jederzeit im Footer ändern.

Cookie-Richtlinie dieser Website – alle Details: Cookie-Kategorien, wie wir Ihre Auswahl im Browser speichern und wie Sie Ihre Einwilligung widerrufen.

Notwendig

Grundfunktionen der Seite und Ihre Einwilligung. Immer aktiv.

Analyse

Hilft zu verstehen, wie die Seite genutzt wird. Wird nur nach Ihrer Zustimmung geladen.

GitHubZIP herunterladen

GA4- und Yandex-Metrika-Daten

Seitenaufrufe und Traffic aus GA4 und Yandex Metrika auslesen und mit den Crawl-Befunden verknüpfen, damit Sie die Seiten korrigieren, die Besucher tatsächlich aufrufen. Beide Verbindungen sind nur lesend.

Auf GitHub ansehenSchnellstart

Was es leistet

  • SpiderHead im Terminal: seohead metrika-report

Yandex Metrika

metrika-counters findet die Counter-ID. metrika-setup zeigt Ziele, Filter und Datenoperationen, die Sie vor jeder Schlussfolgerung lesen sollten. metrika-report ruft danach die gewünschten Kennzahlen und Dimensionen ab, mit automatischer Paginierung.

  • Der Zugriff erfolgt über ein Yandex-OAuth-Token in YANDEX_METRIKA_TOKEN oder in seiner Token-Datei.
  • metrika-traffic-pdf erstellt einen Traffic-Bericht im A4-Format als HTML und PDF. Für das PDF braucht es einen lokalen Chrome, Edge oder Chromium.
  • Rohe Logs sind bewusst ausgeschlossen, weil sie Besucherkennungen enthalten.

Google Analytics 4

GA4 hat keinen eigenen CLI-Befehl. Sie erheben die Daten mit provider-collect, und zwar mit der Operation page_views für besuchte Seiten oder landing_pages für Einstiegsseiten. page_views zählt für die von Ihnen angegebene Property die screenPageViews nach Datum, Host und Pfad.

  • Der Zugriff erfolgt über ein GA4-Zugriffstoken (GA4_ACCESS_TOKEN) oder ein Google-Dienstkonto mit dem Scope analytics.readonly.
  • Das Konto braucht Leserechte für die Property.
  • Rohdaten landen in einem privaten lokalen Artefaktordner, nicht in der Tool-Antwort.

Mit dem Crawl verknüpfen

crawl-enrich ordnet eine Traffic-CSV mit URL-Schlüssel den gecrawlten URLs zu und ergänzt Analytics-Befunde. Dafür nutzt es die Spalten für Besuche und Absprungrate, die Sie angeben. Mit einem Projekt hält sources-sync eine tägliche Historie in einer lokalen SQLite-Datei vor, und sf run verknüpft sie offline mit den Audit-Seiten.

  • Verwaiste Seiten, Seiten ohne Daten und nicht indexierbare Seiten mit Traffic entstehen durch die Verknüpfung.
  • Übereinstimmende URLs, nur im Crawl gefundene und nur extern vorhandene URLs bleiben getrennte Grundgesamtheiten.
  • GA4- und Metrika-Zahlen werden nie zusammengerechnet.

Drei Schritte, ein gespeicherter Scan

  1. Zuerst die Counter-Einrichtung prüfen

    Führen Sie metrika-counters aus, um die Counter-ID zu finden, und danach metrika-setup, um Ziele, Filter und Datenoperationen zu sehen.

  2. Besuche und Seitenaufrufe abrufen

    metrika-report liest Yandex Metrika mit beliebigen Kennzahlen und Dimensionen. GA4-Seitenaufrufe kommen über provider-collect mit der GA4-Operation page_views.

  3. Zahlen mit dem Crawl verknüpfen

    crawl-enrich ordnet die Traffic-CSV den gecrawlten URLs anhand der URL zu und ergänzt Analytics-Befunde, einschließlich der Spalten für Besuche und Absprungrate.

Prüfungen in dieser Funktion

PrüfungBedeutungSchweregradBeleg
GA_ORPHAN_URLDie Analytics-Daten nennen eine URL derselben Domain, die der Crawl nicht gefunden hatImportantURL-Liste aus der Verknüpfung. Bei einem Teil-Crawl wird der Befund zurückgehalten
NON_INDEXABLE_WITH_GA_DATAEine nicht indexierbare Seite hat mehr als null BesucheImportantURL und Besuchszahl aus --visits-column
NO_GA_DATAEine indexierbare, gecrawlte Seite hat keine Analytics-ZeileTipURL-Liste. Prüfen Sie den gemessenen Zeitraum und das Analytics-Tagging, bevor Sie handeln
BOUNCE_RATE_ABOVE_70Die Absprungrate der Seite liegt über 70 %TipURL und Absprungrate aus --bounce-column

Ein Befehl

bash
seohead metrika-report --counter 12345678 --date1 2026-09-01 --date2 2026-09-30

Zuerst installieren: Installationsanleitung. Jeder Befehl läuft auch als MCP-Tool für KI-Agenten.

Was Sie brauchen

  • Yandex Metrika: eine Counter-ID und ein OAuth-Token
  • GA4: eine Property-ID sowie ein Zugriffstoken oder ein Dienstkonto mit analytics.readonly
  • Ein Datumsbereich
  • Ein Crawl oder Audit, plus eine Traffic-CSV, falls Sie crawl-enrich nutzen

Grenzen

  • Seitenaufrufe in GA4 sind keine Sitzungen, Nutzer oder Einstiegsseiten-Sitzungen und kein Beleg dafür, dass eine Änderung den Traffic verursacht hat.
  • GA4 liefert pro Lauf höchstens 100.000 Zeilen. Daten mit Schwellenwert oder Stichprobe werden gekennzeichnet.
  • Null Besuche können vom Tagging oder von Filtern stammen. Prüfen Sie daher zuerst metrika-setup.
  • Fehlende Zeilen sind keine gemessenen Nullwerte. Ein negativer Befund braucht einen vollständigen Crawl und eine vollständige Datenabdeckung durch den Anbieter.

Fragen

Verändert das meine Website oder meine Analytics-Einstellungen?
Nein. Jeder Aufruf ist nur lesend. metrika-setup zeigt nur an, wie ein Counter eingerichtet ist. Gespeicherte Belege bleiben in einem lokalen Ordner.
Welchen Zugriff brauche ich?
Für Metrika ein Yandex-OAuth-Token in der Einstellung YANDEX_METRIKA_TOKEN oder in seiner Token-Datei. Für GA4 ein GA4_ACCESS_TOKEN oder ein Dienstkonto mit dem Scope analytics.readonly und Leserechten für die Property.
Warum ist eine Seite mit null Besuchen nicht immer ein Problem?
Null kann von der Einrichtung stammen. Ohne Ziele oder Filter können die Zahlen unvollständig sein. Prüfen Sie metrika-setup, bevor Sie aus dem Traffic Schlüsse ziehen.
Liest das Tool rohe Besucherprotokolle?
Nein. Rohe Metrika-Logs sind absichtlich ausgeschlossen, weil sie Besucherkennungen enthalten. Das Tool nutzt nur aggregierte Berichte.
Was kostet das?
SpiderHead berechnet für diese Befehle nichts. Die Aufrufe zählen auf die API-Kontingente Ihres eigenen Kontos bei Metrika und GA4.
Was wird auf meinem Rechner gespeichert?
GA4-Rohdaten landen in einem privaten Artefaktordner, den Sie wählen. sources-sync schreibt die tägliche Historie in eine SQLite-Datei des Projekts, ohne Tokens zu speichern. metrika-report gibt sein Ergebnis aus. Speichern Sie es selbst, wenn Sie es brauchen.

Weiterstöbern

Aus Blog und Glossar

GA4 für SEO: Berichte, Kennzahlen und praktische AnwendungBlogYandex MetricaGlossar

Mehr in dieser Gruppe · Datenquellen

Integration der Google Search ConsoleFunktionIntegration Yandex WebmasterFunktionCrUX-Bericht zu Core Web VitalsFunktionServer-Logfile-AnalyseFunktionBacklink-Checker für bekannte LinkgeberFunktionTool für den semantischen KernFunktion

Testen Sie es auf Ihrer eigenen Website

ZIP herunterladenAlle Funktionen