MCP для Яндекс Директа и Вордстата на Python
Yandex.Direct MCP
MCP-сервер на Python с 48 инструментами Яндекс Директа и частотностью Вордстата, с переключением между песочницей и боевым режимом
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Полный CRUD над кампаниями, группами и объявлениями в боевом режиме
- Массово добавляет и обновляет ключевые слова и ставки
Установка
Ручная установка
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 другая.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает 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 она не описана
Пример запроса к агенту
Проверь частотность фразы «купить диван» через Вордстат и покажи текущие ставки по этой фразе в моих кампанияхОграничения
Требуется Python 3.10+ и одобренный доступ к API Директа для боевого режима. Для доступа к API нужна отдельная заявка, песочница работает сразу и не тратит баллы. Проект community, не продукт Яндекса.
Как отключить. Удалите блок yandex-direct из конфигурации MCP клиента и остановите процесс сервера.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| YANDEX_DIRECT_TOKEN обязательная, секрет | OAuth-токен Яндекс Директа |
| YANDEX_DIRECT_SANDBOX | true переключает сервер в песочницу |
Проверка безопасности
- Полный CRUD над кампаниями, группами и объявлениями в боевом режиме
- Массово добавляет и обновляет ключевые слова и ставки
Коротко о README
README дает пошаговую установку через git clone и виртуальное окружение, отдельный скрипт получения OAuth-токена в браузере, шаблоны конфигурации для Claude Desktop, Cursor и Claude Code и список из восьми групп возможностей от CRUD кампаний до Вордстата и работы с несколькими аккаунтами. Полная справка по API и форматам вынесена в docs/yandex-direct-api.md.
Частые вопросы
Как получить токен?
Скрипт python scripts/get_yandex_token.py открывает браузер, после подтверждения доступа сохраняет токен прямо в .env.
Можно ли проверить подключение без боевых данных?
Да, python scripts/test_yandex_connection.py без флага работает в песочнице, а с флагом --prod проверяет боевой API.
Похожие
Скилл, который убирает из текста приметы ИИ-письма по списку Википедии и не добавляет выдуманных фактов
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 читающих, запись включается явно