ga4-analytics-search-indexing-skillGoogle 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 samiralibabic/ga4-analytics-search-indexing-skillInstall 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 this skill to monitor daily traffic, analyze top-performing product pages, and track conversion rates. They compare weekly sales periods to optimize marketing campaigns and identify drop-off points in the user journey.
A media company employs the skill to track search query rankings, analyze page views for articles, and request re-indexing of updated content. They assess bounce rates and user demographics to tailor content strategies and improve engagement.
A software-as-a-service provider utilizes the skill to monitor real-time active users, analyze traffic sources for new sign-ups, and compare monthly engagement metrics. They identify high-value user segments and optimize onboarding flows based on behavior data.
A digital marketing agency leverages the skill to generate automated reports for multiple client websites, comparing date ranges to show campaign impact. They use SEO performance data and traffic sources to provide actionable recommendations and demonstrate ROI.
A non-profit organization applies the skill to track visitor demographics, analyze donation page performance, and monitor search console queries for awareness campaigns. They assess bounce rates and user behavior to enhance outreach and engagement strategies.
Companies offering analytics tools or platforms can integrate this skill to provide clients with automated GA4 and Search Console insights. It enhances their product by enabling real-time data pulls and period comparisons, driving recurring revenue through premium features.
Agencies use this skill to streamline client reporting and SEO audits, reducing manual data collection. By automating traffic analysis and indexing requests, they can scale services, offer data-driven strategies, and charge for comprehensive analytics packages.
Online retailers integrate the skill directly into their dashboards to monitor sales funnels and user behavior. It helps optimize product pages, track revenue metrics, and compare promotional periods, leading to increased conversions and average order value.
š¬ Integration Tip
Ensure the Google Cloud service account has proper permissions across all GA4 properties and Search Console sites, and regularly update environment variables for multi-property setups to avoid API 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.
YouTube Data API v3 analytics toolkit. Analyze YouTube channels, videos, and search results. Use when the user asks to: check YouTube channel stats, analyze video performance, compare channels, search for videos, get subscriber counts, view engagement metrics, find trending videos, get channel uploads, or analyze YouTube competition. Requires a YouTube Data API v3 key from Google Cloud Console.