Yandex Direct

Yandex Direct

dontsovcmc
1 форков
MCP-сервер для Yandex Direct API v5. Подключает AI-ассистентов к управлению рекламными кампаниями: объявлениями, ставками, ключевыми словами и аудиториями. Все команды проходят через единый интерфейс без множества отдельных инструментов. Архитектура построена на паттерне «поиск + выполнение». Доступно два инструмента: yd_search ищет нужное действие по описанию на естественном языке, а yd_execute запускает его по ID. Всего сервер поддерживает 79 различных действий API. Помимо MCP-сервера, пакет включает CLI-утилиту для работы из терминала и библиотеку Pydantic-моделей для интеграции в ваши Python-приложения. Токен доступа хранится на вашем компьютере и не передаётся на сторону.
РазработкаЯндекс
Подключить MCPОткрыть на GitHub
Подключение

Подключить Yandex Direct

Выберите способ запуска и свой MCP-клиент. Ниже останется одна готовая инструкция, которую можно проверить и скопировать.

1

Способ подключения

2

Куда подключить

3

Скопируйте и проверьте

Claude Desktop / Claude Code

Клиент запускает MCP-сервер как локальный процесс.

  1. 1.Откройте настройки MCP в Claude.
  2. 2.Добавьте сервер с указанной командой и переменными окружения.
  3. 3.Перезапустите Claude, если сервер не появился автоматически.
json
{
  "mcpServers": {
    "yandex-direct": {
      "command": "uvx",
      "args": [
        "mcp-server-yandex-direct"
      ]
    }
  }
}

Сгенерировано из существующей команды запуска. Желательно сверить с README.

Инструкция собрана из данных карточки и пока не отмечена как проверенная редакцией. Сверьте команду с README источника и не передавайте лишние права или секреты.

Как оценить Yandex Direct

Yandex Direct относится к Разработка, Яндекс. Ниже собраны проверяемые признаки, по которым его можно сравнить с другими серверами каталога.

Происхождение
Проект сообщества
Лицензия
Не указана
Реализация
Python
Транспорт
stdio

Что проверить перед выбором

  • Изучите README, открытые issues и историю последних изменений в репозитории.
  • Проверьте команду установки и зависимости перед запуском в рабочем окружении.
  • Ограничьте доступ MCP-сервера только нужными файлами, API и переменными окружения.

Карточка отредактирована 20.07.2026.

Автоматическая проверка источника ещё не выполнена. Внешних источников в карточке: 1.

Характеристики

Общее

  • СтатусСообщество
  • Разработчикdontsovcmc

Технологии

  • Языки
    Python
  • Транспорт
    stdio

Описание

Возможности

  • Поиск действий по описанию на русском или английском языке через yd_search
  • Выполнение любого из 79 методов API v5 по ID через yd_execute
  • Управление рекламными кампаниями: создание, изменение бюджета, остановка, архивирование
  • Создание и редактирование текстовых, графических и динамических объявлений
  • Массовое изменение ставок для ключевых слов и аудиторных таргетингов
  • Настройка минус-слов на уровне кампании и группы
  • Управление списками ретаргетинга и аудиторными сегментами
  • Получение детальной статистики и отчётов по показам, кликам и конверсиям
  • Автоматизация массовых операций: изменение статусов и стратегий для групп кампаний
  • Работа в обход MCP: использование CLI и Python-моделей в скриптах автоматизации

Как подключить

  1. Установите сервер через uvx. Если пакетный менеджер uv ещё не установлен, скачайте его с официального сайта. Затем выполните в терминале: uvx mcp-server-yandex-direct
  2. Получите токен доступа к Яндекс.Директу и укажите его в переменной окружения YANDEX_DIRECT_TOKEN. По желанию задайте логин (YANDEX_DIRECT_LOGIN) и логин клиента (YANDEX_DIRECT_CLIENT_LOGIN).
  3. Пропишите конфигурацию в MCP-клиенте. Для Claude Desktop отредактируйте claude_desktop_config.json: { "mcpServers": { "yandex-direct": { "command": "uvx", "args": ["mcp-server-yandex-direct"], "env": { "YANDEX_DIRECT_TOKEN": "ваш_токен" } } } }
  4. Перезапустите клиент. Ассистент получит доступ к инструментам yd_search и yd_execute.

Примеры запросов

  • «Найди действие, которое останавливает рекламную кампанию» — запускает yd_search.
  • «Останови кампанию с id 12345 действием campaigns-suspend» — выполняет yd_execute.
  • «Покажи статистику по кампании 67890 за последние 7 дней» — формирует и отправляет запрос к отчёту.
  • «Увеличь дневной бюджет для кампании 11111 на 20%» — ассистент найдёт нужное действие и выполнит его.
  • «Создай новую группу с минус-словами в кампании 22222» — создание группы со списком минус-слов.

Технические детали

  • Язык разработки: Python
  • Транспорт: stdio
  • Лицензия: MIT (открытый исходный код)
  • Совместимость: Claude Desktop, Claude Code, любые MCP-клиенты с stdio
  • Версия API: Yandex Direct API v5
  • Дополнительно: CLI-утилита, Pydantic-модели для Python

Поделиться