ga4-multi-propertyGoogle 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.
Install via ClawdBot CLI:
clawdbot install ga4-multi-propertyInstall dependencies:
cd scripts && npm install
Configure credentials by creating a .env file in the project root:
GA4_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
Prerequisites: A Google Cloud project with the Analytics Data API, Search Console API, and Indexing API enabled. A service account with access to your GA4 property and Search Console.
| User says | Function to call |
|-----------|-----------------|
| "Show me site traffic for the last 30 days" | siteOverview("30d") |
| "What are my top search queries?" | searchConsoleOverview("30d") |
| "Who's on the site right now?" | liveSnapshot() |
| "Reindex these URLs" | reindexUrls(["https://example.com/page1", ...]) |
| "Compare this month vs last month" | compareDateRanges({startDate: "30daysAgo", endDate: "today"}, {startDate: "60daysAgo", endDate: "31daysAgo"}) |
| "What pages get the most traffic?" | contentPerformance("30d") |
Execute functions by importing from scripts/src/index.ts:
import { siteOverview, searchConsoleOverview } from './scripts/src/index.js';
const overview = await siteOverview('30d');
Or run directly with tsx:
npx tsx scripts/src/index.ts
Every analysis follows three phases:
Run API functions. Each call hits the Google APIs and returns structured data.
All results automatically save as timestamped JSON files to results/{category}/. File naming pattern: YYYYMMDD_HHMMSSoperationextra_info.json
After analysis, read the saved JSON files and create a markdown summary in results/summaries/ with data tables, trends, and recommendations.
| Function | Purpose | What it gathers |
|----------|---------|----------------|
| siteOverview(dateRange?) | Comprehensive site snapshot | Page views, traffic sources, demographics, events |
| trafficAnalysis(dateRange?) | Traffic deep-dive | Sources, sessions by source/medium, new vs returning |
| contentPerformance(dateRange?) | Top pages analysis | Page views, landing pages, exit pages |
| userBehavior(dateRange?) | Engagement patterns | Demographics, events, daily engagement metrics |
| compareDateRanges(range1, range2) | Period comparison | Side-by-side metrics for two date ranges |
| liveSnapshot() | Real-time data | Active users, current pages, current events |
| Function | Purpose | What it gathers |
|----------|---------|----------------|
| searchConsoleOverview(dateRange?) | SEO snapshot | Top queries, pages, device, country breakdown |
| keywordAnalysis(dateRange?) | Keyword deep-dive | Queries with device breakdown |
| seoPagePerformance(dateRange?) | Page SEO metrics | Top pages by clicks, country breakdown |
| Function | Purpose |
|----------|---------|
| reindexUrls(urls) | Request re-indexing for multiple URLs |
| checkIndexStatus(urls) | Check if URLs are indexed |
| Function | Purpose |
|----------|---------|
| getAvailableFields() | List all available GA4 dimensions and metrics |
For granular control, import specific functions from the API modules. See references/api-reference.md for the complete list of 30+ API functions with parameters, types, and examples.
All functions accept flexible date range formats:
| Format | Example | Description |
|--------|---------|-------------|
| Shorthand | "7d", "30d", "90d" | Days ago to today |
| Explicit | {startDate: "2024-01-01", endDate: "2024-01-31"} | Specific dates |
| GA4 relative | {startDate: "30daysAgo", endDate: "today"} | GA4 relative format |
Default is "30d" (configurable via GA4_DEFAULT_DATE_RANGE in .env).
Results auto-save to results/ with this structure:
results/
āāā reports/ # GA4 standard reports
āāā realtime/ # Real-time snapshots
āāā searchconsole/ # Search Console data
āāā indexing/ # Indexing API results
āāā summaries/ # Human-readable markdown summaries
import { 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');
pagePath, pageTitle, sessionSource, sessionMedium, country, deviceCategory, browser, date, eventName, landingPage, newVsReturning
screenPageViews, activeUsers, sessions, newUsers, bounceRate, averageSessionDuration, engagementRate, conversions, totalRevenue, eventCount
compareDateRanges() to spot trends (this month vs last month)liveSnapshot() shows who's on the site right nowGenerated Mar 1, 2026
An online retailer uses the skill to monitor daily traffic, analyze top-performing product pages, and track conversion rates. They run siteOverview and contentPerformance weekly to optimize marketing spend and identify high-bounce pages for improvement.
A digital marketing agency employs the skill to generate automated reports for clients, pulling data from Search Console and GA4. They use searchConsoleOverview and compareDateRanges to show progress in keyword rankings and traffic growth over time.
A media company utilizes liveSnapshot to monitor active users and popular articles during breaking news events. They combine this with userBehavior to understand audience demographics and adjust content strategy accordingly.
A software-as-a-service provider leverages the skill to analyze new user acquisition and engagement metrics. They run trafficAnalysis to identify effective referral sources and track bounce rates on sign-up pages to improve conversion funnels.
A small business with a physical location uses reindexUrls and checkIndexStatus to ensure new service pages are quickly indexed by search engines. They pair this with seoPagePerformance to monitor local search visibility and drive foot traffic.
A company integrates this skill into a SaaS platform offering automated SEO audits and traffic reports. They charge monthly fees for access to GA4 and Search Console insights, with premium tiers for advanced comparisons and real-time data.
A freelancer uses the skill to provide data-driven marketing consultations. They offer packages for one-time audits or ongoing management, leveraging the auto-save and summarize features to deliver polished reports to clients.
An online store incorporates the skill directly into its internal operations to monitor sales performance and customer behavior. It helps optimize ad campaigns and inventory planning, reducing reliance on external analytics tools.
š¬ Integration Tip
Ensure the Google Cloud service account has proper permissions across all required APIs and properties, and regularly update the .env file for multi-site setups to avoid authentication errors.
Quick system diagnostics: CPU, memory, disk, uptime
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, ses...
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.
Google Analytics API integration with managed OAuth. Manage accounts, properties, and data streams (Admin API). Run reports on sessions, users, page views, and conversions (Data API). Use this skill when users want to configure or query Google Analytics. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway).
Deploy privacy-first analytics with correct API patterns, rate limits, and GDPR compliance.
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.