Yandex Metrika MCP

Yandex Metrika MCP — MCP-сервер сообщества (автор — stufently). Сервер для API Яндекс Метрики: веб-аналитика, трафик и аудитория. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
stufently
Лицензия
MIT
Транспорт
stdio
Авторизация
oauth
ОС
Не указана
Языки
javascript

Уровень риска: high

Токен с `metrika:write` позволяет создавать и необратимо удалять счётчики; удаление требует `confirm: true`. Для отчётов достаточно `metrika:read`.

Что умеет

yandex-metrika-mcp — MCP-сервер для API Яндекс Метрики. Он даёт ассистенту доступ к веб-аналитике: сводке по трафику, аудитории, источникам переходов, популярным страницам, поисковым фразам и произвольным отчётам. Всего 12 инструментов.

Группа Инструменты
Управление get-counters — все счётчики, get-counter — данные счётчика, get-goals — цели, create-counter — новый счётчик, delete-counter — удаление счётчика
Отчёты get-traffic-summary — визиты, посетители, просмотры, отказы, длительность; get-traffic-sources; get-geography — страны и города; get-devices — устройства, браузеры, ОС; get-popular-pages; get-search-phrases
Произвольный отчёт get-report — любые метрики и группировки Stat API с фильтрами и сортировкой

Если даты не указаны, отчёты строятся за последние 30 дней. Для больших объёмов Stat API может вернуть выборочные данные — тогда в ответе есть пометка, что цифры приблизительные.

Кому подойдёт

  • Владельцам сайтов: вопросы о посещаемости обычным языком вместо работы с интерфейсом Метрики.
  • Маркетологам: источники трафика, география и поисковые фразы за любой период.
  • Аналитикам: произвольные отчёты через get-report.

Похожие серверы — в категории маркетинг и соцсети.

Установка

Пакет будет опубликован как @stufently/yandex-metrika-mcp, но пока под этим именем ничего не выложено. Пакет yandex-metrika-mcp без префикса принадлежит другому автору. Запускайте сервер из исходников:

git clone https://github.com/stufently/yandex-mcp.git
cd yandex-mcp && bun install
node packages/yandex-metrika-mcp/src/index.mjs

OAuth-токен можно получить командой node packages/yandex-metrika-mcp/src/index.mjs auth: откроется браузер для авторизации в Яндексе. Для этого нужны YANDEX_CLIENT_ID и YANDEX_CLIENT_SECRET вашего OAuth-приложения. По умолчанию запрашиваются права metrika:read metrika:write. Если нужен токен только для чтения, задайте YANDEX_METRIKA_SCOPE="metrika:read" — тогда создание и удаление счётчиков вернут ошибку 403.

Подключение к клиентам

Конфиг приведён дословно из README. Укажите путь к склонированному репозиторию. Общий порядок — в инструкции как подключить MCP.

claude_desktop_config.json
{
  "mcpServers": {
    "yandex-metrika": {
      "command": "node",
      "args": ["/path/to/yandex-mcp/packages/yandex-metrika-mcp/src/index.mjs"],
      "env": {
        "YANDEX_METRIKA_TOKEN": "your-oauth-token"
      }
    }
  }
}

Проверка

Спросите ассистента: «Покажи мои счётчики Метрики». Он вызовет get-counters. Затем попросите сводку по трафику одного из счётчиков.

Примеры задач

Сравни трафик сайта за последние 30 дней и предыдущий месяц, по источникам.
Какие поисковые фразы приводят больше всего посетителей?

Риски

Токен с правом metrika:write позволяет создавать и удалять счётчики. Удаление необратимо: счётчик и вся собранная статистика пропадают навсегда, а новый счётчик для того же сайта историю не вернёт.

Что встроено: delete-counter отказывается работать без параметра confirm: true — принимается только буквальное true, без него в API ничего не уходит. Инструмент помечен destructiveHint: true. На процесс действует ограничение: не больше 3 параллельных запросов и 200 запросов отчётов за скользящие 5 минут. Ошибки сети и ответы 420, 429, 5xx повторяются до трёх раз с учётом Retry-After.

Как снизить риски: если ассистенту нужны только отчёты, выпустите токен с правом metrika:read. Храните токен в переменной окружения. Лицензия — MIT.

Частые вопросы

Можно ли выдать серверу доступ только на чтение?

Да. Получите токен с YANDEX_METRIKA_SCOPE="metrika:read" — десять инструментов чтения будут работать, а создание и удаление счётчиков вернут ошибку 403.

Почему цифры помечены как приблизительные?

Для больших объёмов данных Stat API Метрики возвращает выборку. Сервер сообщает об этом в ответе.

Основы протокола — на странице что такое MCP-сервер.

Инструменты

  • get-counters
  • get-traffic-summary
  • get-traffic-sources
  • get-search-phrases
  • get-report
  • create-counter
  • delete-counter

Похожие MCP-серверы

AutoClip

Нарезка длинных видео на короткие клипы с обложками и субтитрами.

Риск: medium Лицензия: MIT ★ 10 310

NotFair

Доступ к Google, Meta, X, LinkedIn, Reddit, TikTok, GSC, GA4 и WordPress через OAuth.

Риск: medium Лицензия: MIT ★ 4 143

obsei

Самостоятельно размещаемая система обратной связи клиентов с удалением персональных данных.

Риск: medium Лицензия: Apache-2.0 ★ 1 452

Источники