MCP, CLI и модели Яндекс Директа с поиском действий
mcp-server-yandex-direct
MCP-сервер, CLI-утилита и Pydantic-модели для API v5 Яндекс Директа: 79 действий через два инструмента вместо 79 отдельных
- 1 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- 79 действий покрывают создание, изменение и архивацию кампаний, объявлений и ключевых слов
- Работает по боевому аккаунту, встроенного dry-run в README не описано
Установка
- Работает в
- Сервисы
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/mcp-server-yandex-directОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- 79 действий покрывают создание, изменение и архивацию кампаний, объявлений и ключевых слов
- Работает по боевому аккаунту, встроенного dry-run в README не описано
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Проект дает три способа работы с API v5 Директа поверх одной библиотеки типизированных Pydantic-моделей: MCP-сервер для Claude Code и других клиентов, CLI-утилиту для терминала и скриптов, и саму библиотеку моделей для своих Python-программ. Вместо 79 отдельных инструментов на каждое действие сервер использует паттерн search plus execute: yd_search находит нужное действие по описанию на естественном языке и возвращает его схему параметров, а yd_execute выполняет его по id. 79 действий сгруппированы по 16 доменам: кампании, группы, объявления, ключевые слова, ставки, аудитории, фиды, креативы, лиды, отслеживание изменений, аккаунт, турбо-страницы и отчеты. Все данные остаются на компьютере пользователя, токен никуда не передается, кроме API Яндекса.
Для кого. Для разработчиков, которым нужен и MCP-сервер для агента, и CLI для скриптов, и типизированные модели API v5 для своего Python-кода в одном пакете.
Подходит, если
- Нужен и агентский MCP-сервер, и обычная командная строка для автоматизации без модели
- Нужны типизированные Pydantic-модели Direct API для собственных Python-скриптов
- Модель модели путается в десятках инструментов: поиск действия по описанию проще, чем держать в контексте все 79
Не подходит, если
- Нужны отдельные именованные инструменты на каждое действие, а не поиск по описанию
- Не пишете на Python и библиотека моделей вам не нужна
- Нужна встроенная защита dry-run: README ее не описывает
Пример запроса к агенту
Найди действие для остановки кампаний и останови кампанию 12345MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
YD_TOKENобязательная, секрет- OAuth-токен Яндекс Директа
Ограничения
Нужен собственный OAuth-токен, полученный в разделе Настройки, API личного кабинета Директа. Паттерн search plus execute требует от модели сначала найти действие, а потом вызвать его: это два шага вместо одного прямого инструмента. Лицензия в репозитории не указана явно на уровне GitHub API.
Как отключить. Выполните claude mcp remove yandex-direct в Claude Code или удалите блок yandex-direct из конфигурации клиента.
Частые вопросы
Как модель находит нужное действие среди 79?
Инструмент yd_search принимает описание задачи на естественном языке, например «остановить кампании», и возвращает список подходящих действий со схемой параметров для yd_execute.
Можно ли использовать без MCP, просто из терминала?
Да, в пакете есть отдельная CLI-утилита для тех же 79 действий и библиотека Pydantic-моделей для своих Python-программ.
Обсуждение
Вопросов и отзывов пока нет.
MCP Яндекс Директа из машиночитаемой схемы
yandex-direct-mcp
MCP-сервер и CLI на всех 113 методах API v5 Яндекс Директа, собранных из WSDL: по умолчанию только 9 читающих, запись включается явно
MCP Яндекс Директа без зависимостей на Node
yandex-direct-mcp
MCP-сервер Direct API v5 одним файлом на Node.js без зависимостей, с инструментом direct_call на все сервисы API и режимом только для чтения
MCP Яндекс Директа с dry-run по умолчанию
Yandex Direct MCP Server
20 инструментов Яндекс Директа, где каждая правка по умолчанию только показывает план запроса и требует confirm=True для реальной отправки
MCP-сервер Яндекс Директа на Ruby
yandex-direct-mcp
MCP-сервер на чистом Ruby без зависимостей: 30 инструментов для кампаний, групп, объявлений, ключевых слов и отчетов Яндекс Директа
Yandex Direct MCP
yandex-direct-mcp
Плагин Claude Code и Codex для Яндекс Директа: MCP-сервер на 147 инструментов, OAuth и скиллы для объявлений и анализа статистики
MCP-сервер Яндекс Директа (npm)
@theyahia/yandex-direct-mcp
MCP-сервер на TypeScript с npm-пакетом: 20 инструментов для кампаний, ставок и минус-фраз Яндекс Директа, деньги везде в рублях
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| MCP, CLI и модели Яндекс Директа с поиском действий (эта карточка) | нет | API-ключ | 1 | |
| MCP-сервер Директа, Метрики, Wordstat и Вебмастера | нет | API-ключ | 0 | Метрика |
| MCP для Яндекс Директа на Python | нет | API-ключ | 0 | кампании, отчеты |
Коротко о README
README описывает архитектуру search plus execute с примером диалога поиска и выполнения действия, таблицу из 16 доменов с количеством действий в каждом и ссылками на подробную документацию, а также три отдельных раздела установки: MCP-сервер, CLI-утилита и библиотека моделей, каждый со своими примерами. Отдельно подчеркнуто, что все данные остаются локально и токен никуда не передается.