Yandex MCP Server
MCP-сервер для Яндекс Директа, Метрики, Wordstat и Вебмастера: кампании, объявления, ставки, отчеты и подбор запросов из чата
- 58 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Меняет ставки, бюджеты и стратегии, то есть расходует рекламные деньги
- Может безвозвратно удалять кампании, объявления и счетчики
- Хранит OAuth-токены с правами записи
Установка
- Работает в
- Сервисы
Ручная установка
git clone https://github.com/SvechaPVL/yandex-mcp.git
cd yandex-mcp
python -m venv .venv
source .venv/bin/activate
pip install -e .Нужен Python 3.10 или новее.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Меняет ставки, бюджеты и стратегии, то есть расходует рекламные деньги
- Может безвозвратно удалять кампании, объявления и счетчики
- Хранит OAuth-токены с правами записи
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключает агента к API Директа v5, Метрики, Wordstat и Вебмастера v4. В Директе агент создает и меняет кампании, группы, объявления, ключевые фразы, ставки, корректировки, ретаргетинг, фиды и расширения, а также получает статистику. В Метрике управляет счетчиками, целями, сегментами, фильтрами и доступами, строит отчеты и загружает офлайн-конверсии и расходы. Wordstat дает частотность, динамику и распределение по регионам, Вебмастер показывает сайты, индекс качества и поисковые запросы.
Для кого. Для маркетологов и специалистов по контекстной рекламе, которые ведут кабинеты Директа и Метрики.
Подходит, если
- Нужно быстро посмотреть статистику кампаний и конверсии за период
- Нужно массово поставить на паузу кампании или поменять ставки
- Нужно собрать частотность и динамику запросов в Wordstat
Не подходит, если
- Нет доступа к API Директа: заявку нужно одобрить в кабинете
- Агенту нельзя доверять изменения в боевом кабинете без проверки
Пример запроса к агенту
Покажи расход и конверсии по цели Заявка во всех активных кампаниях за прошлую неделюMCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
YANDEX_TOKENобязательная, секрет- OAuth-токен Яндекса для Директа и Метрики
YANDEX_DIRECT_TOKENсекрет- Отдельный токен для Директа
YANDEX_METRIKA_TOKENсекрет- Отдельный токен для Метрики
YANDEX_CLIENT_LOGIN- Логин клиента для агентских аккаунтов
YANDEX_USE_SANDBOX- true включает песочницу Директа
YANDEX_WORDSTAT_API_KEYсекрет- API-ключ сервисного аккаунта Yandex Cloud для Wordstat
YANDEX_CLOUD_FOLDER_ID- ID каталога Yandex Cloud для Search API
Ограничения
Нужен OAuth-токен Яндекса с правами direct:api, metrika:read и metrika:write, а для Wordstat отдельный API-ключ сервисного аккаунта Yandex Cloud. Инструменты удаления кампаний, объявлений и счетчиков необратимы, режима только для чтения в сервере нет, для проверок есть песочница Директа. Установка только из клона репозитория.
Как отключить. Удалите блок yandex из конфигурации MCP клиента и отзовите OAuth-токен на oauth.yandex.ru.
Частые вопросы
Можно ли вести агентские аккаунты?
Да, логин клиента задается переменной YANDEX_CLIENT_LOGIN.
Почему Wordstat не работает с OAuth-токеном?
Старый OAuth API Wordstat отключен, сервер использует Search API v2 и ключ сервисного аккаунта Yandex Cloud.
Обсуждение
Вопросов и отзывов пока нет.
MCP-сервер от ZAI.ONE сводит Директ, Метрику, поиск, Wordstat и Вебмастер в одном агенте, с мастером настройки и включаемыми пишущими операциями
MCP-сервер для Яндекс Директа, Метрики, Аудиторий и Wordstat с режимом только чтения и подтверждением изменений
MCP-сервер для аналитики Директа, Метрики, Wordstat и Аудиторий: сырые отчеты, сопоставление данных и HTML-дашборд
MCP для Директа, Метрики, Wordstat и Вебмастера
yandex-marketing-mcp
MCP-сервер на 155 инструментов для Яндекс Директа, Метрики, Wordstat и Вебмастера с самонастройкой OAuth и режимами read-only и confirm
MCP-сервер Директа, Метрики, Wordstat и Вебмастера
Yandex MCP Server
MCP-сервер со 141 инструментом: полное управление кампаниями Директа, счетчиками и целями Метрики, Wordstat и Вебмастер
Пять MCP-серверов для Поиска, Wordstat, Вебмастера, Метрики и Директа, собранные в плагин Claude Code с двумя скиллами
Коротко о README
README на английском, есть русская версия. Он перечисляет возможности по каждому API и приводит полные таблицы инструментов с описаниями. Быстрый старт состоит из клонирования, установки пакета, получения токена на oauth.yandex.ru и добавления сервера в конфигурацию клиента. Отдельно описаны переменные окружения, запуск через MCP Inspector, структура пакета и рекомендации по безопасности. Лицензия MIT.