openclaw/skills/ga4/SKILL.md
kiranjd 7e784d6a88 feat(skills): add ga4 and lemonsqueezy CLI skills
- ga4: Query GA4 analytics - users, events, funnels, transcriptions
- lemonsqueezy: Query revenue, orders, subscriptions, customers

Both use bun scripts and require env vars for auth.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-27 21:43:59 +05:30

3.5 KiB

name description homepage metadata
ga4 GA4 Analytics CLI for users, events, funnels, and transcription metrics. https://analytics.google.com
clawdbot
emoji requires primaryEnv
📊
bins env
bun
GOOGLE_APPLICATION_CREDENTIALS
GOOGLE_APPLICATION_CREDENTIALS

GA4 Analytics CLI

Query Google Analytics 4 data - users, events, funnels, transcription metrics.

Setup

Set environment variables:

export GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json
export GA4_PROPERTY_ID=510572418  # Optional, defaults to Speakmac

Or configure in ~/.clawdbot/clawdbot.json:

{
  "skills": {
    "entries": {
      "ga4": {
        "env": {
          "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/service-account.json",
          "GA4_PROPERTY_ID": "510572418"
        }
      }
    }
  }
}

Commands

Overview

bun {baseDir}/scripts/cli.ts overview                  # 30-day overview
bun {baseDir}/scripts/cli.ts overview --period 7d      # Last 7 days

Real-time

bun {baseDir}/scripts/cli.ts realtime                  # Active users now

Events

bun {baseDir}/scripts/cli.ts events                    # Top 50 events
bun {baseDir}/scripts/cli.ts events --limit 20         # Limit results
bun {baseDir}/scripts/cli.ts events --period 7d

Funnels

bun {baseDir}/scripts/cli.ts funnel onboarding         # Onboarding completion
bun {baseDir}/scripts/cli.ts funnel transcription      # Transcription success
bun {baseDir}/scripts/cli.ts funnel permissions        # Permission grants

Errors

bun {baseDir}/scripts/cli.ts errors                    # All errors (7d)
bun {baseDir}/scripts/cli.ts errors --type transcription
bun {baseDir}/scripts/cli.ts errors --type license
bun {baseDir}/scripts/cli.ts errors --period 14d

Transcription Metrics

bun {baseDir}/scripts/cli.ts transcriptions            # By provider
bun {baseDir}/scripts/cli.ts transcriptions --by day   # Daily breakdown
bun {baseDir}/scripts/cli.ts transcriptions --period 14d

Version Adoption

bun {baseDir}/scripts/cli.ts versions                  # App version usage
bun {baseDir}/scripts/cli.ts versions --period 7d

Growth Metrics

bun {baseDir}/scripts/cli.ts growth                    # Growth trends
bun {baseDir}/scripts/cli.ts growth --period 90d

Weekly (Date Range)

bun {baseDir}/scripts/cli.ts weekly --from 2025-11-01 --to 2026-01-20

Custom Query

bun {baseDir}/scripts/cli.ts query --dimensions week --metrics activeUsers,sessions --from 2025-11-01 --to 2026-01-20
bun {baseDir}/scripts/cli.ts query --dimensions date --metrics eventCount --period 30d

Periods

  • today - Current day
  • yesterday - Previous day
  • 7d - Last 7 days
  • 14d - Last 14 days
  • 28d - Last 28 days
  • 30d - Last 30 days (default)
  • 90d - Last 90 days

Examples

# Daily check-in
bun {baseDir}/scripts/cli.ts overview --period 7d
bun {baseDir}/scripts/cli.ts realtime

# Feature usage
bun {baseDir}/scripts/cli.ts events --limit 20

# Onboarding health
bun {baseDir}/scripts/cli.ts funnel onboarding

# Transcription performance
bun {baseDir}/scripts/cli.ts transcriptions --by provider
bun {baseDir}/scripts/cli.ts errors --type transcription

# Version rollout
bun {baseDir}/scripts/cli.ts versions --period 7d

Notes

  • Service account needs "Viewer" role on GA4 property
  • Real-time data shows last 30 minutes
  • See {baseDir}/docs/API_REFERENCE.md for full API documentation