SkillFoxx
Telegram

MCP для Яндекс Директа и Вордстата на Python

Yandex.Direct MCP

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

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

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

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

  • Полный CRUD над кампаниями, группами и объявлениями в боевом режиме
  • Массово добавляет и обновляет ключевые слова и ставки
Все причины и проверки
Российский стек

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

Установка

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

git clone https://github.com/demokrat90/yandex-direct-mcp.git && cd yandex-direct-mcp && python -m venv .venv && pip install -r requirements.txt

Установка на Linux/macOS, для Windows команда активации venv другая.

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

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

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

  • Полный CRUD над кампаниями, группами и объявлениями в боевом режиме
  • Массово добавляет и обновляет ключевые слова и ставки

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

Что делает

Сервер дает 48 инструментов над Yandex.Direct API v5: полный CRUD и статусы для кампаний, групп и объявлений, добавление и обновление ключевых слов пачками, ставки и автотаргетинг, наборы минус-слов на уровне кампаний, быстрые ссылки и уточнения, статистику кампаний, отчет по поисковым запросам и произвольные отчеты, а также частотность ключевых фраз через Wordstat API v4. Один флаг YANDEX_DIRECT_SANDBOX переключает окружение между песочницей и боевым API, а отдельный скрипт get_yandex_token.py проводит через OAuth в браузере и сохраняет токен в .env. Есть переключение между несколькими аккаунтами в рантайме.

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

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

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

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

  • Нужен готовый npm-пакет без git clone и виртуального окружения Python
  • Нет доступа к боевому API Директа: полноценно попробовать можно только в песочнице
  • Нужна защита dry-run на каждом пишущем вызове: в README она не описана

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

Проверь частотность фразы «купить диван» через Вордстат и покажи текущие ставки по этой фразе в моих кампаниях

MCP

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

Переменные окружения

YANDEX_DIRECT_TOKEN обязательная, секрет
OAuth-токен Яндекс Директа
YANDEX_DIRECT_SANDBOX
true переключает сервер в песочницу

Ограничения

Требуется Python 3.10+ и одобренный доступ к API Директа для боевого режима. Для доступа к API нужна отдельная заявка, песочница работает сразу и не тратит баллы. Проект community, не продукт Яндекса.

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

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

Как получить токен?

Скрипт python scripts/get_yandex_token.py открывает браузер, после подтверждения доступа сохраняет токен прямо в .env.

Можно ли проверить подключение без боевых данных?

Да, python scripts/test_yandex_connection.py без флага работает в песочнице, а с флагом --prod проверяет боевой API.

Обсуждение

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

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

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

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

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

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

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

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

Пять MCP-серверов для API Яндекса: Вордстат, Поиск, Вебмастер, Метрика и Директ, плюс плагин со скиллами для Claude Code

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

MCP-сервер для Яндекс Директа, Метрики, Wordstat и Вебмастера: кампании, объявления, ставки, отчеты и подбор запросов из чата

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

Коротко о README

README дает пошаговую установку через git clone и виртуальное окружение, отдельный скрипт получения OAuth-токена в браузере, шаблоны конфигурации для Claude Desktop, Cursor и Claude Code и список из восьми групп возможностей от CRUD кампаний до Вордстата и работы с несколькими аккаунтами. Полная справка по API и форматам вынесена в docs/yandex-direct-api.md.

Бейдж для README

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