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.mjsOAuth-токен можно получить командой 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.
{
"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
Нарезка длинных видео на короткие клипы с обложками и субтитрами.
Google Ads + Meta Ads + SEO/GEO MCP
Google Ads, Meta Ads, GA4 и Search Console в одном сервере.
NotFair
Доступ к Google, Meta, X, LinkedIn, Reddit, TikTok, GSC, GA4 и WordPress через OAuth.
obsei
Самостоятельно размещаемая система обратной связи клиентов с удалением персональных данных.