Яндекс.Директ в руках ИИ-агента: ставки, бюджеты, поисковые запросы
Плагин к приложению MCP открывает рекламный аккаунт Яндекс.Директа для ИИ-агентов по протоколу Model Context Protocol. Claude, Cursor или свой скрипт подключаются и разбирают рекламу сами: где уходят деньги, какие фразы их съедают, по каким запросам показываются объявления и во сколько обойдётся следующая ступень аукциона. Двенадцать инструментов: десять только читают, два меняют ставку и дневной бюджет.
Структура аккаунта
Кампании с остатком средств, дневным бюджетом и стратегией показов. Группы с регионами и минус-словами. Объявления с заголовками, текстами и пояснением, за что отклонены модерацией. Ключевые фразы со ставками и продуктивностью.
Статистика
Показы, клики, CTR, расход и цена клика — по кампаниям и по условиям показа, за любой период или по дням. Со средней ставкой с учётом всех корректировок и объёмом трафика, который фраза получала на самом деле.
Торги и аукцион
Текущая ставка вместе с лесенкой аукциона: сколько стоит каждый объём трафика на поиске и какой охват даёт ставка в сетях. Тот самый ответ на вопрос «а сколько нужно, чтобы показываться выше».
Поисковые запросы
Что люди на самом деле набирали в Яндексе и по какой фразе это показалось. Расхождение между запросом и фразой — обычно и есть то, за что платят зря. Отсюда берутся минус-слова.
Менять плагин почти ничего не умеет — и это осознанно
В 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, любой другой или собственный скрипт
Как получить токен Яндекса
- Завести приложение на 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