MCP-сервер Директа, Метрики, Wordstat и Вебмастера

Установка

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

git clone https://github.com/seklekov/yandex-direct-mcp.git && cd yandex-mcp && python -m venv .venv && source .venv/bin/activate && pip install -e .

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

Что делает

Сервер на Python дает 141 инструмент по четырем API Яндекса. Директ (80 инструментов) покрывает полный цикл: создание, паузу, архивирование и удаление кампаний, групп и объявлений всех типов, ставки и корректировки, ретаргетинг, смарт-баннеры, визитки, фиды, видео и статистику. Метрика (43 инструмента) управляет счетчиками, целями, сегментами, фильтрами, правами доступа, загружает офлайн-конверсии, звонки и расходы. Wordstat (5 инструментов) отдает частотность и динамику запросов и регионы. Вебмастер (13 инструментов) добавляет и проверяет сайты, отправляет URL на переобход и читает популярные запросы. Инструменты create, update и delete есть почти везде: сервер умеет и читать, и менять кампании и счетчики напрямую.

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

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

Поставь на паузу кампанию Летняя распродажа и подними ставку на ключевое слово купить айфон до 60 рублей

Ограничения

Пакет не публикуется в PyPI, устанавливается клонированием и pip install -e. Wordstat работает только через новый Search API v2 с ключом сервисного аккаунта Yandex Cloud, старый OAuth Wordstat закрыт. Метрика умеет удалять счетчик целиком со всеми данными: инструмент metrika_delete_counter необратим.

Как отключить. Удалите сервер yandex из настроек MCP клиента и остановите процесс или контейнер.

MCP

Транспорт

stdio

Авторизация

API-ключ

Проверка безопасности

• Создает, останавливает и удаляет кампании, объявления и ключевые слова напрямую в боевом Директе
• metrika_delete_counter удаляет счетчик Метрики со всей историей данных без возможности восстановить
• Начинайте с YANDEX_USE_SANDBOX=true и токена с минимальными правами, пока не убедитесь в поведении агента

Коротко о README

README на английском (есть README.ru.md) перечисляет все 141 инструмент по четырем API с разбивкой на подгруппы вроде кампаний, объявлений, ставок, ретаргетинга и фидов, дает переменные окружения для раздельных токенов Директа и Метрики, примеры фраз пользователя, три способа запуска включая Docker, и раздел безопасности с советом использовать песочницу и минимальные права токена.

Похожие