Yandex Direct MCP

MCP-сервер для Yandex Direct API v5: управляйте контекстной рекламой из Claude, Cursor, Codex и других AI-клиентов на естественном языке.

Ассистент сам собирает данные из статистики, ключей, ставок и расширений, находит закономерности и вносит правки — то, что в веб-кабинете Директа приходится делать вручную и по одному экрану.

_{Настоящая MCP-сессия: реальный сервер, хендшейк и tools/call по stdio через официальный SDK; ответы Яндекс Директа — записанные фикстуры (docs/demo), поэтому демо воспроизводится без токена и сети — vhs docs/demo.tape.}

Быстрый старт

Два способа подключиться:

По URL, без установки — MCP-эндпоинт https://mcp.askads.ru/mcp: вставляете URL в клиент и входите через Яндекс в браузере, токены не нужны. Бесплатно, только чтение — статистика и аудит. → Подключение по URL

Локально через npx — полный доступ, включая правки ставок и бюджетов; токен хранится только у вас:

1. Получите токен — одна ссылка, токен покажется на странице.

2. Добавьте сервер — например, в Claude Code (другие клиенты):

   claude mcp add yandex-direct -e YANDEX_DIRECT_TOKEN=ваш_токен -- npx -y mcp-yandex-direct
   

3. Спросите ассистента: «Проанализируй мои кампании за неделю и предложи, что улучшить».

Что умеет

• Полное покрытие API v5 — частые объекты как удобные инструменты, всё остальное — через универсальный raw_request.
• Защита от случайных записей — универсальный raw_request блокирует любой не-read метод без confirmWrite=true; выделенные write-инструменты (ставки, бюджеты, минус-слова, статусы) проходят штатное подтверждение MCP-клиента перед вызовом.
• Деньги в валюте аккаунта — бюджеты и ставки на вход и на выход в той же валюте, что и кабинет (например, в рублях), без ручного пересчёта микроединиц.
• autoPaginate — проход всех страниц по курсору LimitedBy, без молчаливой обрезки на больших аккаунтах.
• get_quota — остаток дневной квоты API в Units (потрачено / осталось / лимит).
• get_balance — баланс единого счёта (сумма, доступно к переводу, валюта) через Live v4 AccountManagement — единственный метод API, отдающий баланс (в v5 его нет). Отрицательная сумма = задолженность.
• Устойчивость — ретраи на лимитах и 5xx с бэкоффом плюс режим песочницы (YANDEX_DIRECT_SANDBOX) для безопасных тестов.

Примеры запросов

Попросите ассистента на русском — например:

• «Какие ключевые фразы тратят бюджет, но не приносят кликов?»
• «Подними ставки до 3 ₽ на фразы с CTR выше 15%»
• «Найди id региона Москва и создай группу с таргетингом на Москву»
• «Поставь корректировку −20% на мобильные в кампании 708589088»

Пример: аудит кампании

Вы: Проанализируй кампанию ClearTranscriptBot за последнюю неделю и предложи, что улучшить.

Claude (вызывает get_statistics, list_keywords, get_callouts, get_sitelinks):

Кампания «EPK/Поиск — бот в Max и Telegram» за 7 дней:

Дата	Показы	Клики	CTR	Расход, ₽	Ср. клик, ₽
08.06	544	90	16.5%	782.50	8.69
09.06	456	70	15.4%	528.93	7.56
10.06	206	39	18.9%	254.48	6.53
11.06	198

... View full README on GitHub