Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add mvanhorn/printing-press-library --skill pp-google-analytics -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/pp-google-analytics/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/pp-google-analytics/

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.

Similar skills

All skills for Marketing and content →

From the same set87

The whole set →

Project sponsors

Companies that keep this analytics open