How do I install the Ga4 skill?

Run npx skillmds@latest add aaaaqwq/ga4 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

SkillMD's automated safety review verdict for this skill is CAUTION. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Ga4?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

aAAaqwq (@aaaaqwq) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Ga4 by aaaaqwq — Agent Skill

Name: Ga4
Rating: 4.2 (5 reviews)
Author: aAAaqwq

Ga4

Query Google Analytics 4 (GA4) data via the Analytics Data API. Use when you need to pull website analytics like top pages, traffic sources, user counts, sessions, conversions, or any GA4 metrics/dimensions. Supports custom date ranges and filtering.

aAAaqwq Updated Aug 19, 2026 1 repo stars

File contents

GA4 - Google Analytics 4 Data API

Query GA4 properties for analytics data: page views, sessions, users, traffic sources, conversions, and more.

Setup (one-time)

Enable Google Analytics Data API: https://console.cloud.google.com/apis/library/analyticsdata.googleapis.com
Create OAuth credentials or use existing Google Cloud project
Set environment variables:
- GA4_PROPERTY_ID - Your GA4 property ID (numeric, e.g., "123456789")
- GOOGLE_CLIENT_ID - OAuth client ID
- GOOGLE_CLIENT_SECRET - OAuth client secret
- GOOGLE_REFRESH_TOKEN - OAuth refresh token (from initial auth flow)

Safety Boundaries

This skill only connects to Google Analytics Data API endpoints.
It does NOT write to or modify your GA4 property — read-only queries only.
It does NOT store or transmit credentials beyond the current session.
It requires OAuth credentials (client ID, secret, refresh token) set as environment variables.

Common Queries

Top Pages (by pageviews)

python3 scripts/ga4_query.py --metric screenPageViews --dimension pagePath --limit 30

Top Pages with Sessions & Users

python3 scripts/ga4_query.py --metrics screenPageViews,sessions,totalUsers --dimension pagePath --limit 20

Traffic Sources

python3 scripts/ga4_query.py --metric sessions --dimension sessionSource --limit 20

Landing Pages

python3 scripts/ga4_query.py --metric sessions --dimension landingPage --limit 30

Custom Date Range

python3 scripts/ga4_query.py --metric sessions --dimension pagePath --start 2026-01-01 --end 2026-01-15

Filter by Page Path

python3 scripts/ga4_query.py --metric screenPageViews --dimension pagePath --filter "pagePath=~/blog/"

Available Metrics

Common metrics: screenPageViews, sessions, totalUsers, newUsers, activeUsers, bounceRate, averageSessionDuration, conversions, eventCount

Available Dimensions

Common dimensions: pagePath, pageTitle, landingPage, sessionSource, sessionMedium, sessionCampaignName, country, city, deviceCategory, browser, date

Output Formats

Default: Table format Add --json for JSON output Add --csv for CSV output

---name: ga4description: Query Google Analytics 4 (GA4) data via the Analytics Data API. Use when you need to pull website analytics like top pages, traffic sources, user counts, sessions, conversions, or any GA4 metrics/dimensions. Supports custom date ranges and filtering.---# GA4 - Google Analytics 4 Data APIQuery GA4 properties for analytics data: page views, sessions, users, traffic sources, conversions, and more.## Setup (one-time)1. Enable Google Analytics Data API: https://console.cloud.google.com/apis/library/analyticsdata.googleapis.com2. Create OAuth credentials or use existing Google Cloud project3. Set environment variables: - `GA4_PROPERTY_ID` - Your GA4 property ID (numeric, e.g., "123456789") - `GOOGLE_CLIENT_ID` - OAuth client ID - `GOOGLE_CLIENT_SECRET` - OAuth client secret - `GOOGLE_REFRESH_TOKEN` - OAuth refresh token (from initial auth flow)## Safety Boundaries- This skill only connects to Google Analytics Data API endpoints.- It does NOT write to or modify your GA4 property — read-only queries only.- It does NOT store or transmit credentials beyond the current session.- It requires OAuth credentials (client ID, secret, refresh token) set as environment variables.## Common Queries### Top Pages (by pageviews)```bashpython3 scripts/ga4_query.py --metric screenPageViews --dimension pagePath --limit 30```### Top Pages with Sessions & Users```bashpython3 scripts/ga4_query.py --metrics screenPageViews,sessions,totalUsers --dimension pagePath --limit 20```### Traffic Sources```bashpython3 scripts/ga4_query.py --metric sessions --dimension sessionSource --limit 20```### Landing Pages```bashpython3 scripts/ga4_query.py --metric sessions --dimension landingPage --limit 30```### Custom Date Range```bashpython3 scripts/ga4_query.py --metric sessions --dimension pagePath --start 2026-01-01 --end 2026-01-15```### Filter by Page Path```bashpython3 scripts/ga4_query.py --metric screenPageViews --dimension pagePath --filter "pagePath=~/blog/"```## Available MetricsCommon metrics: `screenPageViews`, `sessions`, `totalUsers`, `newUsers`, `activeUsers`, `bounceRate`, `averageSessionDuration`, `conversions`, `eventCount`## Available DimensionsCommon dimensions: `pagePath`, `pageTitle`, `landingPage`, `sessionSource`, `sessionMedium`, `sessionCampaignName`, `country`, `city`, `deviceCategory`, `browser`, `date`## Output FormatsDefault: Table formatAdd `--json` for JSON outputAdd `--csv` for CSV output

Frequently asked questions

Ga4