SkillFoxx
Telegram

MCP-сервер Яндекс Директа на Ruby

yandex-direct-mcp

MCP-сервер на чистом Ruby без зависимостей: 30 инструментов для кампаний, групп, объявлений, ключевых слов и отчетов Яндекс Директа

  • 6 ★ репозитория
  • Последний коммит
  • MIT
MCP-сервер

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

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

  • Создает, изменяет и архивирует реальные рекламные кампании и объявления
  • Управляет ставками и бюджетом кампаний, ошибка агента приводит к реальным тратам
Все причины и проверки
Российский стек

vtka/yandex-direct-mcpАвтор:vtka

Установка

Ручная установка

{
  "mcpServers": {
    "yandex-direct": {
      "command": "ruby",
      "args": ["/path/to/yandex-direct-mcp/bin/server"],
      "env": {
        "YANDEX_DIRECT_TOKEN": "your_oauth_token"
      }
    }
  }
}

Добавить в .mcp.json проекта или в глобальный ~/.claude.json.

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

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

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

  • Создает, изменяет и архивирует реальные рекламные кампании и объявления
  • Управляет ставками и бюджетом кампаний, ошибка агента приводит к реальным тратам

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер оборачивает API v5 Яндекс Директа в 30 инструментов MCP, разбитых на шесть групп: кампании (создание, изменение, архивация, приостановка), группы объявлений с гео-таргетингом и минус-словами, текстово-графические объявления с модерацией, ключевые слова и ставки, отчеты по кампаниям и поисковым запросам, справочники регионов, валют и интересов аудитории. Сервер написан на чистом Ruby без внешних зависимостей и запускается локальным процессом через stdio. Есть песочный режим на переменной YANDEX_DIRECT_SANDBOX для тестов без реальных трат.

Для кого. Для рекламодателей и агентств, которые хотят вести кампании Яндекс Директа прямо из переписки с агентом.

Подходит, если

  • Нужно создавать и редактировать кампании, группы и объявления командами на естественном языке
  • Нужен единый MCP без внешних зависимостей, только Ruby на машине
  • Нужно протестировать сценарии на песочнице перед реальными тратами

Не подходит, если

  • Кампании созданы через упрощенный мастер (SMB): такие кампании API не видит
  • Нужна загрузка локальных изображений напрямую: сервер принимает только URL или base64

Пример запроса к агенту

Создай кампанию в Яндекс Директе на продвижение книги с бюджетом 500 рублей в день

MCP

Транспорт
stdio
Авторизация
API-ключ

Переменные окружения

YANDEX_DIRECT_TOKEN обязательная, секрет
OAuth-токен приложения Яндекс Директа
YANDEX_DIRECT_SANDBOX
Включает тестовый API без реальных трат

Ограничения

Нужен OAuth-токен Яндекс Директа и отдельная заявка на полный доступ к API через раздел Инструменты, без нее API возвращает ошибку 58 о незавершенной регистрации. Быстрые ссылки можно создать через API, но привязать их к объявлению только через веб-интерфейс. Для текстово-графических объявлений нужно горизонтальное изображение не менее 1080x607. Требуется установленный Ruby, готового npm или docker-пакета нет.

Как отключить. Удалите блок yandex-direct из .mcp.json проекта или из глобального ~/.claude.json.

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

Нужны ли внешние библиотеки?

Нет, сервер написан на чистом Ruby без зависимостей, кроме самого Ruby.

Можно потестировать без реальных денег?

Да, песочный режим включается переменной YANDEX_DIRECT_SANDBOX и использует тестовый API Директа.

Обсуждение

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

Яндекс Директ — все инструменты
Российский стек

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

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

MCP-сервер Direct API v5 одним файлом на Node.js без зависимостей, с инструментом direct_call на все сервисы API и режимом только для чтения

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

MCP-сервер на Python с 48 инструментами Яндекс Директа и частотностью Вордстата, с переключением между песочницей и боевым режимом

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

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

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

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

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

Альтернативы

Инструменты других авторов для тех же задач.

Коротко о README

README перечисляет 30 инструментов по шести сервисам, шаги получения OAuth-токена и обязательной заявки на доступ к API, конфигурацию для Claude Code и Claude Desktop, ограничения API (SMB-кампании не видны, быстрые ссылки только через интерфейс, требования к изображениям) и песочный режим для тестов. Указана лицензия MIT.

Бейдж для README

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