SkillFoxx
Telegram

MCP для полного API Яндекс Метрики

mcp-server-yandex-metrika

MCP-сервер, CLI и Pydantic-модели для API Яндекс Метрики: отчеты, счетчики, цели, фильтры, сегменты, логи и загрузка офлайн-конверсий

  • 2 ★ репозитория
  • Последний коммит
MCP-сервер

Широкий доступ

Почему такой уровень

  • Может удалить счетчики, цели, фильтры, сегменты и права доступа
  • Токен с правами metrika:write дает полный контроль над счетчиками аккаунта
  • Может загружать офлайн-конверсии и расходы, влияя на данные атрибуции
Все причины и проверки
Российский стек

dontsovcmc/mcp-server-yandex-metrikaАвтор:dontsovcmc

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/mcp-server-yandex-metrika

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Может удалить счетчики, цели, фильтры, сегменты и права доступа
  • Токен с правами metrika:write дает полный контроль над счетчиками аккаунта
  • Может загружать офлайн-конверсии и расходы, влияя на данные атрибуции

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Проект дает MCP-сервер, CLI-утилиту и библиотеку типизированных Pydantic-моделей поверх API Яндекс Метрики. Покрытие широкое: табличные, временные, drill down и сравнительные отчеты Reporting API, полное управление счетчиками, целями, фильтрами, сегментами, метками, операциями и правами доступа с созданием, изменением и удалением, работа с аккаунтами и представителями, примечания на графике, Logs API для выгрузки визитов и хитов, а также загрузка офлайн-конверсий, звонков, расходов и пользовательских параметров. У каждого MCP-инструмента есть парный CLI-эквивалент, а без аргументов пакет запускает MCP-сервер, с командой работает как обычный CLI. Все запросы идут напрямую в API с локального компьютера, токен никуда, кроме Яндекс Метрики, не передается.

Для кого. Для аналитиков и маркетологов, которым нужен полный контроль над Яндекс Метрикой, включая создание целей и фильтров, а не только чтение отчетов.

Подходит, если

  • Нужно создать или изменить цели, фильтры или сегменты счетчика прямо из диалога с агентом
  • Нужна выгрузка сырых логов визитов или загрузка офлайн-конверсий и звонков
  • Нужны те же данные и в CLI для скриптов, и в MCP для агента без второго инструмента

Не подходит, если

  • Нужен только просмотр без риска случайно удалить цель, фильтр или счетчик: здесь доступны и удаляющие инструменты
  • Не нужна такая широта: только отчеты, без управления целями и правами, тогда подойдет более узкий сервер

Пример запроса к агенту

Создай цель Покупка типа url с условием contain /thank-you для счетчика 12345678

MCP

Транспорт
stdio
Авторизация
API-ключ

Переменные окружения

YANDEX_METRIKA_TOKEN обязательная, секрет
OAuth-токен Яндекс Метрики с правами metrika:read и metrika:write
METRIKA_TIMEOUT
Таймаут HTTP-запросов к API в секундах, по умолчанию 30
METRIKA_FILE_TIMEOUT
Таймаут скачивания файлов логов в секундах, по умолчанию 60

Ограничения

Лицензия в метаданных репозитория не заявлена явно, хотя README указывает MIT. Нужен OAuth-токен с правами metrika:read и metrika:write. Лимиты API: 30 запросов в секунду на IP, 5000 в день на пользователя, 3 параллельных запроса, отдельный лимит 200 запросов за 5 минут для основного отчета, превышение возвращает HTTP 429.

Как отключить. Удалите сервер командой claude mcp remove yandex-metrika и отзовите OAuth-токен на oauth.yandex.com.

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

Можно ли пользоваться сервером без MCP-клиента?

Да, тот же пакет работает как обычная CLI-утилита: без аргументов запускается MCP-сервер, с командой вроде counters или stat-data выполняется нужный запрос и выводится JSON.

Есть ли типизированные модели для своих скриптов?

Да, пакет содержит Pydantic-модели всех объектов API с extra=allow для совместимости с будущими полями, их можно импортировать в свои Python-программы.

Обсуждение

Вопросов и отзывов пока нет.

Яндекс Метрика — все инструменты
Российский стек

MCP-сервер Яндекс Метрики на 15 инструментов: отчеты и трафик плюс создание, изменение и удаление счетчиков и целей

MCP-серверШирокий доступ1
Выбор редакции

MCP-сервер Яндекс Метрики, порожденный из спеки API: 108 методов, по умолчанию 10 инструментов, прозрачные фильтры и метаданные ответа

MCP-серверРасширенный доступ2

Yandex Metrica MCP

yandex-metrica-mcp

Российский стек

MCP-сервер для Яндекс Метрики только на чтение: отчеты, сравнение периодов, цели и выгрузка сырых логов с входом через браузер

MCP-серверРасширенный доступ15

Yandex Metrika MCP

Yandex Metrika MCP Server

Российский стек

MCP-сервер для отчетов Яндекс Метрики: трафик, источники, поисковые фразы, цели, география, устройства и контент-аналитика

MCP-серверРасширенный доступ24
Российский стек

Минималистичный MCP на Python: 12 инструментов только для чтения по правильному заголовку OAuth и парный скилл с методикой сравнения периодов

MCP-серверРасширенный доступ4

Коротко о README

README на русском описывает три формы одного пакета: MCP-сервер, CLI и библиотеку Pydantic-моделей поверх API Яндекс Метрики. Дана подробная таблица инструментов по категориям: отчеты, счетчики, цели, фильтры, доступ, операции, сегменты, метки, аккаунты, примечания, фильтры доступа, Logs API, импорт данных, с парным CLI-именем для каждого. Показаны шаги получения OAuth-токена, установка через uvx и pip, подключение к Claude Code и Claude Desktop, временное подключение через --mcp-config, примеры CLI-команд, использование Pydantic-моделей в своих скриптах, переменные окружения и лимиты API. Лицензия MIT.

Бейдж для README

Сообщить о проблеме