Yandex Metrica MCP

MCP server for Yandex Metrica web analytics — counters, goals, and traffic/conversion statistics. Read-only.

Яндекс Метрика MCPподключает AI-приложение к веб-аналитике сайта. Спросите на естественном языке, откуда приходят посетители, как меняется конверсия или где растёт доля отказов — ассистент возьмёт данные из вашего счётчика и объяснит результат. Подключение начинается прямо в диалоге: не нужно заранее создавать токен или редактировать конфигурацию.

- Восемь инструментов.Счётчики, цели и отчёты Метрики, подключение и отключение доступа, а также один универсальный запрос к API.
- Отчёты и конверсии.Визиты, пользователи, просмотры, отказы, длительность визита, источники, устройства и цели за выбранный период.
- Подключение в чате.Яндекс откроет страницу входа; одноразовый код действует 10 минут, а сервер проверит доступ к счётчикам сразу после подключения.
- Обычные запросы — только чтение.Специализированные инструменты не меняют счётчики, цели или данные Метрики.
- Без молчаливого обрезания.В отчёте видны итоговые значения и признак выборки; при большой выдаче сервер отмечает, если упёрся в лимит.

Сколько визитов, пользователей и отказов было у моего сайта за последнюю неделю?

Подключить сервер·Посмотреть сценарии·Открыть техническую документацию

- Быстрый старт
- Что можно поручить
- Как это работает
- Что может изменить данные
- Подключение и настройка
- Данные и телеметрия
- Ограничения
- Техническая документация
- Поддержка

codex mcp add yandex-metrica -- npx -y mcp-yandex-metrica@latest

claude mcp add --transport stdio --scope user yandex-metrica -- npx -y mcp-yandex-metrica@latest

{ "mcpServers": { "yandex-metrica": { "command": "npx", "args": ["-y", "mcp-yandex-metrica@latest"] } } }

После сохранения откройте новый диалог и попросите подключить Метрику.

Для всех проектов создайте~/.cursor/mcp.json; только для текущего проекта —.cursor/mcp.json:

{ "mcpServers": { "yandex-metrica": { "command": "npx", "args": ["-y", "mcp-yandex-metrica@latest"] } } }

В чате Cursor сервер появится среди доступных инструментов. Попросите подключить Метрику и пройдите вход через Яндекс.

Откройте палитру команд и выполнитеMCP: Open User Configuration. Добавьте вmcp.json:

{ "servers": { "yandex-metrica": { "type": "stdio", "command": "npx", "args": ["-y", "mcp-yandex-metrica@latest"] } } }

Проверьте запуск командойMCP: List Servers, затем откройте чат и попросите подключить Метрику.

- «Сколько было визитов, пользователей и просмотров за последнюю неделю?»
- «Покажи динамику посещаемости по дням за июнь».
- «На каких устройствах доля отказов выше?»

Найти источник трафика и оценить его качество

- «Покажи источники трафика за месяц и отсортируй по визитам».
- «Сравни органический поиск и рекламу по пользователям и отказам».
- «Какие источники дали больше всего переходов на этой неделе?»

- «Какие цели настроены в счётчике?»
- «Какая конверсия по цели „Оформление заказа“ за 30 дней?»
- «Покажи источники, которые принесли больше всего достижений цели».

- «Какие счётчики мне доступны?»
- «Покажи статус подключения к Метрике».
- «Данные в этом отчёте точные или Метрика использовала выборку?»

Сервер работает с тремя привычными сущностями:

Обычно ассистент сначала находит доступный счётчик, затем — при необходимости — цель, и только после этого строит отчёт. В ответе Метрики есть итог по всем строкам, размер выдачи и признак выборки.

Сервер помечает произвольную запись как потенциально разрушительное действие. Как именно AI-приложение запрашивает подтверждение, зависит от самого приложения; перед таким запросом проверьте путь, метод и данные.

Для обычного использования токен заранее не нужен:
- В чате попросите подключить Яндекс Метрику.
- Откройте ссылку на Яндекс OAuth под аккаунтом с доступом к нужным счётчикам.
- Подтвердите доступ и пришлите код ассистенту. Он действует 10 минут и меняется на токен только внутри работающего сервера.

Сервер использует PKCE: код из чата сам по себе нельзя обменять на токен. Полученный токен хранится локально в~/.config/mcp-yandex-metrica/credentials.jsonс правами только для владельца. При сохранённом refresh-токене доступ продлевается автоматически.

Для CI и нестандартных установок доступна настройка через переменные окружения:

Если используете собственное OAuth-приложение, запросите в нём право«Получение статистики, чтение параметров своих и доверенных счётчиков»(metrika:read).

По умолчанию сервер отправляет анонимную техническую телеметрию: случайный идентификатор установки, имя события или инструмента, версию сервера, версию Node.js, ОС и сведения о подключившемся AI-клиенте. В неё не попадают токен, данные счётчиков, аргументы инструментов, ваши сообщения и значения переменных окружения.

Чтобы отключить телеметрию для MCP-серверов Ask Ads, задайте переменную окружения:

- Выборка Метрики.На больших периодах или сложных отчётах API может вернуть приблизительные данные. Смотрите поляsampledиsample_share; для более точного расчёта сузьте период или используйтеaccuracy: "full".
- Размер отчёта.Один запрос возвращает до 10 000 строк. Автоматическая пагинация останавливается не более чем на 100 страницах, 100 000 строках или примерно 1 МБ данных и помечает неполный ответ полем_truncated.
- Повторы запросов.Таймаут одного запроса — 60 секунд. Сервер делает до трёх повторов при временной ошибке:GET— при сетевой ошибке,429и5xx;POSTиDELETE— только при429, чтобы не повторить изменяющее действие. Задержка учитываетRetry-Afterи не превышает 30 секунд.
- Боевые данные.У Метрики нет песочницы. Специализированные инструменты читают данные, ноPOSTиDELETEчерез произвольный запрос меняют реальные объекты.
- Нет фонового наблюдения.Сервер работает, когда его вызывает AI-приложение, и сам не следит за показателями. Если приложение поддерживает запланированные задания, можно настроить в нём периодический запрос отчёта.

- Каталог MCP-возможностей— страницы по пользовательским задачам для каждого инструмента.
- Все инструменты— параметры, ответы и границы каждого инструмента.
- Документация по разработке— устройство проекта и работа с демо.
- Пакет в npm.
- API Яндекс Метрики.

Нашли ошибку или не хватает сценария?Создайте issueили напишите вTelegram.

App Store stats, installs, keywords, revenue and descriptions. B2B intelligence for SDK analysis, ad tech stacks and more.