pp-google-analytics — скилл для Claude Code и Codex
Скилл pp-google-analytics для Claude Code, Codex, Cursor и других агентов, который даёт им доступ к GA4 через бинарник google-analytics-pp-cli. Запускает отчёты по каналам, воронкам, доходу и аномалиям прямо из агентного контекста.
лицензия не указана 152 установок ★ 2 142 обновлён 2026-10-24
npx skills add mvanhorn/printing-press-library --skill pp-google-analytics -a claude-codeЧто делает pp-google-analytics
Во всех случаях он опирается на один бинарник — google-analytics-pp-cli, который нужно установить до первого вызова: либо через npx -y @mvanhorn/printing-press-library install google-analytics --cli-only --bin-dir ~/.local/bin, либо через Go 1.26.6 и выше. Если google-analytics-pp-cli --version возвращает «command not found», бинарник просто не виден в $PATH — агент откажется работать.
Авторизация строится на сервисном аккаунте Google: ключ передаётся флагом --credentials или через переменную GOOGLE_APPLICATION_CREDENTIALS. Свойство GA4 задаётся через --property или GA4_PROPERTY_ID. Есть именованные аккаунты — сохранить, переключить и удалить через auth add / set-default / remove. Важный нюанс: доступ через Google Cloud API и доступ к GA4-свойству — разные вещи. Если health показывает токен и admin OK, но конкретное свойство возвращает 403, причина в отсутствии роли Viewer внутри самого GA4-свойства, а не в ключе.
Команды агента охватывают каналы (channels), источники трафика (sources), топ страниц (top-pages), сравнение периодов (compare --period wow), детектор изменений (whats-changed), доход по каналам (revenue --by channel) и воронки (funnel --steps ...). Для нестандартных запросов есть низкоуровневые обёртки: report, pivot, batch, realtime и другие.
Какие задачи решает
- получить сводку по каналам приобретения за произвольный период
- построить воронку от просмотра товара до покупки по GA4-событиям
- сравнить сессии и доход за неделю к неделе
- обнаружить аномалии в трафике без ручного просмотра отчётов
- проверить доступность агента ко всем GA4-свойствам в парке
Примеры запросов агенту
- Покажи сводку по каналам трафика за последние 28 дней для свойства
GA4_PROPERTY_ID - Построй воронку по шагам
view_item,add_to_cart,begin_checkout,purchase - Сравни сессии и доход за текущую и прошлую неделю и выдели отклонения
Как установить pp-google-analytics
1Через Skills CLI (Vercel)
npx skills add mvanhorn/printing-press-library --skill pp-google-analytics -a claude-code2Вручную: положить файлы
~/.claude/skills/pp-google-analytics/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/pp-google-analytics/
1Через Skills CLI (Vercel)
npx skills add mvanhorn/printing-press-library --skill pp-google-analytics -a codex2Вручную: положить файлы
.agents/skills/pp-google-analytics/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add mvanhorn/printing-press-library --skill pp-google-analytics -a cursor2Вручную: положить файлы
.cursor/skills/pp-google-analytics/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install mvanhorn/printing-press-library cli-skills/pp-google-analytics/SKILL.md2Вручную: положить файлы
.github/skills/pp-google-analytics/SKILL.md1Через Skills CLI (Vercel)
npx skills add mvanhorn/printing-press-library --skill pp-google-analytics -a gemini-cli2Командой платформы
gemini skills install https://github.com/mvanhorn/printing-press-library --path cli-skills/pp-google-analyticsВручную: положить файлы
.devin/skills/pp-google-analytics/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add mvanhorn/printing-press-library --skill pp-google-analytics -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о pp-google-analytics
Как установить pp-google-analytics в Claude Code?
Выполните npx skills add mvanhorn/printing-press-library --skill pp-google-analytics -a claude-code. Скилл появится в ~/.claude/skills/pp-google-analytics/SKILL.md.
Что делает скилл pp-google-analytics?
Он учит агента вызывать google-analytics-pp-cli для получения данных из GA4: отчёты по каналам, воронки, сравнение периодов, поиск аномалий и проверка доступа к свойствам.
Почему health показывает OK, но команда по свойству возвращает 403?
Google Cloud API и GA4-свойство — отдельные системы прав. Сервисному аккаунту нужно выдать роль Viewer непосредственно внутри GA4-свойства — ротация ключа здесь не поможет.