К основному содержанию
скилл CX Codex

google-analytics · acedatacloud — скилл для Claude Code: отчёты GA4 и установка

Скилл для Claude и других агентов: тянет отчёты Google Analytics 4 и список свойств через Analytics API, работая из оболочки на curl и jq.

Apache-2.0 177 установок ★ 17 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add AceDataCloud/Skills --skill google-analytics -a claude-code
Открыть на GitHub

Что делает google-analytics

Скилл превращает вопрос про трафик в запросы к Google Analytics 4. Сначала он находит свойства через Admin API (analyticsadmin.googleapis.com/v1beta), потом гоняет отчёты через Data API (analyticsdata.googleapis.com/v1beta). Всё делается в оболочке: curl плюс jq, из инструментов разрешён только Bash.

Каждый вызов несёт заголовок Authorization: Bearer $GOOGLE_ANALYTICS_TOKEN. Токен нужен с областью analytics.readonly, и без него в окружении не пройдёт ни один запрос. Ошибки приходят в виде {"error":{"code","message","status"}} и показываются как есть, а 401 значит, что токен пора переустановить.

Отчёт по умолчанию ограничен 10k строк, дальше листается через offset. Имена метрик берутся из списка GA4 (screenPageViews, а не «Pageviews»), старые эндпоинты analytics/v3 не используются.

Какие задачи решает

  • вытащить топ страниц по просмотрам за 28 дней
  • посмотреть, какие каналы принесли сессии
  • сосчитать активных пользователей по странам
  • узнать, кто на сайте прямо сейчас, через realtime-отчёт
  • найти numeric id нужного свойства GA4

Примеры запросов агенту

  • Покажи топ-10 страниц по просмотрам и активным пользователям за последние 28 дней по свойству 123456789.
  • Сколько людей на сайте прямо сейчас? Сделай realtime-отчёт по странам.
  • Найди мои свойства GA4 и подскажи numeric id нужного.

Как установить google-analytics

1Через Skills CLI (Vercel)

npx skills add AceDataCloud/Skills --skill google-analytics -a claude-code

2Вручную: положить файлы

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

Папка скилла целиком; для одного проекта — .claude/skills/google-analytics/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о google-analytics

Как установить google-analytics в Claude Code?

Выполните npx skills add AceDataCloud/Skills --skill google-analytics -a claude-code. Скилл окажется по пути ~/.claude/skills/google-analytics/SKILL.md.

Что делает google-analytics?

Запрашивает отчёты GA4 через Analytics Data API v1 и перечисляет свойства через Admin API. Работает в режиме чтения, с областью analytics.readonly.

Подойдёт ли скилл для Universal Analytics?

Нет, он рассчитан на GA4 и Data API v1, а легаси-эндпоинты analytics/v3 не трогает. Для работы нужен токен в переменной $GOOGLE_ANALYTICS_TOKEN.

Исходный текст

SKILL.md · Apache-2.0
---
name: google-analytics
description: Query Google Analytics 4 (GA4) reports via the Analytics Data API v1 and list properties via the Admin API. Use when the user mentions Google Analytics, GA4, website traffic / sessions / users, top pages or sources, conversions, or a realtime report.
when_to_use: |
  Trigger when the user wants GA4 metrics — sessions, users, top
  pages / channels / countries, conversions, or live realtime users —
  for one of their GA4 properties. Read-only (`analytics.readonly`).
  List properties first to get the numeric property id.
connections: [google/analytics]
allowed_tools: [Bash]
license: Apache-2.0
metadata:
  author: acedatacloud
  version: "1.0"
---

Query **Google Analytics 4** via `curl + jq`. The user's OAuth bearer token is in
`$GOOGLE_ANALYTICS_TOKEN` (scope `analytics.readonly`); every call needs
`Authorization: Bearer $GOOGLE_ANALYTICS_TOKEN`. Two APIs: the **Admin API**
(`analyticsadmin.googleapis.com/v1beta`) to discover properties, and the **Data
API** (`analyticsdata.googleapis.com/v1beta`) to run reports.

Failures are `{"error":{"code","message","status"}}` — show verbatim. `401` =
re-install.

```bash
AUTH="Authorization: Bearer $GOOGLE_ANALYTICS_TOKEN"
# List the GA4 properties the user can access (via their account summaries)
curl -sS -H "$AUTH" "https://analyticsadmin.googleapis.com/v1beta/accountSummaries" \
  | jq '.accountSummaries[]?.propertySummaries[]? | {property, displayName}'
```

`property` looks like `properties/123456789` — the number is the `PROPERTY_ID`.

## Run a report

```bash
PID="123456789"
curl -sS -X POST -H "$AUTH" -H "Content-Type: application/json" -d '{
  "dateRanges":[{"startDate":"28daysAgo","endDate":"today"}],
  "dimensions":[{"name":"pagePath"}],
  "metrics":[{"name":"screenPageViews"},{"name":"activeUsers"}],
  "orderBys":[{"metric":{"metricName":"screenPageViews"},"desc":true}],
  "limit":10
}' "https://analyticsdata.googleapis.com/v1beta/properties/$PID:runReport" \
  | jq '.rows[] | {page: .dimensionValues[0].value, views: .metricValues[0].value, users: .metricValues[1].value}'
```

Swap dimensions/metrics for other reports: `sessionDefaultChannelGroup` +
`sessions` (acquisition), `country` + `activeUsers` (geo), `eventName` +
`eventCount` / `conversions` (events). Dates accept `NdaysAgo`, `today`,
`yesterday`, or `YYYY-MM-DD`.

## Realtime

```bash
curl -sS -X POST -H "$AUTH" -H "Content-Type: application/json" \
  -d '{"dimensions":[{"name":"country"}],"metrics":[{"name":"activeUsers"}]}' \
  "https://analyticsdata.googleapis.com/v1beta/properties/$PID:runRealtimeReport" | jq '.rows'
```

## Gotchas

- This is **GA4 only** (Data API v1). Old Universal Analytics (UA) is shut down —
  don't use the legacy `analytics/v3` endpoints.
- Valid dimension/metric API names matter (`screenPageViews`, not "Pageviews").
  If a name 400s, it's the wrong API id — check the GA4 dimensions & metrics list.
- Reports are capped by `limit` (default 10k rows); page with `offset`.

© acedatacloud · Apache-2.0 · AceDataCloud/Skills

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →

Сначала — google-analytics от других авторов.

google-analytics OpenClaudia Подключает Google Analytics Data API и позволяет агенту запрашивать GA4-отчёты прямо из чата. CX Codex +1 539установок pp-google-analytics mvanhorn Скилл pp-google-analytics для Claude Code, Codex, Cursor и других агентов, который даёт им доступ к GA4 через бинарник google-analytics-pp-cli. Запускает отчёты по каналам, воронкам, доходу и аномалиям прямо из агентного контекста. CX Codex +1 152установок google-analytics-automation davepoon Скилл google-analytics-automation автоматизирует выгрузку отчётов и управление ресурсами Google Analytics 4 через сервер Rube MCP. CX Codex +1 130установок anacraft — Google Analytics 4 anacrafterdev anacraft — Google Analytics 4 — MCP-сервер для Claude Code, который подключает ассистента к Google Analytics 4 и отвечает на вопросы о трафике, страницах и событиях. CX Codex +1 ★ 1звёзд репо QuerySail: Google Analytics querysail QuerySail: Google Analytics — MCP-сервер для Claude Code, подключающий Google Analytics 4 к ИИ-агенту для вопросов о трафике, сравнении периодов и realtime-данных без API-ключей. CX Codex +1 Google Analytics 4 get-mcp-ads MCP-сервер Google Analytics 4 даёт агенту доступ к отчётам GA4, воронкам и настройкам ресурсов в режиме чтения. Пригодится, чтобы изучать аналитику из Claude Code. CX Codex +1 google-analytics-mcp surendranb MCP-сервер подключает Claude Code к Google Analytics 4 для изучения схемы данных и составления отчётов. Анализирует трафик, каналы и конверсии. CX Codex +1 ★ 243звёзд репо

Из того же набора67

Весь набор →
google-sheets Скилл читает и изменяет Google Sheets через Sheets v4 REST API. Он пригодится для работы с ячейками, диапазонами, вкладками и строками из чата с агентом. CX Codex +1 179установок juejin Скилл ведёт ваш аккаунт на Juejin через собственные cookie: показывает статьи с просмотрами и лайками, открывает одну по id и публикует Markdown-черновик. CX Codex +1 179установок microsoft-teams Даёт агенту чтение и отправку сообщений в чатах Microsoft Teams через Microsoft Graph v1.0: список чатов, последние сообщения, отправка с подтверждением. CX Codex +1 178установок tiktok Публикует готовые видео в профиль TikTok или загружает их в черновики через API v2. Скилл запрашивает подтверждение настроек приватности перед каждой отправкой. CX Codex +1 178установок google-ads Запрашивает через Google Ads API кампании, группы объявлений, ключевые слова и расходы. Получает данные о кликах и конверсиях для отчётов. CX Codex +1 177установок vercel Скилл проверяет сборки, читает логи ошибок и управляет доменами на Vercel через REST API прямо из чата с агентом. CX Codex +1 176установок bilibili Скилл читает статистику статей в Bilibili и помогает публиковать новые через ваш аккаунт. Для работы нужны cookies входа. CX Codex +1 175установок figma Читает файлы Figma через REST API: дерево документа, отдельные ноды, рендер в PNG и комментарии. Запускается при переводе макета в код. CX Codex +1 175установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой