Yandex Direct MCP — плагин

yandex-direct-mcp

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

  • 14 ★ репозитория
  • Последний коммит
  • MIT
Плагин

Широкий доступ

Почему такой уровень

  • Меняет ставки, бюджеты и статусы кампаний в рекламном аккаунте
  • Содержит финансовые операции: пополнение, счета и переводы между аккаунтами
  • Хранит OAuth-токен и живую сессию Яндекса
Все причины и проверки
Российский стек

axisrow/yandex-direct-mcp-plugin

Установка

Работает в

В терминале, через SkillFoxx CLI

npx skillfoxx add plugins/yandex-direct-mcp

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Меняет ставки, бюджеты и статусы кампаний в рекламном аккаунте
  • Содержит финансовые операции: пополнение, счета и переводы между аккаунтами
  • Хранит 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.

Частые вопросы

Как ограничить агента только чтением статистики?

Задайте YANDEX_DIRECT_TOOL_PROFILE=analytics или выключите группы через YANDEX_DIRECT_DISABLED_GROUPS.

Почему запросы возвращают incomplete_registration?

Не одобрена заявка на доступ к API в интерфейсе Директа для Client ID вашего приложения.

Работает ли с Codex?

Да, в репозитории есть манифест маркетплейса .agents/plugins/marketplace.json и пакет плагина для Codex.

Обсуждение

Вопросов и отзывов пока нет.

Российский стек

Пять MCP-серверов для Поиска, Wordstat, Вебмастера, Метрики и Директа, собранные в плагин Claude Code с двумя скиллами

ПлагинШирокий доступ19Звезды репозитория
Российский стек

MCP-сервер для Яндекс Директа, Метрики, Wordstat и Вебмастера: кампании, объявления, ставки, отчеты и подбор запросов из чата

MCP-серверШирокий доступ58Звезды репозитория
Российский стек

Форк популярного MCP-сервера Яндекс Директа с чтением по умолчанию и явными флагами для записи и финансов

MCP-серверШирокий доступ
Российский стек

Плагин Codex и Claude Code со скиллами и MCP для Яндекс Директа, Метрики, Wordstat v2, Roistat, amoCRM и Yandex Search API

ПлагинШирокий доступ21Звезды репозитория
Российский стек

MCP-сервер для Яндекс Директа, Метрики, Аудиторий и Wordstat с режимом только чтения и подтверждением изменений

MCP-серверШирокий доступ47Звезды репозитория
Российский стек

MCP-сервер на TypeScript с npm-пакетом: 20 инструментов для кампаний, ставок и минус-фраз Яндекс Директа, деньги везде в рублях

MCP-серверШирокий доступ4Звезды репозитория

Коротко о README

README на русском начинается с установки через маркетплейс плагинов и входа в Яндекс. Перечислены группы возможностей, примеры запросов и способы подключения к Claude Code, Codex и другим MCP-клиентам. Подробно описано создание OAuth-приложения и заявки на API, профили для ограничения инструментов и отдельная браузерная авторизация для Мастеров кампаний. В конце таблица скиллов и команды разработки. Лицензия MIT.

Бейдж для README

Исходный SKILL.md

---
name: direct-ads
description: "Написание рекламных объявлений для Яндекс.Директ. Используется когда пользователь просит написать, улучшить или проверить текст объявления, заголовки, или тексты для контекстной рекламы."
user-invocable: true
argument-hint: "[тема или описание рекламируемого продукта/услуги]"
---

# Написание объявлений Яндекс.Директ

Скилл для создания эффективных рекламных объявлений в Яндекс.Директ.

## Лимиты символов

| Элемент | Максимум символов |
|---|---|
| Title (Заголовок) | 35 |
| Title2 (Второй заголовок) | 30 |
| Text (Текст объявления) | 81 |

## Правила написания

### Заголовок (Title)
- Начинайте с главного предложения или УТП
- Используйте цифры и конкретику: "Скидка 30%", "Доставка за 30 мин"
- Включите гео если релевантно: "Пицца Москва"

### Второй заголовок (Title2)
- Дополняйте первый заголовок
- Добавьте призыв к действию: "Закажите сейчас"
- Укажите дополнительные преимущества

### Текст объявления
- Подробности о предложении
- Условия доставки/оплаты
- Гарантии и преимущества
- Не повторяйте то, что уже в заголовках

Сообщить о проблеме

Foxx AIYandex Direct MCP
Foxx AI

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.