MCP для Метрики и Директа с минус-фразами
Яндекс.Метрика + Директ MCP Server
MCP-сервер на 30 инструментов для Метрики и Директа: отчеты, ставки, объявления, управление минус-фразами и Wordstat
- 1 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Может создавать, изменять и удалять общие наборы минус-фраз, применяемые сразу к нескольким кампаниям
- Может добавлять или полностью заменять минус-фразы на уровне кампании
- Хранит токены нескольких рекламных аккаунтов в одном .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Установка из исходников с виртуальным окружением.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Может создавать, изменять и удалять общие наборы минус-фраз, применяемые сразу к нескольким кампаниям
- Может добавлять или полностью заменять минус-фразы на уровне кампании
- Хранит токены нескольких рекламных аккаунтов в одном .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-сервер для аналитики Директа, Метрики, Wordstat и Аудиторий: сырые отчеты, сопоставление данных и HTML-дашборд
MCP-сервер Директа, Метрики, Wordstat и Вебмастера
Yandex MCP Server
MCP-сервер со 141 инструментом: полное управление кампаниями Директа, счетчиками и целями Метрики, Wordstat и Вебмастер
MCP-сервер от ZAI.ONE сводит Директ, Метрику, поиск, Wordstat и Вебмастер в одном агенте, с мастером настройки и включаемыми пишущими операциями
MCP для Директа, Метрики, Wordstat и Вебмастера
yandex-marketing-mcp
MCP-сервер на 155 инструментов для Яндекс Директа, Метрики, Wordstat и Вебмастера с самонастройкой OAuth и режимами read-only и confirm
Read-only MCP-сервер без внешних зависимостей: Метрика, Вебмастер, Директ и Wordstat, токен в Keychain, вход прямо в диалоге агента
MCP-сервер для Яндекс Директа, Метрики, Wordstat и Вебмастера: кампании, объявления, ставки, отчеты и подбор запросов из чата
Коротко о README
README на русском описывает сервер для Метрики и Директа с примерами запросов на естественном языке. Даны требования, шаги установки через виртуальное окружение, получение OAuth-токена с правами metrika:read и direct:api, поиск ID счетчика и заполнение единственного файла .env с поддержкой нескольких счетчиков и аккаунтов через псевдонимы. Подключение показано для Claude Desktop, Claude Code и Cowork. Таблицы инструментов разбиты на Метрику и Директ: кампании и бюджеты, статистика, объявления и ставки, минус-фразы с описанием режимов append и replace и CRUD над общими наборами, Wordstat через legacy API и гибкие отчеты. Указаны лимиты по минус-фразам и Wordstat.