MCP Яндекс Директа без зависимостей на Node
yandex-direct-mcp
MCP-сервер Direct API v5 одним файлом на Node.js без зависимостей, с инструментом direct_call на все сервисы API и режимом только для чтения
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Пакетно меняет ставки по правилу и создает кампании и объявления
- Универсальный инструмент direct_call открывает доступ ко всем изменяющим методам API v5
Установка
Ручная установка
claude mcp add yandex-direct --scope user -- node "$PWD/server.js"Запуск после git clone, зависимостей и npm install не требуется.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер написан одним файлом на Node.js без единой зависимости, использует только встроенный fetch и транспорт stdio. Аналитика покрывает отчеты по любому срезу и периоду: кампании, группы, объявления, ключевые фразы, поисковые запросы, гео, устройства, время суток, пол и возраст, а также разбор поисковых запросов на мусор и поиск фраз с расходом без конверсий. Управление создает и правит кампании, группы, объявления, ключевые фразы, ставки и дневные бюджеты, в том числе пакетно по условию вроде «CPA выше 2000 рублей: снизить ставку на 20%», плюс минус-слова, паузы, отправка на модерацию, корректировки ставок и ретаргетинг. Универсальный инструмент direct_call покрывает все сервисы v5 целиком, от campaigns до keywordsresearch, а не только вынесенные в отдельные инструменты. Есть отдельный режим только для чтения, который блокирует изменяющие методы на уровне самого сервера, а не только клиента.
Для кого. Для тех, кто хочет минимальный по коду сервер Директа без зависимостей и с гарантированным режимом только чтения для повседневного мониторинга.
Подходит, если
- Нужен разбор поисковых запросов на мусор и поиск фраз с расходом без конверсий
- Нужны пакетные правила изменения ставок по условию CPA
- Нужен режим только чтения, который сервер сам не даст обойти, для регулярных сводок
Не подходит, если
- Нужна npm-установка одной командой: сервер ставится клонированием репозитория, без npm install
- Требуется одобренная заявка на доступ к API Директа, которую еще предстоит получить: без нее не работает даже песочница
- Нужны готовые интеграции вроде Click.ru: сервер работает только напрямую с API Директа
Пример запроса к агенту
Разбери поисковые запросы кампании за месяц, найди мусорные и предложи минус-словаОграничения
Без одобренной заявки на доступ к API не работает даже песочница: ошибка 58 приходит и от api-sandbox.direct.yandex.com. Рассмотрение заявки занимает от часа до трех суток, в пиковые периоды до семи дней. Токен хранится локально в файле с правами 600.
Как отключить. Удалите блок yandex-direct из конфигурации MCP клиента.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Проверка безопасности
- Пакетно меняет ставки по правилу и создает кампании и объявления
- Универсальный инструмент direct_call открывает доступ ко всем изменяющим методам API v5
Коротко о README
README ведет по порядку, в котором реально проходит подключение: сначала заявка на доступ к API с готовыми текстами для формы, затем скрипт получения токена, который прячет ввод и хранит файл с правами 600, и только потом сама установка сервера без npm install. Отдельно расписан пример утренней сводки расхода и еженедельного разбора запросов как регулярных задач для MCP-клиента с расписанием.
Частые вопросы
Можно ли отладиться в песочнице, пока заявка на рассмотрении?
Нет, README прямо проверяет это: api-sandbox.direct.yandex.com отдает ту же ошибку 58, что и боевой API, без одобренной заявки не работает вообще ничего.
Как включить режим только для чтения?
Отдельный режим на уровне самого сервера, а не клиента, README описывает его в разделе про аналитику и управление, детали смотри в docs/usage.md.
Похожие
Скилл, который убирает из текста приметы ИИ-письма по списку Википедии и не добавляет выдуманных фактов
Marketing Skills: маркетинговые скиллы для агентов
Marketing Skills for AI Agents
Около пятидесяти скиллов по CRO, копирайтингу, SEO, аналитике, рекламе и запуску продукта для кодовых агентов
MCP-сервер SendPulse
SendPulse MCP
Официальный удаленный MCP-сервер SendPulse: статистика, рассылки и данные пользователей через чат с агентом
MCP Яндекс Директа из машиночитаемой схемы
yandex-direct-mcp
MCP-сервер и CLI на всех 113 методах API v5 Яндекс Директа, собранных из WSDL: по умолчанию только 9 читающих, запись включается явно