Yandex Ads MCP Server
MCP-сервер для Яндекс Директа, Метрики, Аудиторий и Wordstat с режимом только чтения и подтверждением изменений
- 47 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Создает кампании и меняет ставки и бюджеты в боевом кабинете, то есть тратит деньги
- Загружает в Аудитории CRM-данные клиентов: email и телефоны
- Защитные режимы по умолчанию выключены
Установка
- Работает в
- Сервисы
Ручная установка
git clone https://github.com/Yurich-ru/yandex-ads-mcp.git
cd yandex-ads-mcp
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txtПосле установки скопируйте .env.example в .env и заполните токены.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Создает кампании и меняет ставки и бюджеты в боевом кабинете, то есть тратит деньги
- Загружает в Аудитории CRM-данные клиентов: email и телефоны
- Защитные режимы по умолчанию выключены
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер закрывает рекламный цикл в Яндексе из одного места. В Директе агент создает и меняет кампании, группы, объявления, включая комбинаторные, ключевые фразы и автотаргетинг, ставки, корректировки, минус-фразы, расширения и получает отчеты. В Метрике доступны счетчики, цели, сегменты, отчеты и загрузка офлайн-конверсий и расходов, в Аудиториях создаются сегменты из CRM-данных, похожие и геосегменты, Wordstat дает частотность, динамику и регионы. Для боевых кабинетов есть режим только чтения, режим предпросмотра с обязательным подтверждением, белый список клиентских логинов и работа с несколькими кабинетами.
Для кого. Для специалистов по контекстной рекламе и агентств, которые ведут кампании в Яндекс Директе.
Подходит, если
- Нужно массово завести группы, объявления и фразы в Директе по плану
- Нужно сопоставить расходы Директа с целями Метрики в одном отчете
- Агентству нужно работать с кабинетами нескольких клиентов с ограничением доступа
Не подходит, если
- Нужен только Вордстат без доступа к рекламным кабинетам
- Не готовы включать YD_READONLY или YD_CONFIRM при работе с боевым кабинетом
Пример запроса к агенту
Покажи расходы и конверсии по кампаниям Директа за прошлую неделю и предложи, где снизить ставки, ничего не меняя без моего подтвержденияMCP
- Транспорт
- stdio
- Авторизация
- OAuth
Переменные окружения
YD_OAUTH_TOKENобязательная, секрет- OAuth-токен с доступами к Директу, Метрике, Аудиториям и Yandex Cloud
YC_FOLDER_ID- ID каталога Yandex Cloud для Wordstat
YC_API_KEYсекрет- API-ключ сервисного аккаунта для Wordstat
YD_READONLY- true блокирует все изменяющие инструменты
YD_CONFIRM- true требует подтверждения каждого изменения
YD_ALLOWED_LOGINS- Белый список клиентских логинов агентства
YD_SANDBOX- true включает песочницу Директа
Ограничения
Нужно свое OAuth-приложение Яндекса с доступами к Директу, Метрике, Аудиториям и Yandex Cloud и одобренная заявка на API Директа. Для Wordstat нужен платежный аккаунт Yandex Cloud с каталогом и ролью search-api.webSearch.user, для новых токенов еще и API-ключ сервисного аккаунта. Пакета нет, сервер ставится из клона в виртуальное окружение Python. Защитные режимы по умолчанию выключены, файла лицензии в репозитории нет.
Как отключить. Удалите блок yandex-ads из ~/.claude.json или конфигурации клиента и отзовите OAuth-токен в настройках Яндекс ID.
Частые вопросы
Как не дать агенту случайно поменять боевую кампанию?
Включите YD_READONLY=true, тогда изменяющие инструменты блокируются до сетевого вызова, или YD_CONFIRM=true, тогда каждое изменение сначала возвращает превью и выполняется только с confirm=true.
Что делать, если Директ и Метрика в разных аккаунтах?
Выпустить токен в каждом аккаунте и задать YD_OAUTH_TOKEN для Директа, а YD_METRIKA_TOKEN и YD_AUDIENCE_TOKEN для Метрики и Аудиторий.
Обсуждение
Вопросов и отзывов пока нет.
MCP-сервер для Яндекс Директа, Метрики, Wordstat и Вебмастера: кампании, объявления, ставки, отчеты и подбор запросов из чата
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
Монорепозиторий MCP-серверов для Яндекса: Директ, Метрика, Вебмастер, Wordstat, Трекер, 360, Карты, SpeechKit, YandexGPT и AppMetrica
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Yandex Ads MCP Server (эта запись) | нет | OAuth | 47 | |
| Яндекс Директ MCP: hardened форк | нет | OAuth | 0 | форк с чтением по умолчанию и флагами записи |
| Яндекс Директ, Метрика и Wordstat MCP: форк с комбинаторными объявлениями | нет | OAuth | 0 | комбинаторные объявления |
Коротко о README
README на русском описывает установку из клона в виртуальное окружение и подключение к Claude Code. Подробно разобрано получение OAuth-токена, заявка на API Директа и настройка Yandex Cloud для Wordstat. Есть таблица переменных окружения, раздел о защитных режимах и мультиаккаунте и полный список инструментов по сервисам с примерами параметров для сложных вызовов.