pp-google-analytics — Claude Code skill: GA4 reports, funnels
pp-google-analytics is a Claude Code skill that connects agents to GA4 through google-analytics-pp-cli. It runs channel, funnel, revenue, period-comparison, and anomaly reports.
no license 152 installs ★ 2,142 updated 2026-10-24
npx skills add mvanhorn/printing-press-library --skill pp-google-analytics -a claude-codeWhat pp-google-analytics does
All of them go through the same binary — google-analytics-pp-cli — which must be present before any command runs. Install it with npx -y @mvanhorn/printing-press-library install google-analytics --cli-only --bin-dir ~/.local/bin, or via Go 1.26.6 or later if Node is unavailable. If google-analytics-pp-cli --version says “command not found”, the binary directory is not on $PATH and the skill will not proceed.
Authentication uses a Google service account key, passed via --credentials or GOOGLE_APPLICATION_CREDENTIALS. The GA4 property comes from --property or GA4_PROPERTY_ID. Named accounts can be stored and switched with auth add, auth set-default, and auth remove. One thing to be aware of: Google Cloud API access and GA4 property access are separate permission layers. When health reports the token and admin as OK but a property comes back 403, the service account is missing Viewer access inside that GA4 property — not a credential problem.
Agent-facing commands cover traffic channels (channels), source breakdown (sources), top pages (top-pages), week-over-week comparisons (compare --period wow), change detection (whats-changed), revenue by channel (revenue --by channel), and event funnels (funnel --steps ...).
What it helps with
- pull a GA4 acquisition-channel summary for any date range
- build a purchase funnel from view_item through to purchase using GA4 events
- compare sessions and revenue week over week and surface the deltas
- scan for traffic anomalies without opening the GA4 dashboard
- check agent access to every property in a fleet with a single health command
Example prompts for the agent
- Show me a channel breakdown for the last 28 days on property
$GA4_PROPERTY_ID - Build a funnel with steps
view_item,add_to_cart,begin_checkout,purchase - Compare sessions and total revenue for this week versus last week and flag what changed
How to install pp-google-analytics
1Skills CLI (Vercel)
npx skills add mvanhorn/printing-press-library --skill pp-google-analytics -a claude-code2Manually: put the files in place
~/.claude/skills/pp-google-analytics/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/pp-google-analytics/
1Skills CLI (Vercel)
npx skills add mvanhorn/printing-press-library --skill pp-google-analytics -a codex2Manually: put the files in place
.agents/skills/pp-google-analytics/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add mvanhorn/printing-press-library --skill pp-google-analytics -a cursor2Manually: put the files in place
.cursor/skills/pp-google-analytics/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install mvanhorn/printing-press-library cli-skills/pp-google-analytics/SKILL.md2Manually: put the files in place
.github/skills/pp-google-analytics/SKILL.md1Skills CLI (Vercel)
npx skills add mvanhorn/printing-press-library --skill pp-google-analytics -a gemini-cli2Platform CLI
gemini skills install https://github.com/mvanhorn/printing-press-library --path cli-skills/pp-google-analyticsManually: put the files in place
.devin/skills/pp-google-analytics/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add mvanhorn/printing-press-library --skill pp-google-analytics -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about pp-google-analytics
How do I install pp-google-analytics in Claude Code?
Run npx skills add mvanhorn/printing-press-library --skill pp-google-analytics -a claude-code. The skill file lands at ~/.claude/skills/pp-google-analytics/SKILL.md.
What does pp-google-analytics do?
It teaches an agent to drive google-analytics-pp-cli for live GA4 data: channel reports, funnels, period comparisons, anomaly detection, and property-access health checks.
The health command shows token OK but a property returns 403 — why?
Google Cloud API access and GA4 property access are separate. The service account needs Viewer access granted inside the GA4 property itself; rotating the key will not fix it.