SeoToolkit/web-analytics-agent-skill

Web Analytics Skill

Dieser Skill ermöglicht es dem Agenten, Traffic-Daten von Google und Bing abzurufen und tiefgehende SEO-Analysen zu liefern.

Umgebungsvorbereitung

Die erforderlichen Skripte befinden sich im scripts/-Verzeichnis relativ zu dieser SKILL.md-Datei. Stellen Sie sicher, dass die folgenden Abhängigkeiten installiert sind:

python3 -m pip install -r scripts/gsc-requirements.txt

Erforderliche Anmeldeinformationen und wie man sie erhält

Bevor dieser Skill ausgeführt wird, muss die Umgebung konfiguriert sein. Falls der Benutzer nicht über die erforderlichen Anmeldeinformationen verfügt, sollte der Agent den Benutzer anleiten, diese mit den folgenden Schritten zu beschaffen:

1. Google OAuth-Client-Geheimnis (client_secret.json)

Der Agent benötigt eine Desktop-OAuth-2.0-Client-ID, um auf Google-APIs zuzugreifen. Anleitung für den Benutzer:

1. Gehen Sie zur Google Cloud Console.
2. Erstellen Sie ein neues Projekt oder wählen Sie ein vorhandenes aus.
3. Navigieren Sie zu APIs & Dienste > Bibliothek und aktivieren Sie die Google Search Console API und die Google Analytics Data API.
4. Navigieren Sie zu APIs & Dienste > OAuth-Zustimmungsbildschirm und konfigurieren Sie ihn (Sie können den Benutzertyp auf „Extern“ setzen und Ihre eigene E-Mail-Adresse als Testbenutzer hinzufügen).
5. Navigieren Sie zu APIs & Dienste > Anmeldedaten. Klicken Sie auf Anmeldedaten erstellen > OAuth-Client-ID.
6. Wählen Sie Desktop-App als Anwendungstyp.
7. Klicken Sie auf Erstellen und laden Sie die JSON-Datei herunter. Benennen Sie sie in client_secret.json um und platzieren Sie sie im scripts/-Verzeichnis dieses Skills.

2. Google OAuth-Tokens (token.json, google_analytics_token.json)

Diese werden automatisch vom Skript generiert.

• Agentenanweisung: Wenn die Skriptausgabe „Opening browser for authorization“ anzeigt, teilen Sie dem Benutzer mit, dass er auf seinem Computer nach einem neu geöffneten Browserfenster suchen und den Google OAuth-Login abschließen soll. Das Skript speichert die Token nach erfolgreichem Login automatisch lokal.

3. Bing-API-Schlüssel

Anleitung für den Benutzer:

1. Gehen Sie zu Bing Webmaster Tools.
2. Wählen Sie Ihre verifizierte Website aus.
3. Klicken Sie auf das Einstellungen-Zahnradsymbol oben rechts.
4. Gehen Sie zu API-Zugriff -> API-Schlüssel.
5. Klicken Sie auf API-Schlüssel generieren (oder kopieren Sie den vorhandenen).
6. Fügen Sie ihn in die .env-Datei als BING_API_KEY=ihr_schluessel_hier ein.

Ausführungsschritte

1. Google Search Console (GSC)-Daten sammeln

Führen Sie das GSC-Analyse-Skript aus, um Klicks, Impressionen, CTR und durchschnittliche Position zu erhalten:

cd scripts && python3 analyze_gsc.py

2. Google Analytics 4 (GA4)-Daten sammeln

Führen Sie das GA4-Skript aus, um Benutzersitzungen, Traffic-Quellen und Seitenaufrufe zu analysieren:

cd scripts && python3 ga4_both.py

3. Bing Webmaster Tools-Daten sammeln

Führen Sie das Bing-Skript aus, um die Bing-Suchleistung mit Google zu vergleichen:

export BING_API_KEY=$(grep BING_API_KEY ../../.env | cut -d '=' -f2)
cd scripts && python3 bing_webmaster.py

4. Erkenntnisse synthetisieren

Analysieren Sie die kombinierten Ausgaben und berichten Sie:

1. Trendanalyse: Steigt oder fällt der Gesamttraffic basierend auf dem 14-Tage-Zeitraum?
2. Plattformverhältnis: Wie hoch ist der Anteil des Bing-Traffics im Vergleich zu Google?
3. Keyword- und Seiten-Opportunitäten: Heben Sie Keywords mit hohen Impressionen, aber niedriger CTR hervor, oder Seiten, die bei Bing gut, aber bei Google schlecht abschneiden.

Fassen Sie die endgültige Zusammenfassung für den Benutzer in sauberem Markdown zusammen.