MCP для Яндекс Директа на Python
yandex-direct-mcp
Python SDK и MCP-сервер для API Яндекс Директа v5: кампании, ключевые слова и отчеты для агента
- 0 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Может останавливать, возобновлять, архивировать и удалять рекламные кампании
- Может менять ставки и добавлять ключевые слова, что напрямую влияет на расход бюджета
- Без переменной песочницы действует на боевом рекламном аккаунте
ovelichko16-ux/yandex-direct-mcp
Похожий инструмент с большим сообществом: MCP-сервер Яндекс Директа на Ruby, 6 ★ репозитория
Установка
- Работает в
- Сервисы
Ручная установка
poetry installУстановка зависимостей проекта.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Может останавливать, возобновлять, архивировать и удалять рекламные кампании
- Может менять ставки и добавлять ключевые слова, что напрямую влияет на расход бюджета
- Без переменной песочницы действует на боевом рекламном аккаунте
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Проект дает типизированный асинхронный SDK на Python для API Яндекс Директа v5 и MCP-сервер поверх него. Сервер публикует инструменты для списка, остановки, возобновления, архивации и удаления кампаний, для добавления ключевых слов и изменения ставок, а также для запроса отчетов о статистике с ожиданием готовности. Автор прямо пишет, что проект на ранней стадии: транспорт, аутентификация и сервисы кампаний, ключевых слов и отчетов покрыты тестами, а добавление и обновление кампаний с настройками по типу пока не реализовано.
Для кого. Для специалистов по контекстной рекламе, которые хотят управлять кампаниями Яндекс Директа через агента.
Подходит, если
- Нужно быстро остановить или возобновить показ по списку кампаний
- Нужно добавить ключевые слова или изменить ставку без захода в интерфейс Директа
- Нужен отчет по статистике кампаний в диалоге с агентом
Не подходит, если
- Нужно создавать новые кампании или менять их настройки по типу: этого сервер пока не умеет
- Нужен стабильный, давно обкатанный проект: автор сам называет статус ранней разработкой
Пример запроса к агенту
Останови показ по кампаниям с нулевыми конверсиями за последнюю неделю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 вместо боевого аккаунта
Ограничения
Автор сам предупреждает о раннем статусе разработки. Создание и обновление кампаний с настройками по типу не реализовано. Установка через poetry, готового npm или PyPI пакета нет. Нужен OAuth-токен Яндекс Директа, без песочницы инструменты сразу действуют на боевом аккаунте.
Как отключить. Удалите сервер из конфигурации MCP клиента и отзовите OAuth-токен Яндекс Директа в кабинете разработчика.
Частые вопросы
Можно ли создавать новые кампании?
Нет, автор пишет, что добавление и обновление кампаний с настройками по типу еще не реализовано.
Есть ли защита от случайных трат?
Да, есть переменная YANDEX_DIRECT_SANDBOX для работы с песочницей API вместо боевого аккаунта.
Обсуждение
Вопросов и отзывов пока нет.
MCP-сервер Яндекс Директа на Ruby
yandex-direct-mcp
MCP-сервер на чистом Ruby без зависимостей: 30 инструментов для кампаний, групп, объявлений, ключевых слов и отчетов Яндекс Директа
MCP для Яндекс Директа и Вордстата на Python
Yandex.Direct MCP
MCP-сервер на Python с 48 инструментами Яндекс Директа и частотностью Вордстата, с переключением между песочницей и боевым режимом
MCP-сервер Яндекс Директа (npm)
@theyahia/yandex-direct-mcp
MCP-сервер на TypeScript с npm-пакетом: 20 инструментов для кампаний, ставок и минус-фраз Яндекс Директа, деньги везде в рублях
MCP Яндекс Директа с dry-run по умолчанию
Yandex Direct MCP Server
20 инструментов Яндекс Директа, где каждая правка по умолчанию только показывает план запроса и требует confirm=True для реальной отправки
Yandex Direct MCP
yandex-direct-mcp
Плагин Claude Code и Codex для Яндекс Директа: MCP-сервер на 147 инструментов, OAuth и скиллы для объявлений и анализа статистики
MCP Яндекс Директа без зависимостей на Node
yandex-direct-mcp
MCP-сервер Direct API v5 одним файлом на Node.js без зависимостей, с инструментом direct_call на все сервисы API и режимом только для чтения
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| MCP для Яндекс Директа на Python (эта карточка) | нет | API-ключ | 0 | |
| MCP, CLI и модели Яндекс Директа с поиском действий | нет | API-ключ | 1 | 79 действий |
| MCP-сервер Директа, Метрики, Wordstat и Вебмастера | нет | API-ключ | 0 | Метрика |
Коротко о README
README описывает цели проекта: типизированный SDK и MCP-сервер для API Директа с чистой архитектурой и полным покрытием тестами. Перечислены переменные окружения для токена, логина агентства, единиц оператора, языка ошибок и песочницы. Дана таблица из 13 инструментов сервера и пример конфигурации Claude Desktop. Раздел разработки показывает команды линтера, форматтера, проверки типов и тестов. Лицензия MIT.