API для Яндекс Директа: 7 инструментов директолога

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

Что нового: 7 инструментов директолога в Agent API

До этого обновления Agent API уже умел генерировать контент 170+ нейросетями, управлять кампаниями Яндекс Директа, считать частотности Вордстата и вести автопилот рекламы. Теперь к нему переехали инструменты «Вайб Контекстника» — страницы с 12 ИИ-инструментами директолога, которую мы выпустили в кабинете. Семь из них доступны по API.

Аудит посадочной страницы — POST /direct/landing-audit

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

Генерация объявлений с нуля — POST /direct/ads-generate

Скармливаете URL сайта или текст УТП — на выходе пакет заголовков и текстов объявлений под Поиск и РСЯ, собранных комбинаторно, вместе с ключевыми фразами. Если передать только адрес, сервис сам прочитает оффер со страницы. Это отличается от уже существовавшего эндпоинта вариантов объявлений: тот перегенерирует группу готовой кампании, а новый создаёт объявления с чистого листа.

Быстрые ссылки и уточнения — POST /direct/sitelinks

Расширения делают объявление в выдаче крупнее и заметнее — CTR растёт без роста ставки. Эндпоинт изучает сайт и возвращает 8 быстрых ссылок с описаниями и 6 уточнений, уложенных точно в лимиты Директа: заголовок до 30 символов, описание до 60, уточнение до 25. Скопировали — вставили, ничего резать не придётся.

Прогноз и медиаплан — POST /direct/forecast

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

Отчёт для клиента — POST /campaigns/{id}/report

Самый востребованный инструмент у фрилансеров и агентств. По кампании платформы за выбранный период (7, 30 или 90 дней) собирается готовый отчёт языком владельца бизнеса: заголовок, главные выводы, KPI с комментариями, что сработало, что требует внимания, план на следующий период — и короткое готовое сообщение клиенту в мессенджер. Обычно на такой отчёт уходит два часа ручной работы; по API он приходит за минуту.

Сливающие фразы и площадки РСЯ — POST /campaigns/{id}/waste

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

Анализ поисковых запросов — POST /campaigns/{id}/search-queries

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

Для кого это и зачем

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

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

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

Если вы маркетолог с сотней задач — даже без программиста связка из no-code-платформы и пары HTTP-запросов автоматизирует еженедельную отчётность и мониторинг слива бюджета.

Если не хочется писать агента самому — возьмите готового: на платформе есть обученные ИИ-сотрудники от 15 000 ₽ в месяц — ИИ-Контекстолог, ИИ-Маркетолог, ИИ-Помощник и другие. Они уже умеют работать с этими инструментами: ведут рекламу, готовят отчёты и отвечают в мессенджерах без вашего кода.

Мини-кейс: недельная отчётность агентства за 10 минут

Представьте агентство с двенадцатью клиентскими кампаниями. Каждый понедельник скрипт по расписанию обходит список кампаний: для каждой вызывает POST /campaigns/{id}/report за 7 дней и POST /campaigns/{id}/search-queries, забирает из ответа готовое сообщение client_message и новые минус-слова, отправляет отчёт клиенту в Telegram, а список минус-слов — директологу на подтверждение. Стоимость прогона: 12 × (99 + 39) = 1656 ₽ в неделю. Ручной аналог — два-три рабочих дня специалиста. При этом повторный просмотр отчёта в кабинете в тот же день ничего не стоит — сработает общий кеш.

Как это работает

Авторизация — один Bearer-токен: получаете ключ в кабинете и добавляете заголовок к запросам. Инструменты делятся на два семейства. Первое работает вообще без кампаний — достаточно URL или списка фраз: аудит посадочной, объявления, быстрые ссылки, прогноз. Второе работает по вашим кампаниям платформы: отчёт клиенту, сливающие фразы, поисковые запросы.

Три вещи, которые делают API безопасным для кошелька:

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

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

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

Полный машиночитаемый каталог инструментов с актуальными ценами всегда лежит в GET /capabilities в секции direct_tools — агенту не нужна документация, чтобы узнать параметры.

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

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

Для сравнения: час работы директолога на рынке стоит от 1000 ₽, а недельный отчёт клиенту руками — это полтора-два часа. Отчёт за 99 ₽ по API окупается с первого же вызова.

Как попробовать

1. Зарегистрируйтесь или войдите в кабинет: lk.vibemarketolog.ru — новичкам начисляется приветственный бонус.
2. Получите API-ключ в разделе «AGI Агент» кабинета — ключ показывается один раз, сохраните его.
3. Проверьте ключ запросом GET /api/agent/me и загляните в GET /api/agent/capabilities — секция direct_tools покажет все инструменты с ценами.
4. Сделайте первый вызов — например, аудит посадочной: POST /api/agent/direct/landing-audit с телом {"url": "https://ваш-сайт.ru"}.
5. Для кампанейских инструментов синхронизируйте статистику кампании и вызывайте отчёт: POST /api/agent/campaigns/{id}/report.

Подробные примеры запросов и ответов — в документации Agent API, короткая версия для системного промпта агента — в квикстарте. Обзор всех возможностей API — на странице Agent API.

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

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

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

Нужна ли подписка, чтобы пользоваться API?

Нет. Оплата по факту с рублёвого баланса: пополнили счёт — вызываете инструменты от 29 ₽ за запуск. Баланс не сгорает, месячной платы нет.

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

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

Что будет, если инструмент не сработает?

Деньги вернутся автоматически — на тот же баланс, с которого списались. Если по кампании нет данных за период, API вернёт понятную ошибку и тоже ничего не спишет сверх возвращённого.

Можно ли ограничить расходы агента?

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

Можно ли купить готового обученного агента вместо разработки своего?

Да. Если API и код — не ваша история, посмотрите каталог готовых ИИ-сотрудников: ИИ-Контекстолог для рекламы, ИИ-Маркетолог, ИИ-Бухгалтер, ИИ-Помощник и агент под вашу задачу. Это обученные агенты «под ключ» от 15 000 ₽ в месяц — они уже пользуются этими инструментами за вас.

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

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

Итог

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