Google Analytics MCP
MCP-сервер GA4: агент читает отчеты Google Analytics 4, схему, данные реального времени и разбирает трафик по готовым методикам.
- 244 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Читает данные аналитики сайта, которые могут содержать сведения о посетителях, с правами сервисного аккаунта.
- Отправляет анонимную диагностику, если ее не отключить.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/google-analytics-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Читает данные аналитики сайта, которые могут содержать сведения о посетителях, с правами сервисного аккаунта.
- Отправляет анонимную диагностику, если ее не отключить.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агентам доступ к данным Google Analytics 4: открытие схемы измерений и метрик, агрегация на стороне сервера и готовые к анализу значения по умолчанию. Инструмент `get_ga4_data` строит многомерные отчеты с автоматическими итогами, `list_accounts` и `list_properties` перечисляют доступные аккаунты и ресурсы, `get_property_metadata` возвращает схему измерений и метрик с правилами совместимости, а `run_realtime_report` показывает активных пользователей и события за последние 30 минут. Три инструмента, `search_skills`, `skill_read` и `skills_list`, подгружают с GitHub аналитические методики: диагностику падения трафика, группировку каналов и атрибуцию, анализ электронной коммерции и отслеживание переходов из ChatGPT, Claude, Perplexity и Gemini. Для доступа нужны ID ресурса GA4 и ключ сервисного аккаунта Google Cloud.
Для кого. Маркетологам и аналитикам, которые разбирают трафик, каналы и конверсии GA4 вместе с агентом без ручных выгрузок.
Подходит, если
- Трафик резко упал, и агент проходит методику диагностики причин по каналам и страницам.
- Надо сравнить каналы привлечения и выручку по ним за квартал.
- Нужно понять, какую долю трафика дают переходы из ИИ-ассистентов.
- Перед отчетом проверяется, какие измерения и метрики совместимы в запросе.
Не подходит, если
- Нет ключа сервисного аккаунта с доступом к ресурсу GA4.
- Данные нужны из Universal Analytics или другой системы аналитики.
- Клиентская политика запрещает отправку обезличенной диагностики разработчику.
Пример запроса к агенту
Покажи каналы привлечения за последние 30 дней с сеансами и выручкой, а затем найди причину падения трафика на прошлой неделе.MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
GOOGLE_APPLICATION_CREDENTIALSобязательная, секрет- Путь к JSON-ключу сервисного аккаунта Google Cloud с доступом к GA4.
GA4_PROPERTY_IDобязательная- Числовой ID ресурса GA4.
Ограничения
Нужны ID ресурса GA4 (`GA4_PROPERTY_ID`) и путь к JSON-ключу сервисного аккаунта Google Cloud с доступом к ресурсу (`GOOGLE_APPLICATION_CREDENTIALS`). Пакет собирает анонимную диагностическую телеметрию без запросов и учетных данных: выполнение команд, задержки и коды ошибок. Отключают ее `DO_NOT_TRACK=1` или `MCP_TELEMETRY_OPT_OUT=1`. Методики подгружаются с GitHub динамически, поэтому их текст может меняться. В README есть установщик через `curl | bash`: читайте скрипт до запуска.
Как отключить. Удалите запись google-analytics из MCP-конфигурации (`claude mcp remove google-analytics`). Ключ сервисного аккаунта отзовите в Google Cloud и уберите доступ к ресурсу в GA4.
Частые вопросы
Как подключить GA4 MCP к Claude Code?
Выполните `claude mcp add google-analytics -- uvx google-analytics-mcp` и задайте `GA4_PROPERTY_ID` и `GOOGLE_APPLICATION_CREDENTIALS`. Для Claude Desktop те же переменные кладут в блок `env`.
Какой доступ нужен в Google?
Сервисный аккаунт Google Cloud, добавленный в нужный ресурс GA4 с правом чтения. Путь к его JSON-ключу передается в `GOOGLE_APPLICATION_CREDENTIALS`.
Что такое динамические методики?
Аналитические рецепты, которые сервер подгружает с GitHub: диагностика падения трафика, каналы и атрибуция, электронная коммерция, ИИ-рефералы. Их ищет `search_skills`, читает `skill_read`.
Какие данные доступны в реальном времени?
Инструмент `run_realtime_report` показывает активных пользователей и события за последние 30 минут с выбранными измерениями и метриками.
Собирает ли пакет телеметрию?
Да, анонимную и без запросов, учетных данных и персональных сведений. Отключите ее `DO_NOT_TRACK=1` или `MCP_TELEMETRY_OPT_OUT=1`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыЭкспериментальный официальный MCP-сервер Google Analytics 4: отчеты, воронки и данные реального времени по запросу агенту
Google, Meta Ads и GA4 MCP
Google + Meta Ads + GA4 MCP
Удаленный MCP-сервер для Google Ads, Meta Ads и Google Analytics 4 в одном подключении, вход по OAuth без API-ключей
Search Console MCP — данные Google, Bing и GA4 для агента
Search Console MCP
MCP-сервер дает агенту данные Google Search Console, Bing Webmaster, GA4 и AdSense с готовыми SEO-проверками
MCP сервер для Google Ads: разбор кампаний, метрик и ключевых слов через запросы GAQL прямо в диалоге с агентом
Google Search Console MCP
Google Search Console MCP Server for SEOs
MCP-сервер для Google Search Console: запросы и страницы с кликами и позициями, проверка индексации URL, сайтмапы и готовые SEO-скиллы
Suganthan's GSC MCP
Google Search Console MCP Server
29 инструментов Google Search Console для агента: быстрые победы, каннибализация, угасание контента, аудит картинок, индексация
Коротко о README
Пакет есть на PyPI (`google-analytics-mcp`) и в npm (`@surendranb/google-analytics-mcp`), портал документации находится на ga4mcp.com. Он поддерживает установку в Claude Desktop, Cursor, VS Code и другие клиенты.