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
Real data. Real impact.
Emerging
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
Install dependencies:
cd scripts && npm install
Configure credentials by creating a
.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
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" | |
| "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?" | |
Execute functions by importing from
scripts/src/index.tsimport { 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}/YYYYMMDD_HHMMSS__operation__extra_info.jsonAfter analysis, read the saved JSON files and create a markdown summary in
results/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 |
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 | | Days ago to today |
| Explicit | | Specific dates |
| GA4 relative | | GA4 relative format |
Default is
"30d"GA4_DEFAULT_DATE_RANGE.envResults auto-save to
results/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');
pagePathpageTitlesessionSourcesessionMediumcountrydeviceCategorybrowserdateeventNamelandingPagenewVsReturningscreenPageViewsactiveUserssessionsnewUsersbounceRateaverageSessionDurationengagementRateconversionstotalRevenueeventCountcompareDateRanges()liveSnapshot()No automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions
1,500+ AI skills, agents & workflows. Install in 30 seconds. Part of the Torly.ai family.
© 2026 Torly.ai. All rights reserved.