Яндекс Директ, Метрика и Wordstat MCP: форк с комбинаторными объявлениями
Yandex Direct MCP Server
Форк Yandex Ads MCP на 120 инструментов, который добавил создание комбинаторных объявлений и IAM-токены из ключа сервисного аккаунта
- 0 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Создает, меняет и удаляет кампании, группы, объявления и ставки, то есть тратит рекламный бюджет
- Загружает офлайн-конверсии и расходы в Метрику
- Защитные режимы 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 и заполните токены.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Создает, меняет и удаляет кампании, группы, объявления и ставки, то есть тратит рекламный бюджет
- Загружает офлайн-конверсии и расходы в Метрику
- Защитные режимы 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.webSearch.user для 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-сервер для Яндекс Директа, Метрики, Аудиторий и Wordstat с режимом только чтения и подтверждением изменений
Яндекс Директ MCP: hardened форк
yandex-direct-mcp
Форк популярного MCP-сервера Яндекс Директа с чтением по умолчанию и явными флагами для записи и финансов
MCP-сервер для Яндекс Директа, Метрики, Wordstat и Вебмастера: кампании, объявления, ставки, отчеты и подбор запросов из чата
Yandex Direct MCP
yandex-direct-mcp
Плагин Claude Code и Codex для Яндекс Директа: MCP-сервер на 147 инструментов, OAuth и скиллы для объявлений и анализа статистики
Монорепозиторий MCP-серверов для Яндекса: Директ, Метрика, Вебмастер, Wordstat, Трекер, 360, Карты, SpeechKit, YandexGPT и AppMetrica
MCP для Директа, Метрики, Wordstat и Вебмастера
yandex-marketing-mcp
MCP-сервер на 155 инструментов для Яндекс Директа, Метрики, Wordstat и Вебмастера с самонастройкой OAuth и режимами read-only и confirm
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Яндекс Директ, Метрика и Wordstat MCP: форк с комбинаторными объявлениями (эта карточка) | нет | OAuth | 0 | |
| Yandex Ads MCP Server | нет | OAuth | 51 | Yandex Ads с режимом чтения |
| Яндекс Директ MCP: hardened форк | нет | OAuth | 0 | форк с чтением по умолчанию и флагами записи |
Коротко о README
README сначала перечисляет, что добавляет форк по сравнению с исходным проектом, со ссылкой на FORK.md с построчным списком изменений, затем идет документация исходного проекта: установка в venv, получение OAuth-токена и Folder ID Yandex Cloud, таблица переменных окружения и полный список из 120 инструментов по трем сервисам. Отдельный раздел описывает read-only и confirm режимы и офлайн-проверку test_safety.py.