Автоматизация отчетности для Яндекс Директ через ИИ
Агентский контур: API-токен, Telegram-бот и PDF по понедельникам. Не клики в Мастере отчётов, а выгрузка статистики клиенту.
Получить предложение
Запись разбора
Нажмите на обложку — откроется плеер Rutube. Ниже разобраны слайды и живые кадры кабинета.
Кто разбирает контур
Роман Скороходов — кабинет, бот и живой запуск. Константин Горбунов — API, AdPump и границы сервисов.
Разбор собран вокруг агентской рутины: каждый понедельник команда собирает статистику Яндекс Директа и отдаёт клиенту файл. Это не обучение «как кликать срезы» и не обзор встроенного помощника кабинета. Третий голос в сетке камер — Михаил Мозжухин; отдельной карточки на слайдах нет, био не выдумываем.
Роман Скороходов
Показывает заявку в кабинете, Telegram-бота, рабочую папку и расписание. Не создавал oauth-приложение в эфире — чтобы не светить секрет приложения.
Константин Горбунов
Держит рамку API: одно приложение на десятки кабинетов, Changes против журнала интерфейса, промпт AdPump и почему Excel руками ещё не автоматизация рекламы.
Зачем агентству контур, а не ещё один Excel
Порог потока, два режима доставки и жёсткая граница с Мастером отчётов.
Пока клиентов мало, директолог выгружает статистику из рекламного кабинета Яндекс Директ и клепает PDF за вечер. Когда кабинетов становится двадцать–тридцать и больше, понедельник превращается в конвейер: одни и те же цифры, одни и те же файлы, одни и те же чаты. Автоматизация рекламы в этом смысле — не «робот крутит ставки», а снятие повторяющейся отчётности с людей.
Спикеры разделяют два режима. Полуручной: в чат проекта пишете «собери десять отчётов по десяти клиентам», проверяете и сами кидаете файлы. Полный авто: готовый PDF падает в Telegram-чат клиента по расписанию. Мессенджер MAX здесь не приоритет: боты там завязаны на юрлицо и отдельный контур, Костя прямо советует не тратить на это время.
Пять блоков контура, не конспект кабинета
Токен → нюансы API → бот → промпт → облако и расписание.
Повестка эфира — карта стека, а не список кнопок в интерфейсе. Сначала доступ: oauth-приложение и заявка в Директе. Затем граница: журнал «История изменений» из кабинета через API не выгружается — об этом отдельная статья про снимок. Дальше доставка: один бот на все чаты и сборка: промпт AdPump и cron понедельника. Порог «уже пора» разобран в статье про полуручной режим и PDF.
Важная оговорка голоса: не все вкладки кабинета отдаёт API. Мастер кампаний, интересы аудиторий и товарку целиком через API не правят. Это ограничение типа кампании, не инструкция по новому Мастеру отчётов.
Oauth-приложение: личная почта и скоупы
Тип «для доступа к API или отладке». Метрику искать словом metrika латиницей.
Приложение регистрируют на личной почте Яндекса, не на клиентском логине. Тип — доступ к API или отладка. Скоупы: API Директа плюс чтение статистики Метрики. Без Метрики в отчёте не будет отказов и глубины. В поиске доступов слово «метрика» по-русски часто не находит пункт — пишите metrika латиницей.
После создания сохраняют Client ID и Client Secret в закрытое место, не в чат и не в открытый репозиторий. В эфире приложение заново не создавали: секрет нельзя светить на записи.
Заявка в кабинете Директа — второй шаг
Не oauth.yandex.ru. Описание про выгрузку статистики, без управления ставками.
Полный доступ открывает заявка внутри рекламного кабинета Яндекс Директ. На oauth.yandex.ru её нет. В описании пишут автоматизацию отчётности и еженедельные PDF, без права крутить ставки. К заявке нужен файл: в демо грузили любую заглушку.
На слайдах срок рассмотрения — до семи дней. У спикеров заявка часто уходит за пятнадцать минут. Для плана держите оба факта: формально неделя, на практике часто минуты. Пока ждёте — песочница, боевой кабинет агенту не отдавать. Одно приложение обслуживает много кабинетов: доступы расшаривают на логин приложения, а не плодят пятьдесят приложений.
- Открыть раздел заявок API в кабинете Директа, не страницу oauth.
- Выбрать уже созданное приложение и написать, что нужен съём статистики, не управление ставками.
- Приложить любой файл-заглушку — без файла форма не уходит.
- Дождаться статуса «одобрена»; «новая» и «на рассмотрении» токен не дают.
- Пока ждёте — крутить песочницу, не боевой логин клиента.
- Одно приложение повесить на все нужные кабинеты через доступы, не клонировать oauth.
Токен после «одобрена» и чего API не обещает
Authorize плюс свой Client ID. Журнал интерфейса ≠ Changes.
Ссылку authorize открывают только после статуса «одобрена» и подставляют свой Client ID. Раньше токен либо не выдадут, либо он не откроет нужные методы. Госуслуги спикеры не фиксируют как жёсткое правило: Костя оговаривается, что может ошибаться; в старом приложении 2015 года Госуслуги просили при расширении скоупов.
Журнал «История изменений» из интерфейса через API не приходит. Changes отдаёт SELF, CHILDREN и STAT. Чтобы написать «в кампании X добавили минусы», хранят свой снимок: кампании, ключи, бюджет, стратегия. Старые PDF можно скормить как «как было». На внятный еженедельный «до/после» нужно одну–две недели накопления. Баллы API Директа конечны — контур не должен долбить методы без нужды.
Оболочка, железо и чего не ждать от подписки
Рабочее место — не «нейронка». VDS 2–3 тыс., чтобы не держать свой компьютер.
В эфире как оболочку называют Cursor или Claude Code. Это рабочее место: внутри разные модели, общение с агентом по-русски. Сайт cursor.com без VPN часто не открывается, установленное приложение — работает. Сайт Claude Code без VPN рискованнее.
Чтобы компьютер не крутился двенадцать–пятнадцать часов, ставят VDS примерно на две–три тысячи рублей в месяц. Тысяча — «слабо». Облачные агенты в подписке оболочки — альтернатива своему серверу. Дешёвый тариф около двадцати долларов на постоянные облачные прогоны обычно не тянет; ориентир голоса — около ста. Покупать подписку «только ради одного отчёта в неделю» спикеры называют бессмысленным: окупается стек (контент, посадки, CRM, рутина), не одна PDF-обложка.
| Режим | Кто запускает | Когда выбирать |
|---|---|---|
| Полуручной чат | Директолог пишет агенту «собери N отчётов» | До порога 20–30 или пока нет стабильного крона |
| Авто PDF в Telegram | Расписание + бот | Поток уже ест понедельник команды |
| Свой VDS | Сервер 2–3 тыс. ₽/мес | Не хотите держать домашний ПК |
| Облако в подписке | Cloud Agents / Automations | Нет желания админить VDS, тариф тянет прогоны |
Telegram-бот: один на все чаты
Официальный BotFather с галочкой. Идентификаторы чатов в статью не пишем.
Личный User API Telegram в РФ сейчас получить трудно, поэтому отчёт уходит от имени бота. Заводят одного бота через BotFather с галочкой: имя, username на bot, токен — в закрытый файл окружения, не в git. Этого бота добавляют во все клиентские чаты и дают права администратора, чтобы он мог удалять свои сообщения и закреплять файл.
Идентификатор чата снимают через Getmyid_bot. Цифры с экрана и токен бота в копирайт и подписи не попадают — на слайдах они уже скрыты. MAX — оговорка «не надо», без пошаговой инструкции.
Общий промпт AdPump и живой запуск
Источник инструкции — не кнопка обучения. Агент сам собирает вводные.
Канон промпта лежит на AdPump: страница instructions/otchetnost-direkt-ii. Её дают как источник текста, не как продажу курса. Можно скопировать блок или сказать агенту «забери промпт по ссылке». Дальше агент сам спрашивает нишу, сайт, токен Директа, логин, цели Метрики и данные бота.
Без официального skill PDF от Anthropic знак рубля в вёрстке часто превращается в квадратик. Визуал (логотип, цвета, партнёрский блок) правят голосом. Красивая обложка не повышает оплату за ведение Яндекс Директ.
Закрытый репозиторий и облачные агенты
Память проекта — git. Секреты в открытый коммит не кладут.
Без своего сервера расписание опирается на репозиторий как на память проекта. Выгружают весь контур в закрытый репозиторий. В учебном кадре агент предлагает закоммитить файл окружения — это антипример: токены Директа, Метрики и бота держат в секретах окружения и в игноре git.
Cloud Agents: новое окружение, выбор репозитория, запуск. Это «сервер внутри подписки», не отдельный продукт кабинета Яндекс Директ. Поля окружения в демо: токен и логин Директа, токен Метрики (иногда дублируют токен Директа), база API, токен бота и идентификатор чата. Значения с экрана не копируем.
Cron понедельника и таблица вместо PDF
0 6 * * 1 = понедельник 09:00 Москва. Не путать с первым числом месяца.
Новая автоматизация: репозиторий, промпт, расписание. В демо — каждый понедельник в девять утра по Москве. Запись cron: 0 6 * * 1. Ошибка 0 6 1 * * запускает задачу первого числа, не каждый понедельник. Для крона берут более дешёвую модель в подписке: тяжёлые модели для еженедельного PDF избыточны.
Альтернатива файлу — лист в Google-таблицах через облачную консоль и доступ таблиц. Кому удобнее править цифры в таблице, а не открывать PDF на телефоне. Интеграция Яндекс Директ здесь та же: API, не выгрузка руками из кабинета.
Частые вопросы
Короткие ответы по контуру API + бот + расписание, без кликов Мастера отчётов.
Это разбор нового Мастера отчётов в кабинете?
Нет. Здесь речь про доступ через API, сборку PDF агентом и доставку в Telegram. Клики, срезы и готовые шаблоны нового Мастера отчётов — отдельный разбор, этот контур их не заменяет и не пересказывает.
С какого потока клиентов имеет смысл собирать контур?
Спикеры ориентируют на 20–30 и больше кабинетов: понедельник тогда уходит на ручные PDF. На пяти клиентах дешевле полуручной запрос в чат агента, без облака и крона.
Зачем два шага: приложение и заявка в Директе?
Oauth-приложение даёт идентификаторы. Полный доступ к кабинету открывает отдельная заявка внутри Яндекс Директа. Пока она не в статусе «одобрена», токен боевого кабинета не выдают.
Почему журнал «История изменений» нельзя просто выгрузить?
Вкладка интерфейса через API не отдаётся. Сервис Changes даёт типы SELF, CHILDREN и STAT — это не фраза «добавили минусы в кампанию X». Чтобы написать такую фразу, нужен свой прошлый снимок объектов.
Один бот на всех клиентов — это нормально?
Да: заводят одного бота через официальный BotFather и добавляют его во все клиентские чаты с правами администратора. Плодить бота на каждый логин не нужно. Идентификаторы чатов в публичный текст не копируют.
Какое расписание ставить на еженедельный отчёт?
В демо — каждый понедельник в 09:00 по Москве. В cron это запись 0 6 * * 1 (шесть утра UTC при UTC+3). Формула 0 6 1 * * срабатывает первого числа месяца — её путают чаще всего.
Красивый PDF поднимет оплату за ведение?
Нет. Спикеры прямо говорят: оформление не увеличивает чек. Если клиент решит, что «агентство ничего не делает», оплату скорее снизят. Отчёт нужен как дисциплина ведения, не как упаковка.
Нужен контур отчётности по Яндекс Директу, а не ещё один ручной понедельник?
Monster Context помогает связать ведение кабинетов, доступ через API и доставку понятного отчёта клиенту — без путаницы с Мастером отчётов и без «купите нейросеть ради одного PDF».
