SkillFoxx
Telegram

MCP Яндекс Директа без зависимостей на Node

yandex-direct-mcp

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

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

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

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

  • Пакетно меняет ставки по правилу и создает кампании и объявления
  • Универсальный инструмент direct_call открывает доступ ко всем изменяющим методам API v5
Все причины и проверки
Российский стек

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

Установка

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

claude mcp add yandex-direct --scope user -- node "$PWD/server.js"

Запуск после git clone, зависимостей и npm install не требуется.

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

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

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

  • Пакетно меняет ставки по правилу и создает кампании и объявления
  • Универсальный инструмент direct_call открывает доступ ко всем изменяющим методам API v5

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

Что делает

Сервер написан одним файлом на Node.js без единой зависимости, использует только встроенный fetch и транспорт stdio. Аналитика покрывает отчеты по любому срезу и периоду: кампании, группы, объявления, ключевые фразы, поисковые запросы, гео, устройства, время суток, пол и возраст, а также разбор поисковых запросов на мусор и поиск фраз с расходом без конверсий. Управление создает и правит кампании, группы, объявления, ключевые фразы, ставки и дневные бюджеты, в том числе пакетно по условию вроде «CPA выше 2000 рублей: снизить ставку на 20%», плюс минус-слова, паузы, отправка на модерацию, корректировки ставок и ретаргетинг. Универсальный инструмент direct_call покрывает все сервисы v5 целиком, от campaigns до keywordsresearch, а не только вынесенные в отдельные инструменты. Есть отдельный режим только для чтения, который блокирует изменяющие методы на уровне самого сервера, а не только клиента.

Для кого. Для тех, кто хочет минимальный по коду сервер Директа без зависимостей и с гарантированным режимом только чтения для повседневного мониторинга.

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

  • Нужен разбор поисковых запросов на мусор и поиск фраз с расходом без конверсий
  • Нужны пакетные правила изменения ставок по условию CPA
  • Нужен режим только чтения, который сервер сам не даст обойти, для регулярных сводок

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

  • Нужна npm-установка одной командой: сервер ставится клонированием репозитория, без npm install
  • Требуется одобренная заявка на доступ к API Директа, которую еще предстоит получить: без нее не работает даже песочница
  • Нужны готовые интеграции вроде Click.ru: сервер работает только напрямую с API Директа

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

Разбери поисковые запросы кампании за месяц, найди мусорные и предложи минус-слова

MCP

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

Ограничения

Без одобренной заявки на доступ к API не работает даже песочница: ошибка 58 приходит и от api-sandbox.direct.yandex.com. Рассмотрение заявки занимает от часа до трех суток, в пиковые периоды до семи дней. Токен хранится локально в файле с правами 600.

Как отключить. Удалите блок yandex-direct из конфигурации MCP клиента.

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

Можно ли отладиться в песочнице, пока заявка на рассмотрении?

Нет, README прямо проверяет это: api-sandbox.direct.yandex.com отдает ту же ошибку 58, что и боевой API, без одобренной заявки не работает вообще ничего.

Как включить режим только для чтения?

Отдельный режим на уровне самого сервера, а не клиента, README описывает его в разделе про аналитику и управление, детали смотри в docs/usage.md.

Обсуждение

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

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

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

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

20 инструментов Яндекс Директа, где каждая правка по умолчанию только показывает план запроса и требует confirm=True для реальной отправки

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

Форк популярного MCP-сервера Яндекс Директа с чтением по умолчанию и явными флагами для записи и финансов

MCP-серверШирокий доступ
Выбор редакции

MCP-сервер и CLI на всех 113 методах API v5 Яндекс Директа, собранных из WSDL: по умолчанию только 9 читающих, запись включается явно

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

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

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

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

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

Коротко о README

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

Бейдж для README

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