Плагин «Яндекс.Директ» для MCP

Яндекс.Директ в руках ИИ-агента: ставки, бюджеты, поисковые запросы

Плагин к приложению MCP открывает рекламный аккаунт Яндекс.Директа для ИИ-агентов по протоколу Model Context Protocol. Claude, Cursor или свой скрипт подключаются и разбирают рекламу сами: где уходят деньги, какие фразы их съедают, по каким запросам показываются объявления и во сколько обойдётся следующая ступень аукциона. Шестьдесят три инструмента: тридцать один читает, двадцать пять меняют, шесть создают, один удаляет. Каждое изменение — только по подтверждению.

Структура аккаунта

Кампании с остатком средств, дневным бюджетом и стратегией показов. Группы с регионами и минус-словами. Объявления с заголовками, текстами и пояснением, за что отклонены модерацией. Ключевые фразы со ставками и продуктивностью.

Статистика

Показы, клики, CTR, расход и цена клика — по кампаниям и по условиям показа, за любой период или по дням. Со средней ставкой с учётом всех корректировок и объёмом трафика, который фраза получала на самом деле.

Торги и аукцион

Текущая ставка вместе с лесенкой аукциона: сколько стоит каждый объём трафика на поиске и какой охват даёт ставка в сетях. Тот самый ответ на вопрос «а сколько нужно, чтобы показываться выше».

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

Что люди на самом деле набирали в Яндексе и по какой фразе это показалось. Расхождение между запросом и фразой — обычно и есть то, за что платят зря. Отсюда берутся минус-слова.

Плагин меняет рекламу, а удаляет только по отдельному праву

Ставки и бюджеты, остановка и возобновление показов на трёх уровнях, минус-фразы кампании и группы — и добавить, и снять, — общие наборы минус-фраз с привязкой и отвязкой, тексты и заголовки объявлений, цена, изображения, быстрые ссылки, уточнения и контакты под объявлением, регионы групп, параметры URL и ключевые цели кампании, запрещённые площадки и IP-адреса, корректировки ставок, аудитории и ретаргетинг, товарные фиды, настройка автотаргетинга. Новые кампании, группы, объявления и фразы создаются черновиками — до отправки на модерацию их видно в интерфейсе Директа и можно переделать руками.

Удаление собрано в один инструмент с отдельным правом «Удаление без возврата» — по умолчанию агент его не видит. Удалённая группа не восстанавливается вовсе, а остановленная возвращается в работу одним вызовом со своей статистикой и ставкой, поэтому агент сначала предлагает остановку или архив и удаляет только то, что остановить нельзя: лишнюю фразу, набор быстрых ссылок, старое изображение.

Все пишущие и создающие инструменты требуют подтверждения прямо в вызове: без него агент получает отказ и объяснение, что именно изменится. «Подними ставку» из разговора не срабатывает с первой фразы.

Изменение видно целиком: было и стало

Отчёт об изменении — не «готово», а прежнее значение рядом с новым: какие минус-фразы уже стояли и какой список получился, какие регионы были у группы, какие заголовки заменены. Через час никто не вспомнит, что там стояло до правки, а по такому ответу видно.

Там, где API заменяет список целиком, инструмент об этом предупреждает вместо того, чтобы молча потерять данные. Прислать один заголовок объявлению, у которого их семь, — отказ с перечислением того, что было бы потеряно; заменить набор осознанно можно отдельной формой вызова.

Агент не поднимет ставку вслепую

Директ отдаёт не только текущую ставку, но и всю лесенку аукциона: чтобы получать 62 % трафика по фразе, ставка должна быть такой-то, чтобы 100 % — такой-то. Разница между соседними ступенями нелинейна, и последние проценты трафика стоят кратно дороже предыдущих.

Плагин отдаёт эту таблицу целиком и отдельно показывает списываемую цену — она обычно ниже ставки. Разговор «поднимем ставку, чтобы показываться выше» начинается с того, во сколько обойдётся следующая ступень, а не с догадки.

И не станет менять то, что менять бессмысленно

На автоматических стратегиях Директ считает ставки сам и назначенную руками либо отклоняет, либо принимает и не применяет. Модель, которая этого не знает, уверенно отчитается об изменении, которого не произошло.

Поэтому в карточке каждой кампании есть готовый признак: ручное управление ставками — да или нет. Где ставка неуправляема, там разговор идёт про цели, недельный бюджет и приоритеты фраз, а не про ставку.

Вы решаете, что агенту можно

У каждого инструмента своё право, права собраны в десять групп. Выдавая токен в приложении MCP, вы отмечаете нужные — и агент физически не видит остальных инструментов.

Кампании и статистика — тридцать инструментов: аккаунт, структура, корректировки ставок, торги, проверка спроса и дубли фраз, отчёты, поисковые запросы, изображения, креативы, фиды, Турбо-страницы и заявки с форм, аудитории, справочники
Произвольный отчёт — один инструмент для любых полей по справочнику API, отдельным правом
Ставки — ставки фразам, группам и кампаниям, ставки аудиторий, корректировки по устройствам, полу, возрасту и регионам
Бюджеты — дневной бюджет кампании: прямой ограничитель расхода
Остановка и возобновление показов — кампания, объявление, фраза, аудитория, автотаргетинг, архив: обратимая замена удалению
Минус-фразы — списки кампании и группы, общие наборы; добавление и снятие разведены по разным вызовам
Объявления и дополнения — тексты, заголовки и цена, быстрые ссылки, уточнения, загрузка изображений
Структура кампании — регионы и минус-фразы групп, счётчики Метрики, ключевые цели и параметры URL, запрещённые площадки и IP-адреса, аудитории групп, фиды, настройки рекламодателя, тексты фраз
Создание черновиков — новые кампании, группы, объявления и фразы, условия ретаргетинга
Удаление без возврата — один инструмент на все объекты, отдельным правом

Права на чтение и права на изменение выдаются раздельно: агенту-аналитику можно отдать всю статистику, не давая ему ни одной ручки. Разбор аккаунта, ведение и создание кампании — три разные роли, и права под них собираются по отдельности.

Агент знает подводные камни Директа

Вместе с инструментами плагин отдаёт агенту страницу документации — MCP-клиент читает её сам. В ней ровно то, обо что спотыкаются модели:

ставка и списываемая цена — разные величины, и в отчёте есть третья, средняя ставка с корректировками
у API суточный лимит баллов, общий на все вызовы: отчёт по всем фразам за год стоит дорого и всё равно приедет обрезанным
поисковые запросы хранятся только за последние 180 дней, обычная статистика — за всё время
большие отчёты Директ ставит в очередь, и правильная реакция — повторить тот же вызов, а не заказать новый
автотаргетинг приходит в списке фраз отдельной строкой со своей ставкой и статистикой: расход, не сходящийся с суммой по фразам, обычно забрал он
у объявления две модели — привычная пара заголовков и комбинаторная, до семи заголовков вариантами; какая перед агентом, плагин определяет сам

Отказы плагин тоже переводит на человеческий: «токен отозван», «нет прав на эти данные», «кончились баллы на сутки» — вместо кода ошибки, по которому агент начинает гадать. А когда Директу не понравилось конкретное поле, его текст доходит до модели дословно, и она чинит запрос сама.

Деньги в понятных единицах

В API Директа все суммы — целые числа, умноженные на миллион: ставка 14 рублей приезжает как 14000000. Модель честно пересказывает это человеку и называет ставку в четырнадцать миллионов.

Наружу из плагина такие числа не проходят ни в одну сторону: и в ответах, и в аргументах ставки и бюджеты — обычные суммы в валюте аккаунта.

Что нужно для работы

приложение MCP версии 1.3.0 или новее — оно держит сервер и токены
OAuth-токен Яндекса с правом «Использование API Яндекс Директа» (direct:api)
одобренная Яндексом заявка на доступ к API для того приложения, которым выдан токен
исходящий HTTPS к api.direct.yandex.com — ни Node, ни cron, ни своих таблиц в базе плагин не требует
MCP-клиент: Claude Desktop, Cursor, любой другой или собственный скрипт

Как получить токен Яндекса

Завести приложение на oauth.yandex.ru и отметить право «Использование API Яндекс Директа» (direct:api).
Подать заявку на доступ к API Директа для этого приложения. Без одобренной заявки не проходит ни один вызов — Директ отвечает ошибкой «Незавершенная регистрация». Заявку подаёт только разработчик приложения и только один раз: после одобрения приложением пользуется неограниченное число пользователей.
Получить токен по ссылке вида oauth.yandex.ru/authorize?response_type=token&client_id=… и вставить его в настройки плагина.

Токен выдаётся от имени представителя рекламодателя: какие кампании этот человек видит в интерфейсе Директа, такие увидит и ассистент. Агентствам нужно дополнительно указать в настройках логин клиента, от имени которого идёт работа.

Мы в социальных сетях

Узнавайте первыми о наших новых решениях и акциях.

Вконтакте — https://vk.com/easyweb_su
Телеграм — https://t.me/easyweb_su

Яндекс.Директ для приложения «MCP»

3 999 ₽ навсегда