Yandex MCP Server
MCP-сервер для Яндекс Директа, Метрики, Wordstat и Вебмастера: кампании, объявления, ставки, отчеты и подбор запросов из чата
Установка
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 или новее.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключает агента к API Директа v5, Метрики, Wordstat и Вебмастера v4. В Директе агент создает и меняет кампании, группы, объявления, ключевые фразы, ставки, корректировки, ретаргетинг, фиды и расширения, а также получает статистику. В Метрике управляет счетчиками, целями, сегментами, фильтрами и доступами, строит отчеты и загружает офлайн-конверсии и расходы. Wordstat дает частотность, динамику и распределение по регионам, Вебмастер показывает сайты, индекс качества и поисковые запросы.
Для кого. Для маркетологов и специалистов по контекстной рекламе, которые ведут кабинеты Директа и Метрики.
Подходит, если
- Нужно быстро посмотреть статистику кампаний и конверсии за период
- Нужно массово поставить на паузу кампании или поменять ставки
- Нужно собрать частотность и динамику запросов в Wordstat
Не подходит, если
- Нет доступа к API Директа: заявку нужно одобрить в кабинете
- Агенту нельзя доверять изменения в боевом кабинете без проверки
Пример запроса к агенту
Покажи расход и конверсии по цели Заявка во всех активных кампаниях за прошлую неделюОграничения
Нужен OAuth-токен Яндекса с правами direct:api, metrika:read и metrika:write, а для Wordstat отдельный API-ключ сервисного аккаунта Yandex Cloud. Инструменты удаления кампаний, объявлений и счетчиков необратимы, режима только для чтения в сервере нет, для проверок есть песочница Директа. Установка только из клона репозитория.
Как отключить. Удалите блок yandex из конфигурации MCP клиента и отзовите OAuth-токен на oauth.yandex.ru.
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-токены с правами записи
Коротко о README
README на английском, есть русская версия. Он перечисляет возможности по каждому API и приводит полные таблицы инструментов с описаниями. Быстрый старт состоит из клонирования, установки пакета, получения токена на oauth.yandex.ru и добавления сервера в конфигурацию клиента. Отдельно описаны переменные окружения, запуск через MCP Inspector, структура пакета и рекомендации по безопасности. Лицензия MIT.
Частые вопросы
Можно ли вести агентские аккаунты?
Да, логин клиента задается переменной YANDEX_CLIENT_LOGIN.
Почему Wordstat не работает с OAuth-токеном?
Старый OAuth API Wordstat отключен, сервер использует Search API v2 и ключ сервисного аккаунта Yandex Cloud.
Похожие
Плагин Claude Code для SEO-аудита: технический SEO, E-E-A-T, schema, локальный и AI-поиск силами параллельных агентов
Набор скиллов Claude Code для аудита сайта под AI-поиск: цитируемость, доступ AI-краулеров, llms.txt, разметка и отчеты
Экспериментальный официальный MCP-сервер Google Analytics 4: отчеты, воронки и данные реального времени по запросу агенту
Google Search Console MCP
Google Search Console MCP Server for SEOs
MCP-сервер для Google Search Console: запросы и страницы с кликами и позициями, проверка индексации URL, сайтмапы и готовые SEO-скиллы