Yandex Ads MCP Server

Установка

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

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер закрывает рекламный цикл в Яндексе из одного места. В Директе агент создает и меняет кампании, группы, объявления, включая комбинаторные, ключевые фразы и автотаргетинг, ставки, корректировки, минус-фразы, расширения и получает отчеты. В Метрике доступны счетчики, цели, сегменты, отчеты и загрузка офлайн-конверсий и расходов, в Аудиториях создаются сегменты из CRM-данных, похожие и геосегменты, Wordstat дает частотность, динамику и регионы. Для боевых кабинетов есть режим только чтения, режим предпросмотра с обязательным подтверждением, белый список клиентских логинов и работа с несколькими кабинетами.

Для кого. Для специалистов по контекстной рекламе и агентств, которые ведут кампании в Яндекс Директе.

Пример запроса к агенту

Покажи расходы и конверсии по кампаниям Директа за прошлую неделю и предложи, где снизить ставки, ничего не меняя без моего подтверждения

Ограничения

Нужно свое OAuth-приложение Яндекса с доступами к Директу, Метрике, Аудиториям и Yandex Cloud и одобренная заявка на API Директа. Для Wordstat нужен платежный аккаунт Yandex Cloud с каталогом и ролью search-api.executor, для новых токенов еще и API-ключ сервисного аккаунта. Пакета нет, сервер ставится из клона в виртуальное окружение Python. Защитные режимы по умолчанию выключены, файла лицензии в репозитории нет.

Как отключить. Удалите блок yandex-ads из ~/.claude.json или конфигурации клиента и отзовите OAuth-токен в настройках Яндекс ID.

MCP

Транспорт

stdio

Авторизация

OAuth

Проверка безопасности

• Создает кампании и меняет ставки и бюджеты в боевом кабинете, то есть тратит деньги
• Загружает в Аудитории CRM-данные клиентов: email и телефоны
• Защитные режимы по умолчанию выключены

Коротко о README

README на русском описывает установку из клона в виртуальное окружение и подключение к Claude Code. Подробно разобрано получение OAuth-токена, заявка на API Директа и настройка Yandex Cloud для Wordstat. Есть таблица переменных окружения, раздел о защитных режимах и мультиаккаунте и полный список инструментов по сервисам с примерами параметров для сложных вызовов.

Похожие