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

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

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

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

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

Статистика

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Вместе с инструментами плагин отдаёт агенту страницу документации — 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, любой другой или собственный скрипт

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

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

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

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

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

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