yandex-direct

yandex-direct

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

Установка

uvx mcp-server-yandex-direct

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

Общее

  • СтатусСообщество
  • Разработчик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

Поделиться