Communitygithub.com

HybridAIOne/hybridclaw

Führe produktive Google Analytics 4 Data API Reports mit Gateway-injizierter Bearer-Authentifizierung, sicherer Überprüfung von Anfragen, Traffic-Quellen-, Landingpage-, Zeitreihen-, Umsatz-, Sitzungs- und Schlüsselereignis-Berichten aus.

Was ist hybridclaw?

Diese Fähigkeit ermöglicht es KI-Agenten, mit Google Analytics 4 Berichte zu erstellen und abzurufen, indem sie die GA4 Data API nutzen. Sie unterstützt sowohl Sitzungen, Schlüsselereignisse, Umsatz als auch detaillierte Aufschlüsselungen nach Traffic-Quellen, Kanälen und Landingpages. Ein besonderes Merkmal ist die Möglichkeit, natürlichsprachliche Analystenanfragen in überprüfbare API-JSON-Payloads zu übersetzen und diese vor der Ausführung zu validieren. Die Fähigkeit ist für HybridClaw entwickelt und bietet zwei Authentifizierungsmodi: delegiertes OAuth über einen Bearer-Token und Service-Account-basierte JWT-Authentifizierung über das Gateway. Dadurch werden Anmeldeinformationen sicher im System gehalten und nicht dem Modell ausgesetzt. Der Workflow beginnt typischerweise mit der Planung eines Berichts aus natürlicher Sprache, gefolgt von der Überprüfung und schließlich der Ausführung über einen Gateway-Proxy oder ein integriertes `http_request`-Tool. Die Fähigkeit enthält auch einen umfassenden Evaluierungssatz mit 25 repräsentativen Analysten-Szenarien, die Korrektheit und Sicherheit in der Produktion gewährleisten.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/HybridAIOne/hybridclaw/tree/HEAD/skills/ga4
Original anzeigen→Alle Skills durchsuchen

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

Dokumentation

GA4

Nutze diese Fähigkeit für Google Analytics 4 Berichte über die Google Analytics Data API: Sitzungen, Schlüsselereignisse, Umsatz, Traffic-Quellen-Aufschlüsselungen, Landingpage-Aufschlüsselungen, Zeitreihenabfragen, Ad-hoc-Analysen, Dashboards, geplante Berichte, ETL und Überwachung.

Umfang

  • Ausführen von GA4 runReport-Anfragen für eine konfigurierte Property
  • Übersetzen typischer englischer Analystenanfragen in überprüfbare Data API-Payloads
  • Überprüfen von GA4-Anfrage-JSON vor der Ausführung
  • Erstellen von Berichten zu Traffic-Quellen, Kanalgruppen, Landingpages, täglichen Trends, Umsatz, Sitzungen, Benutzern und Schlüsselereignissen
  • Unterstützung von delegiertem OAuth und Service-Account-Authentifizierung über denselben Gateway-Bearer-Handle-Vertrag
  • Behalten der Auth-Modus-Auswahl in der Tenant-/Runtime-Konfiguration, nicht in der Prompt-Logik
  • Messen der Skill-Ausführungskosten über normale HybridClaw UsageTotals

Standard-Workflow

  1. Beginne mit report-plan für natürlichsprachliche Anfragen, es sei denn, der Benutzer hat bereits ein GA4 Data API-Anfrage-JSON bereitgestellt.
  2. Überprüfe generiertes oder vom Benutzer bereitgestelltes Anfrage-JSON mit review-request vor einem Live-Aufruf.
  3. Für Live-GA4-API-Aufrufe innerhalb von HybridClaw verwende http_request direkt, wenn verfügbar. Übergib das vom Helfer ausgegebene httpRequest-Objekt an das Tool.
  4. Verwende den Helfer für die Offline-Planung/Überprüfung und für die Gateway-proxierte Ausführung, wenn http_request nicht verfügbar ist: 
    python3 skills/ga4/scripts/ga4.py ...
  5. Behandle alle GA4-Operationen in dieser Fähigkeit als schreibgeschützt. Führe keine Admin-API-Mutationen, Property-Zugriffsänderungen, Schlüsselereignisänderungen oder Tag-Änderungen durch.

Auth-Vertrag

Die Fähigkeit unterstützt zwei Authentifizierungsmodi, ohne Tokens oder private Schlüssel gegenüber dem Modell offenzulegen:

  • Delegiertes OAuth über einen Bearer-Secret-Handle
  • Google Service-Account-JWT-Bearer-Austausch über das Gateway

Die Tenant-Konfiguration entscheidet, welcher Modus verwendet wird.

Standardmäßiges delegiertes OAuth-Handle:

hybridclaw auth login google \
  --client-id "<google-oauth-client-id>" \
  --client-secret "<google-oauth-client-secret>" \
  --account [email protected] \
  --scopes "https://www.googleapis.com/auth/analytics.readonly"

hybridclaw auth status google

Für delegiertes OAuth verwende den Standard bearerSecretName: "GOOGLE_WORKSPACE_CLI_TOKEN" oder eine google-oauth-URL-Auth-Route.

Für Service-Account-Automatisierung speichere die client_email und den PEM private_key des Service-Accounts als verschlüsselte Runtime-Geheimnisse. Das Gateway liest diese benannten Geheimnisse, signiert die JWT-Assertion serverseitig, tauscht sie gegen ein kurzlebiges Google-Zugriffstoken und injiziert dieses Token in die GA4-Anfrage.

Setze oder aktualisiere diese Geheimnisse in dieser Reihenfolge:

  1. Browser-Admin: Öffne die aktive HybridClaw-Admin-URL, die auf /admin/secrets endet.
  2. Browser /chat oder TUI-Fallback: /secret set GA4_SERVICE_ACCOUNT_EMAIL "<client-email>" und /secret set GA4_SERVICE_ACCOUNT_PRIVATE_KEY "<pem-private-key>".
  3. Lokaler Konsolen-Fallback:
hybridclaw secret set GA4_SERVICE_ACCOUNT_EMAIL "<client-email>"
hybridclaw secret set GA4_SERVICE_ACCOUNT_PRIVATE_KEY '<pem-private-key>'

Füge keine OAuth-Zugriffstokens, Refresh-Tokens, private Schlüssel von Service-Accounts oder heruntergeladene JSON-Schlüsseldateien in den Prompt ein. Echte Anmeldeinformationen bleiben in der HybridClaw-Secret-Runtime und werden serverseitig vom Gateway verwendet.

Optionale gespeicherte Standardwerte verwenden dieselbe Einrichtungsreihenfolge: Browser-Admin unter /admin/secrets, dann /secret set im Browser /chat oder TUI, dann lokaler Konsolen-Fallback.

hybridclaw secret set GA4_PROPERTY_ID "<numeric-property-id>"
hybridclaw secret set GA4_BEARER_SECRET_NAME "GOOGLE_WORKSPACE_CLI_TOKEN"

Für unbeaufsichtigte Service-Account-Aufgaben setze Umgebungsstandardwerte in der Tenant- Runtime:

GA4_SERVICE_ACCOUNT_EMAIL_SECRET=GA4_SERVICE_ACCOUNT_EMAIL
GA4_SERVICE_ACCOUNT_PRIVATE_KEY_SECRET=GA4_SERVICE_ACCOUNT_PRIVATE_KEY

Befehlsvertrag

Einen Bericht aus natürlicher Sprache planen:

python3 skills/ga4/scripts/ga4.py --format json report-plan \
  "Zeige mir letzte Woche die organischen Conversions im Vergleich zur Vorwoche"

Eine http_request-Payload für eine geplante oder handgeschriebene Anfrage erstellen:

python3 skills/ga4/scripts/ga4.py --format json http-request 123456789 \
  --request-json '{"dateRanges":[{"startDate":"7daysAgo","endDate":"yesterday"}],"dimensions":[{"name":"date"}],"metrics":[{"name":"sessions"}],"limit":25}'

Einen Bericht über den Gateway-Helper-Pfad ausführen:

python3 skills/ga4/scripts/ga4.py --format json run-report 123456789 \
  --request-json '{"dateRanges":[{"startDate":"7daysAgo","endDate":"yesterday"}],"metrics":[{"name":"sessions"}]}'

Service-Account-Auth verwenden, indem die gespeicherten Service-Account-Secret-Namen ausgewählt werden:

python3 skills/ga4/scripts/ga4.py --format json http-request 123456789 \
  --google-service-account-email-secret GA4_SERVICE_ACCOUNT_EMAIL \
  --google-service-account-private-key-secret GA4_SERVICE_ACCOUNT_PRIVATE_KEY \
  --request-json '{"dateRanges":[{"startDate":"7daysAgo","endDate":"yesterday"}],"metrics":[{"name":"sessions"}]}'

Anfrage-JSON offline überprüfen:

python3 skills/ga4/scripts/ga4.py --format json review-request \
  '{"dateRanges":[{"startDate":"30daysAgo","endDate":"yesterday"}],"dimensions":[{"name":"landingPagePlusQueryString"}],"metrics":[{"name":"sessions"},{"name":"totalRevenue"}],"limit":25}'

Die Analyst-Query-Prompt-Template-Payload ausgeben:

python3 skills/ga4/scripts/ga4.py --format json prompt-template \
  "Tägliche Sitzungen und Umsatz der letzten 30 Tage"

Das gebündelte Eval-Suite ausführen:

python3 skills/ga4/scripts/ga4.py --format json eval-scenarios

Arbeitsregeln

  • Verwende numerische GA4-Property-IDs. Akzeptiere properties/<id>-Eingabe, normalisiere sie jedoch vor API-Aufrufen.
  • Verwende keyEvents für Conversion-orientierte Berichte, es sei denn, der Benutzer fordert ausdrücklich eine benutzerdefinierte Ereignismetrik an.
  • Verwende sessionDefaultChannelGroup, sessionSourceMedium, landingPagePlusQueryString und date für die üblichen Produktions- Aufschlüsselungen, bevor du zu benutzerdefinierten Dimensionen greifst.
  • Füge ein Zeilenlimit hinzu. Standardmäßig 25 für Ad-hoc-Berichte und erhöhe es nur, wenn der Benutzer nach einem Export oder einem ETL-großen Ergebnis fragt.
  • Frage nach Klarstellung, wenn die Anfrage ein Quartal ohne Jahr nennt.
  • Füge dieser Fähigkeit keine Admin-API-Schreibvorgänge hinzu. Eine separate Admin-Fähigkeit würde explizite Genehmigungsstufen und Grenztests erfordern.

Eval-Suite

Die gebündelten Szenarien decken 25 repräsentative Analystenanfragen ab, darunter Sitzungen, Schlüsselereignisse, Umsatz, Traffic-Quellen, Landingpages, Zeitreihen, Vergleiche, E-Commerce, Geografie, Geräte und Sicherheits-/Klärungsfälle.

Verwandte Skills

steipete/sag

ElevenLabs text-to-speech with mac-style say UX.

community

steipete/oracle

Oracle CLI second-model review/debug/refactor/design with selected files, dry-run token checks, API or browser engine.

community

steipete/peekaboo

Capture and automate macOS UI with the Peekaboo CLI.

community

mattpocock/design-an-interface

Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".

community

mattpocock/prototype

Build a throwaway prototype to flesh out a design — a runnable terminal app for state/business-logic questions, or several radically different UI variations toggleable from one route.

community

mattpocock/grill-me

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

community