Loading...
Loading...
Google Analytics 4, Search Console, and Indexing API toolkit. Analyze website traffic, page performance, user demographics, real-time visitors, search queries, and SEO metrics. Use when the user asks to: check site traffic, analyze page views, see traffic sources, view user demographics, get real-time visitor data, check search console queries, analyze SEO performance, request URL re-indexing, inspect index status, compare date ranges, check bounce rates, view conversion data, or get e-commerce revenue. Requires a Google Cloud service account with GA4 and Search Console access.
npx skill4agent add mmcmedia/openclaw-agents ga4-analyticscd scripts && npm install.envGA4_PROPERTY_ID=123456789
GA4_CLIENT_EMAIL=service-account@project.iam.gserviceaccount.com
GA4_PRIVATE_KEY="-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n"
SEARCH_CONSOLE_SITE_URL=https://your-domain.com
GA4_DEFAULT_DATE_RANGE=30d| User says | Function to call |
|---|---|
| "Show me site traffic for the last 30 days" | |
| "What are my top search queries?" | |
| "Who's on the site right now?" | |
| "Reindex these URLs" | |
| "Compare this month vs last month" | |
| "What pages get the most traffic?" | |
scripts/src/index.tsimport { siteOverview, searchConsoleOverview } from './scripts/src/index.js';
const overview = await siteOverview('30d');npx tsx scripts/src/index.tsresults/{category}/YYYYMMDD_HHMMSS__operation__extra_info.jsonresults/summaries/| Function | Purpose | What it gathers |
|---|---|---|
| Comprehensive site snapshot | Page views, traffic sources, demographics, events |
| Traffic deep-dive | Sources, sessions by source/medium, new vs returning |
| Top pages analysis | Page views, landing pages, exit pages |
| Engagement patterns | Demographics, events, daily engagement metrics |
| Period comparison | Side-by-side metrics for two date ranges |
| Real-time data | Active users, current pages, current events |
| Function | Purpose | What it gathers |
|---|---|---|
| SEO snapshot | Top queries, pages, device, country breakdown |
| Keyword deep-dive | Queries with device breakdown |
| Page SEO metrics | Top pages by clicks, country breakdown |
| Function | Purpose |
|---|---|
| Request re-indexing for multiple URLs |
| Check if URLs are indexed |
| Function | Purpose |
|---|---|
| List all available GA4 dimensions and metrics |
| Format | Example | Description |
|---|---|---|
| Shorthand | | Days ago to today |
| Explicit | | Specific dates |
| GA4 relative | | GA4 relative format |
"30d"GA4_DEFAULT_DATE_RANGE.envresults/results/
├── reports/ # GA4 standard reports
├── realtime/ # Real-time snapshots
├── searchconsole/ # Search Console data
├── indexing/ # Indexing API results
└── summaries/ # Human-readable markdown summariesimport { listResults, loadResult, getLatestResult } from './scripts/src/index.js';
// List recent results
const files = listResults('reports', 10);
// Load a specific result
const data = loadResult(files[0]);
// Get most recent result for an operation
const latest = getLatestResult('reports', 'site_overview');pagePathpageTitlesessionSourcesessionMediumcountrydeviceCategorybrowserdateeventNamelandingPagenewVsReturningscreenPageViewsactiveUserssessionsnewUsersbounceRateaverageSessionDurationengagementRateconversionstotalRevenueeventCountcompareDateRanges()liveSnapshot()