MCP для Метрики и Директа с минус-фразами
Яндекс.Метрика + Директ MCP Server
MCP-сервер на 30 инструментов для Метрики и Директа: отчеты, ставки, объявления, управление минус-фразами и Wordstat
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Может создавать, изменять и удалять общие наборы минус-фраз, применяемые сразу к нескольким кампаниям
- Может добавлять или полностью заменять минус-фразы на уровне кампании
- Хранит токены нескольких рекламных аккаунтов в одном .env файле
Установка
Ручная установка
git clone https://github.com/unklex/yandex-mcp.git
cd yandex-mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txtУстановка из исходников с виртуальным окружением.
Проверка безопасности
Как мы проверяемВысокий рискВысокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
- Может создавать, изменять и удалять общие наборы минус-фраз, применяемые сразу к нескольким кампаниям
- Может добавлять или полностью заменять минус-фразы на уровне кампании
- Хранит токены нескольких рекламных аккаунтов в одном .env файле
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер объединяет 7 инструментов Яндекс Метрики (сводка трафика, источники, топ страниц, цели, аудитория, активность в реальном времени, сравнение периодов) и 23 инструмента Яндекс Директа. Директ покрывает кампании и бюджеты с остатком Units API, статистику по эффективности, дням, регионам, устройствам и площадкам, объявления и группы объявлений, текущие ставки, а также управление минус-фразами: добавление или замена на уровне кампании и полный CRUD над общими наборами минус-фраз, которые можно привязать сразу к нескольким кампаниям. Wordstat через legacy Direct API v4 дает топ смежных запросов, помесячную динамику и распределение по регионам. Гибкие отчеты дают доступ к произвольным типам Reports API с любыми полями. Поддерживаются несколько счетчиков Метрики и несколько аккаунтов Директа одновременно через псевдонимы в .env, включая агентский доступ по client_login.
Для кого. Для специалистов по контекстной рекламе, которые ведут несколько сайтов и рекламных аккаунтов и хотят управлять минус-фразами и смотреть статистику из одного места.
Подходит, если
- Нужно добавить или заменить минус-фразы сразу в нескольких кампаниях через общий набор
- Ведется несколько сайтов и рекламных аккаунтов, и нужны псевдонимы вместо запоминания ID
- Нужны и отчеты Метрики, и статистика Директа в одном сервере без переключения
Не подходит, если
- Нужен только read-only доступ без риска изменить минус-фразы: здесь есть добавление, замена и удаление наборов
- Не нужен Wordstat: инструмент использует устаревающий Direct API v4 с суточным лимитом около 1000 отчетов на токен
Пример запроса к агенту
Добавь минус-фразы бесплатно и скачать в общий набор и привяжи его ко всем активным кампаниямMCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
YANDEX_METRICA_TOKENобязательная, секрет- OAuth-токен с правом metrika:read
YANDEX_METRICA_COUNTER_IDобязательная- ID основного счетчика Метрики
YANDEX_METRICA_COUNTERS- Список дополнительных счетчиков в формате псевдоним:id через запятую
YANDEX_DIRECT_TOKENсекрет- OAuth-токен с правом direct:api для Яндекс Директа
YANDEX_DIRECT_ACCOUNTSсекрет- Список токенов нескольких рекламных аккаунтов в формате псевдоним:токен
YANDEX_DIRECT_CLIENT_LOGIN- Логин клиента для агентских аккаунтов Директа
Ограничения
Лицензия в репозитории не указана. Лимиты Директа на минус-фразы: до 1000 фраз на кампанию или набор, суммарно до 20000 символов, фраза до 7 слов. Удалить набор минус-фраз нельзя, пока он привязан к кампаниям, нужно сначала отвязать через campaigns.update. Wordstat работает через legacy API v4 с опросом результата 3-30 секунд и лимитом около 1000 отчетов в сутки на токен.
Как отключить. Удалите сервер из конфигурации MCP клиента и отзовите OAuth-токен на oauth.yandex.com.
Частые вопросы
Можно ли привязать один набор минус-фраз к нескольким кампаниям?
Да, общий набор минус-фраз можно связать сразу с несколькими кампаниями, это отдельная сущность от минус-фраз уровня одной кампании.
Почему нельзя удалить набор минус-фраз?
Если набор привязан к кампаниям, API Директа отказывает в удалении, сначала нужно отвязать его через campaigns.update.
Похожие
MCP-серверыСкиллы DataLens
DataLens Skills
Официальные скиллы DataLens (Яндекс) для Claude Code, Codex и OpenCode: SDK, HTML-отчеты и разбор прав RLS
MCP Яндекс Метрики со всеми 108 методами API
Yandex Metrika MCP Server
MCP-сервер Яндекс Метрики, порожденный из спеки API: 108 методов, по умолчанию 10 инструментов, прозрачные фильтры и метаданные ответа
Открытый MCP-сервер и набор агентских скиллов для SEO: keyword research, конкуренты, обратные ссылки и аудит сайта по данным DataForSEO
Плагин Claude Code для SEO-аудита: технический SEO, E-E-A-T, schema, локальный и AI-поиск силами параллельных агентов
Коротко о README
README на русском описывает сервер для Метрики и Директа с примерами запросов на естественном языке. Даны требования, шаги установки через виртуальное окружение, получение OAuth-токена с правами metrika:read и direct:api, поиск ID счетчика и заполнение единственного файла .env с поддержкой нескольких счетчиков и аккаунтов через псевдонимы. Подключение показано для Claude Desktop, Claude Code и Cowork. Таблицы инструментов разбиты на Метрику и Директ: кампании и бюджеты, статистика, объявления и ставки, минус-фразы с описанием режимов append и replace и CRUD над общими наборами, Wordstat через legacy API и гибкие отчеты. Указаны лимиты по минус-фразам и Wordstat.