Автоматизация Яндекс Директа через API

Автоматизация Яндекс Директа через API — это когда отчёты клиентам, чистка минус-слов, аудит посадочных и медиапланы делаются скриптом или ИИ-агентом, а не руками по вечерам. В Вайб-Маркетологе для этого есть Agent API: 46 эндпоинтов, из которых семь — готовые инструменты директолога. В этом уроке разберём весь путь: где взять API-ключ, как сделать первый запрос, как устроена оплата и защита от лишних трат, и как собрать из этого рабочую автоматизацию — даже если вы не программист, а «скрипт» для вас пишет нейросеть.

lk.vibemarketolog.ru/#agent

Автоматизация Яндекс Директа через API: что это и когда использовать

Agent API — это программный доступ к инструментам платформы по одному Bearer-токену. Всё, что директолог делает в кабинете руками — проверяет посадочную, собирает объявления, ищет сливающие бюджет фразы, готовит отчёт клиенту, — можно вызвать одним HTTP-запросом и получить структурированный ответ в JSON. Оплата рублёвая, по факту вызова, без подписки и абонентской платы.

Когда это нужно? Как только у вас появляется повторяющаяся задача. Один отчёт в месяц проще сделать в кабинете — для этого есть «Вайб Контекстник» с 12 инструментами директолога. Но если отчётов двенадцать каждую неделю, если минус-слова надо чистить по всем кампаниям регулярно, если вы строите своего ИИ-агента или сервис — руками это делать разорительно по времени. API превращает рутину в расписание.

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

Для кого этот инструмент

Фрилансер-директолог с несколькими клиентами. Ваша боль — еженедельная отчётность. Скрипт из двадцати строк раз в неделю собирает отчёты по всем кампаниям и присылает вам готовые тексты для отправки клиентам. Вечер пятницы свободен.

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

Автор ИИ-агента. Ваш агент получает инструментальный слой директолога из коробки: аудит посадочной, генерация объявлений, медиапланы. Не нужно учить его парсить отчёты рекламных систем — приходит готовый структурированный JSON. Каталог инструментов агент читает сам из машиночитаемого справочника.

Продуктовая команда или SaaS. Аудит посадочных и генерация объявлений встраиваются в ваш сервис как фичи. Биллинг, провайдеры нейросетей и рекламные интеграции уже решены на нашей стороне.

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

Как подключить Agent API: пошагово

1. Зарегистрируйтесь на платформе. Если аккаунта ещё нет — создайте его: новичкам начисляется приветственный бонус, которого хватит на первые вызовы дешёвых инструментов.
2. Откройте раздел «AGI Агент» в кабинете — вкладка в верхнем меню или прямая ссылка lk.vibemarketolog.ru/#agent. Это центр управления: здесь живут API-ключи, лимиты и аналитика по каждому агенту.
3. Создайте API-ключ кнопкой «Создать ключ». Ключ показывается один раз — сразу сохраните его в надёжное место (менеджер паролей, секреты сервера). На платформе хранится только его отпечаток, восстановить ключ нельзя — только выпустить новый.
4. Задайте дневной лимит трат для ключа. Это ваш предохранитель: даже если в коде агента ошибка и он зациклится, больше лимита за день не спишется. Для начала хватит 300–500 ₽ в день.
5. Проверьте ключ. Запрос GET https://lk.vibemarketolog.ru/api/agent/me с заголовком Authorization: Bearer ВАШ_КЛЮЧ вернёт информацию о ключе, балансе и лимитах. Если получили ответ — подключение работает.
6. Загляните в каталог инструментов. GET /api/agent/capabilities — машиночитаемый справочник всего, что умеет API: модели, параметры, а в секции direct_tools — все семь инструментов директолога с актуальными ценами. Именно этот справочник читают ИИ-агенты, чтобы узнать возможности без документации.

Первый запрос: аудит посадочной за 39 ₽

Начните с инструмента, которому не нужны ни кампании, ни подключённый Директ — аудита посадочной страницы. Отправьте POST-запрос на /api/agent/direct/landing-audit с телом {"url": "https://ваш-сайт.ru"} и тем же заголовком авторизации. Через 30–60 секунд придёт разбор: оценка страницы от 1 до 10 глазами покупателя с платного трафика, сильные стороны, проблемы и конкретные правки с приоритетами.

Дальше по нарастающей: /direct/sitelinks вернёт 8 быстрых ссылок и 6 уточнений точно в лимиты Директа, /direct/ads-generate соберёт пакет объявлений с нуля по адресу сайта или тексту УТП, а /direct/forecast построит медиаплан по вашим ключевым фразам: три сценария с бюджетом, кликами, заявками и ценой заявки.

Кампанейские инструменты: отчёт клиенту, чистка запросов и РСЯ

Три инструмента работают по кампаниям, созданным на платформе, — тем самым, которые вы собираете в разделе «Яндекс Директ» кабинета (вот разбор, как платформа собирает кампании). Для них в запросе указывается идентификатор кампании прямо в адресе, а статистика должна быть синхронизирована.

POST /api/agent/campaigns/{id}/report — жемчужина набора: готовый отчёт заказчику за период. В ответе заголовок, главные выводы простым языком, таблица KPI с комментариями, что сработало, что требует внимания, план на следующий период и — самое приятное — готовое короткое сообщение для отправки клиенту в мессенджер, поле client_message. Скопировал — отправил.

POST /api/agent/campaigns/{id}/search-queries — разбор реальных поисковых запросов, по которым показывались объявления: мусор в минус-слова, перспективное — в новые ключи. POST /api/agent/campaigns/{id}/waste — поиск фраз и площадок РСЯ, которые тратят деньги без конверсий, с оценкой потенциальной экономии.

lk.vibemarketolog.ru/vibe-context

Разбор параметров и защит

Период анализа — days

Кампанейские инструменты принимают параметр days: 7, 30 или 90 (по умолчанию 30). Недельный отчёт клиенту — days: 7, квартальный обзор — days: 90. Период честно учитывается в кеше: отчёт за 7 дней и отчёт за 30 — это разные результаты.

Кеш и force — как не платить дважды

Результат кампанейского инструмента живёт 24 часа для пары «кампания + период». Повторный вызов в течение суток вернёт тот же результат бесплатно, с пометкой cached: true. Кеш общий с кабинетом: посмотрели отчёт в «Вайб Контекстнике» — агент получит его по API без списания. Нужен гарантированно свежий анализ после синхронизации статистики — передайте force: true, это будет новый платный запуск.

Автовозврат при ошибке

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

Защита от дублей и лимиты

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

Права ключа

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

Сколько стоит

Оплата — с рублёвого баланса аккаунта, по факту вызова. Подписки нет: платите только за то, что реально запустили, баланс не сгорает. Цены инструментов — те же, что в кабинете:

Для ориентира: недельный цикл автоматизации по одному клиенту — отчёт (99 ₽) плюс чистка запросов (39 ₽) — это 138 ₽ против полутора-двух часов ручной работы. Даже при десяти клиентах месяц автоматизации стоит дешевле одного дня работы специалиста.

Частые ошибки и как их избежать

• Потеряли ключ после создания. Ключ показывается один раз, восстановить нельзя. Решение: отзовите старый и создайте новый — это две кнопки в разделе «AGI Агент».
• «Нет данных за период» у кампанейских инструментов. Статистика кампании не синхронизирована. Сначала синхронизация (в кабинете или по API), потом отчёт.
• Запуск дорогого цикла без дневного лимита. Лимит — ваш предохранитель от ошибок в коде. Ставьте его всегда, поднять никогда не поздно.
• Повторный вызов «для надёжности» с force. Если данные не менялись, force: true просто спишет деньги за тот же результат. Кеш сам отдаст готовый ответ бесплатно — force нужен только после свежей синхронизации.
• Жёстко зашитые цены в коде агента. Цены могут меняться. Правильно: агент читает актуальные цены из каталога capabilities перед запуском.

Частые вопросы

Нужно ли уметь программировать, чтобы автоматизировать Яндекс Директ через API?

Желательно, но не обязательно. Скрипт из нескольких запросов сегодня пишет любая сильная нейросеть: опишите задачу в AI-чате, приложите наш квикстарт — получите готовый код. Дневной лимит ключа защитит от ошибок на время отладки.

Сколько стоит подключение Agent API?

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

Чем API отличается от «Вайб Контекстника» в кабинете?

Ничем, кроме способа вызова: кабинет — руками, API — кодом. Инструменты, цены и результаты общие. Кеш тоже общий: за один и тот же анализ дважды платить не придётся.

Как сделать отчёт по Яндекс Директу через API?

Один запрос: POST /api/agent/campaigns/{id}/report с параметром days. В ответе — готовый отчёт с KPI и сообщением для клиента. Кампания должна быть создана на платформе и синхронизирована.

Что будет, если у агента закончатся деньги на балансе?

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

Можно ли дать ключ подрядчику и не бояться за бюджет?

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

Работают ли инструменты без рекламного аккаунта Яндекса?

Четыре из семи — да: аудит посадочной, генерация объявлений, быстрые ссылки и медиаплан работают по URL и ключевым фразам. Отчёт, чистка запросов и РСЯ требуют кампанию на платформе.

Советы

• Начните с малого: один клиент, один еженедельный отчёт по расписанию. Когда убедитесь, что цикл стабилен, — масштабируйте на весь пул.
• Стройте цикл так: сначала бесплатные проверки (ключ, баланс, каталог), потом дешёвые инструменты, и только потом дорогие. Так агент отладится без затрат.
• Используйте client_message из отчёта как черновик, а не финал: добавьте личное обращение — клиенты чувствуют разницу.
• Если только начинаете с инструментами директолога — сперва пройдите разбор «Вайб Контекстника» в кабинете: поймёте, что возвращает каждый инструмент, прежде чем автоматизировать.
• Подробности релиза — в новости «API для Яндекс Директа: 7 инструментов директолога», полная документация и квикстарт для системного промпта агента — по ссылкам на странице Agent API.