Яндекс Директ, Метрика и Wordstat MCP: форк с комбинаторными объявлениями
Yandex Direct MCP Server
Форк Yandex Ads MCP на 120 инструментов, который добавил создание комбинаторных объявлений и IAM-токены из ключа сервисного аккаунта
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Создает, меняет и удаляет кампании, группы, объявления и ставки, то есть тратит рекламный бюджет
- Загружает офлайн-конверсии и расходы в Метрику
- Защитные режимы read-only и confirm по умолчанию выключены
Установка
Ручная установка
git clone https://github.com/guyfullin10-lgtm/yandex-direct-mcp.git
cd yandex-direct-mcp
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txtПосле установки скопируйте .env.example в .env и заполните токены.
Проверка безопасности
Как мы проверяемВысокий рискВысокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
- Создает, меняет и удаляет кампании, группы, объявления и ставки, то есть тратит рекламный бюджет
- Загружает офлайн-конверсии и расходы в Метрику
- Защитные режимы read-only и confirm по умолчанию выключены
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер объединяет Яндекс Директ, Метрику и Wordstat: 77 инструментов для кампаний, групп, объявлений, ключевых фраз, ставок, фидов и отчетов Директа, 43 для счетчиков, целей и отчетов Метрики, 5 для частотности и динамики Wordstat. Форк добавил к исходному проекту создание, изменение и удаление комбинаторных объявлений ResponsiveAd через рабочий JSON-эндпоинт Direct API v501, который в документации указан неверно. Также добавлены IAM-токены из ключа сервисного аккаунта взамен Passport-токенов, которые Яндекс запретил обменивать для свежих приложений, и ретраи Wordstat при HTTP 429. Защитная обвязка включает read-only режим, confirm-режим с превью перед изменением и allow-лист клиентских логинов.
Для кого. Для специалистов по контекстной рекламе, которым нужны комбинаторные объявления и совместимость с новыми правилами авторизации Яндекса.
Подходит, если
- Нужно создавать комбинаторные объявления ResponsiveAd, которые не грузятся в исходном проекте
- Свежий OAuth-токен не работает с Wordstat из-за смены правил Яндекса после июня 2026 года
- Нужен единый сервер для Директа, Метрики и Wordstat с защитой боевого кабинета
Не подходит, если
- Достаточно только одиночных TextAd, комбинаторные объявления не нужны
- Нет доступа к платежному аккаунту Yandex Cloud, который требуется для Wordstat
Пример запроса к агенту
Собери комбинаторное объявление с тремя заголовками и двумя текстами для группы 12345MCP
- Транспорт
- stdio
- Авторизация
- OAuth
Переменные окружения
YD_OAUTH_TOKENобязательная, секрет- OAuth-токен с правами direct:api, metrika:read, metrika:write, cloud:auth
YC_FOLDER_ID- ID каталога Yandex Cloud, нужен для Wordstat
YD_READONLY- true блокирует все изменяющие инструменты
YD_CONFIRM- true требует confirm=true для выполнения изменяющих вызовов
YD_ALLOWED_LOGINS- Белый список клиентских логинов через запятую
Ограничения
Форк одного автора поверх Yurich-ru/yandex-ads-mcp, ведется в ветке fork-main, апстрим master не тронут. Нужны OAuth-приложение с доступами Директа, Метрики и cloud:auth, одобренная заявка на API Директа и платежный аккаунт Yandex Cloud с ролью search-api.executor для Wordstat. Файла лицензии проекта в README не описано.
Как отключить. Удалите блок yandex-ads из конфигурации MCP-клиента и отзовите OAuth-токен в настройках Яндекс ID.
Частые вопросы
Чем отличается от Yurich-ru/yandex-ads-mcp?
Комбинаторными объявлениями ResponsiveAd, IAM-токенами из ключа сервисного аккаунта, ретраями Wordstat и переименованными инструментами yandex_direct_* вместо yd_* для лучшего поиска по смыслу в MCP-клиентах.
Почему у старого токена перестал работать Wordstat?
Яндекс запретил обмен Passport-токенов, выпущенных после 1 июня 2026 года, форк решает это через IAM-токены сервисного аккаунта.
Похожие
MCP-серверыСкилл, который убирает из текста приметы ИИ-письма по списку Википедии и не добавляет выдуманных фактов
Marketing Skills: маркетинговые скиллы для агентов
Marketing Skills for AI Agents
Около пятидесяти скиллов по CRO, копирайтингу, SEO, аналитике, рекламе и запуску продукта для кодовых агентов
MCP-сервер SendPulse
SendPulse MCP
Официальный удаленный MCP-сервер SendPulse: статистика, рассылки и данные пользователей через чат с агентом
MCP Яндекс Директа из машиночитаемой схемы
yandex-direct-mcp
MCP-сервер и CLI на всех 113 методах API v5 Яндекс Директа, собранных из WSDL: по умолчанию только 9 читающих, запись включается явно
Коротко о README
README сначала перечисляет, что добавляет форк по сравнению с исходным проектом, со ссылкой на FORK.md с построчным списком изменений, затем идет документация исходного проекта: установка в venv, получение OAuth-токена и Folder ID Yandex Cloud, таблица переменных окружения и полный список из 120 инструментов по трем сервисам. Отдельный раздел описывает read-only и confirm режимы и офлайн-проверку test_safety.py.