Yandex Direct MCP

yandex-direct-mcp

Плагин Claude Code и Codex для Яндекс Директа: MCP-сервер на 147 инструментов, OAuth и скиллы для объявлений и анализа статистики

ПлагинВысокий рискРоссийский стек

axisrow/yandex-direct-mcp-plugin

Установка

/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.

Выбор редакции

Скилл, который убирает из текста приметы ИИ-письма по списку Википедии и не добавляет выдуманных фактов

СкиллНизкий риск48,2 тыс.

Скиллы для контента: иллюстрации к статьям, обложки, инфографика, комиксы, перевод, конвертация URL в Markdown и публикация в соцсети

СкиллВысокий риск25,9 тыс.

Китайская версия скилла Humanizer: находит и убирает приметы AI-текста в материалах на китайском

СкиллНизкий риск17,3 тыс.