MCP для Яндекс Директа на Python
yandex-direct-mcp
Python SDK и MCP-сервер для API Яндекс Директа v5: кампании, ключевые слова и отчеты для агента
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Может останавливать, возобновлять, архивировать и удалять рекламные кампании
- Может менять ставки и добавлять ключевые слова, что напрямую влияет на расход бюджета
- Без переменной песочницы действует на боевом рекламном аккаунте
Установка
Ручная установка
poetry installУстановка зависимостей проекта.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Проект дает типизированный асинхронный SDK на Python для API Яндекс Директа v5 и MCP-сервер поверх него. Сервер публикует инструменты для списка, остановки, возобновления, архивации и удаления кампаний, для добавления ключевых слов и изменения ставок, а также для запроса отчетов о статистике с ожиданием готовности. Автор прямо пишет, что проект на ранней стадии: транспорт, аутентификация и сервисы кампаний, ключевых слов и отчетов покрыты тестами, а добавление и обновление кампаний с настройками по типу пока не реализовано.
Для кого. Для специалистов по контекстной рекламе, которые хотят управлять кампаниями Яндекс Директа через агента.
Подходит, если
- Нужно быстро остановить или возобновить показ по списку кампаний
- Нужно добавить ключевые слова или изменить ставку без захода в интерфейс Директа
- Нужен отчет по статистике кампаний в диалоге с агентом
Не подходит, если
- Нужно создавать новые кампании или менять их настройки по типу: этого сервер пока не умеет
- Нужен стабильный, давно обкатанный проект: автор сам называет статус ранней разработкой
Пример запроса к агенту
Останови показ по кампаниям с нулевыми конверсиями за последнюю неделюОграничения
Автор сам предупреждает о раннем статусе разработки. Создание и обновление кампаний с настройками по типу не реализовано. Установка через poetry, готового npm или PyPI пакета нет. Нужен OAuth-токен Яндекс Директа, без песочницы инструменты сразу действуют на боевом аккаунте.
Как отключить. Удалите сервер из конфигурации MCP клиента и отзовите OAuth-токен Яндекс Директа в кабинете разработчика.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| YANDEX_DIRECT_ACCESS_TOKEN обязательная, секрет | OAuth-токен приложения Яндекс Директа |
| YANDEX_DIRECT_CLIENT_LOGIN | Логин клиента для работы от имени агентства |
| YANDEX_DIRECT_USE_OPERATOR_UNITS | Списывает баллы со счета оператора вместо клиента |
| YANDEX_DIRECT_LANGUAGE | Язык сообщений об ошибках: ru, en или uk |
| YANDEX_DIRECT_SANDBOX | Направляет запросы в песочницу API вместо боевого аккаунта |
Проверка безопасности
- Может останавливать, возобновлять, архивировать и удалять рекламные кампании
- Может менять ставки и добавлять ключевые слова, что напрямую влияет на расход бюджета
- Без переменной песочницы действует на боевом рекламном аккаунте
Коротко о README
README описывает цели проекта: типизированный SDK и MCP-сервер для API Директа с чистой архитектурой и полным покрытием тестами. Перечислены переменные окружения для токена, логина агентства, единиц оператора, языка ошибок и песочницы. Дана таблица из 13 инструментов сервера и пример конфигурации Claude Desktop. Раздел разработки показывает команды линтера, форматтера, проверки типов и тестов. Лицензия MIT.
Частые вопросы
Можно ли создавать новые кампании?
Нет, автор пишет, что добавление и обновление кампаний с настройками по типу еще не реализовано.
Есть ли защита от случайных трат?
Да, есть переменная YANDEX_DIRECT_SANDBOX для работы с песочницей API вместо боевого аккаунта.
Похожие
Скиллы DataLens
DataLens Skills
Официальные скиллы DataLens (Яндекс) для Claude Code, Codex и OpenCode: SDK, HTML-отчеты и разбор прав RLS
MCP Яндекс Метрики со всеми 108 методами API
Yandex Metrika MCP Server
MCP-сервер Яндекс Метрики, порожденный из спеки API: 108 методов, по умолчанию 10 инструментов, прозрачные фильтры и метаданные ответа
Открытый MCP-сервер и набор агентских скиллов для SEO: keyword research, конкуренты, обратные ссылки и аудит сайта по данным DataForSEO
Плагин Claude Code для SEO-аудита: технический SEO, E-E-A-T, schema, локальный и AI-поиск силами параллельных агентов