Yandex Direct MCP
yandex-direct-mcp
Плагин Claude Code и Codex для Яндекс Директа: MCP-сервер на 147 инструментов, OAuth и скиллы для объявлений и анализа статистики
Установка
/plugin marketplace add etopro/plugin-marketplace
/plugin install yandex-direct@plugin-marketplaceЗатем в чате вызовите auth_login(). Перед этим один раз создайте OAuth-приложение Яндекса.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Плагин ставит локальный MCP-сервер, который работает через direct-cli и покрывает почти весь API Директа: кампании, группы, объявления, ключевые фразы и минус-слова, ставки и корректировки, стратегии, ретаргетинг, фиды, отчеты, цели Метрики, Wordstat и прогноз бюджета. Есть финансовые операции: баланс, пополнение, счета и переводы между аккаунтами. Три скилла помогают вести кампании, писать объявления в лимиты символов и проводить разведочный анализ статистики. Набор инструментов можно сузить профилем, например только аналитика, а Мастера кампаний читаются через браузер под управлением Playwright.
Для кого. Для специалистов по контекстной рекламе и владельцев бизнеса, которые ведут кампании в Яндекс Директе.
Подходит, если
- Нужно собрать статистику по кампаниям и найти дорогие объявления
- Нужно поменять ставки или отключить неэффективные объявления по правилу
- Нужно написать варианты объявлений в лимиты Директа
- Нужен анализ по устройствам, гео и поисковым запросам
Не подходит, если
- Аккаунт с большим бюджетом, где любое изменение должно проходить согласование
- Нужен только просмотр статистики и нет желания давать права на изменения
Пример запроса к агенту
Покажи кампании за последнюю неделю и найди объявления, где заявка дороже 1500 рублейОграничения
Перед первым входом нужно создать OAuth-приложение Яндекса с доступом direct:api и получить одобрение заявки на API в Директе, иначе запросы вернут incomplete_registration. Нужен Python 3.11. Для Мастеров кампаний требуются Playwright, Chromium и ручной вход в терминале. Плагин неофициальный.
Как отключить. Удалите плагин yandex-direct через /plugin. Сохраненная авторизация лежит в ~/.direct-cli/, профиль Мастеров удаляется командой direct masters logout.
Проверка безопасности
- Меняет ставки, бюджеты и статусы кампаний в рекламном аккаунте
- Содержит финансовые операции: пополнение, счета и переводы между аккаунтами
- Хранит OAuth-токен и живую сессию Яндекса
Коротко о README
README на русском начинается с установки через маркетплейс плагинов и входа в Яндекс. Перечислены группы возможностей, примеры запросов и способы подключения к Claude Code, Codex и другим MCP-клиентам. Подробно описано создание OAuth-приложения и заявки на API, профили для ограничения инструментов и отдельная браузерная авторизация для Мастеров кампаний. В конце таблица скиллов и команды разработки. Лицензия MIT.
SKILL.md
--- name: direct-ads description: "Написание рекламных объявлений для Яндекс.Директ. Используется когда пользователь просит написать, улучшить или проверить текст объявления, заголовки, или тексты для контекстной рекламы." user-invocable: true argument-hint: "[тема или описание рекламируемого продукта/услуги]" --- # Написание объявлений Яндекс.Директ Скилл для создания эффективных рекламных объявлений в Яндекс.Директ. ## Лимиты символов | Элемент | Максимум символов | |---|---| | Title (Заголовок) | 35 | | Title2 (Второй заголовок) | 30 | | Text (Текст объявления) | 81 | ## Правила написания ### Заголовок (Title) - Начинайте с главного предложения или УТП - Используйте цифры и конкретику: "Скидка 30%", "Доставка за 30 мин" - Включите гео если релевантно: "Пицца Москва" ### Второй заголовок (Title2) - Дополняйте первый заголовок - Добавьте призыв к действию: "Закажите сейчас" - Укажите дополнительные преимущества ### Текст объявления - Подробности о предложении - Условия доставки/оплаты - Гарантии и преимущества - Не повторяйте то, что уже в заголовках
Частые вопросы
Как ограничить агента только чтением статистики?
Задайте YANDEX_DIRECT_TOOL_PROFILE=analytics или выключите группы через YANDEX_DIRECT_DISABLED_GROUPS.
Почему запросы возвращают incomplete_registration?
Не одобрена заявка на доступ к API в интерфейсе Директа для Client ID вашего приложения.
Работает ли с Codex?
Да, в репозитории есть манифест маркетплейса .agents/plugins/marketplace.json и пакет плагина для Codex.
Похожие
Marketing Skills: маркетинговые скиллы для агентов
Marketing Skills for AI Agents
Около пятидесяти скиллов по CRO, копирайтингу, SEO, аналитике, рекламе и запуску продукта для кодовых агентов
Скилл, который убирает из текста приметы ИИ-письма по списку Википедии и не добавляет выдуманных фактов
Скиллы для контента: иллюстрации к статьям, обложки, инфографика, комиксы, перевод, конвертация URL в Markdown и публикация в соцсети
Китайская версия скилла Humanizer: находит и убирает приметы AI-текста в материалах на китайском