# Яндекс Метрика: Статистика — 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-инструменты

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

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

- **Воздействие:** только чтение
- **Группа:** Статистика
- **Источник описания:** регистрация `get_statistics` в `src/tools/statistics.ts`
- [Полный технический справочник](../TOOLS.md)
- [Все MCP-возможности](./index.md)