A1 инженерная AI-компания GitHub
Подключить MCP-сервер Яндекс Метрика к AI-агенту Открытый код, MIT, npm-пакет. Инструкция по подключению к Claude, Cursor и Codex — в репозитории; вопросы по внедрению — в Telegram. Репозиторий на GitHub Telegram

Яндекс Метрика: Статистика — MCP-инструмент (tool)

MCP-инструмент (tool) для Яндекс Метрики: Запрашивает Reporting API Яндекс Метрики (stat/v1/data) по счётчику.

Техническое имя: get_statistics

Какую задачу решает

Я хочу посмотреть статистику.

Запрашивает Reporting API Яндекс Метрики (stat/v1/data) по счётчику.

Когда использовать

Используйте эту возможность, когда нужен результат «Статистика» без ручной работы в интерфейсе Яндекс Метрики. Операция выполняется только по вызову из AI-приложения.

Что нужно передать

  • counterId — необязательно. Идентификатор счётчика. По умолчанию YANDEX_METRIKA_COUNTER_ID.
  • metrics — необязательно. Метрики, например ym:s:visits, ym:s:users, ym:s:bounceRate, ym:s:goal<id>reaches. По умолчанию — типовой набор.
  • dimensions — необязательно. Измерения для группировки, например ym:s:date, ym:s:lastTrafficSource, ym:s:deviceCategory. Без них — итог за период.
  • date1 — необязательно. Дата начала: YYYY-MM-DD или относительная (today, yesterday, NdaysAgo). По умолчанию 7daysAgo.
  • date2 — необязательно. Дата конца: YYYY-MM-DD или относительная (today, yesterday, NdaysAgo). По умолчанию yesterday.
  • filters — необязательно. Выражение фильтра Метрики, например ym:s:deviceCategory=='mobile'.
  • sort — необязательно. Поле сортировки; префикс '-' — по убыванию, например -ym:s:visits.
  • accuracy — необязательно. Точность сэмплирования: 'full' — точный расчёт (медленнее) или доля 0..1. По умолчанию — авторежим API.
  • limit — необязательно. Максимум строк на странице (игнорируется, если задан autoPaginate).
  • offset — необязательно. Смещение по строкам для постраничной выдачи, отсчёт с 1.
  • autoPaginate — необязательно. Забирает все строки, листая страницами максимального для API размера (склеивает data, сохраняет totals). Игнорирует limit; ограничен maxPages и лимитами по строкам/байтам (при их достижении выставляет _truncated).
  • maxPages — необязательно. Лимит страниц для autoPaginate. По умолчанию 100.

Что вернёт

В ответе есть totals (итог по ВСЕМ строкам — для вопросов «сколько всего» суммировать не нужно), total_rows и sampled/sample_share (sampled=true означает, что данные приблизительные; для точных цифр нужно сузить период или передать accuracy=full).

Что изменится в Яндекс Метрике

Инструмент только читает данные или состояние подключения и не изменяет их.

Пример запроса

Посмотреть статистику в Яндекс Метрике. Если не хватает обязательных идентификаторов, сначала уточни их.

Возможные ошибки и ограничения

ПО УМОЛЧАНИЮ возвращает одну строку, агрегированную за период (без измерений), с visits/users/pageviews/bounceRate/avgVisitDurationSeconds. dimensions разбивает результат на строки (ym:s:date — динамика по дням, ym:s:lastTrafficSource — источники трафика, ym:s:deviceCategory — устройства), metrics задаёт нужные метрики — для конверсий это ym:s:goal<goalId>reaches / ym:s:goal<goalId>conversionRate (идентификаторы целей даёт list_goals). Если counterId не передан, берётся YANDEX_METRIKA_COUNTER_ID.

Доступ также зависит от прав токена, квот и ограничений исходного API.

Связанные MCP-инструменты

Связанных специализированных инструментов в этой группе нет.

Технические сведения