нажмите, чтобы пропустить
ACCESS FILE · 03ГЛ. 00/07~14 МИН
 
ДОСТУП К ДИРЕКТУ
0%
 
НАГЛЯДНО · НЕ СТАТИСТИКА
 
Файл 03 · Директ
 
Директ вClaude и Codex
 
Как подключить API и управлять рекламой из нейросети
 
7 глав~14 мин чтенияпроверка, демо и калькулятор внутри
 
НачатьЧек-лист (таблица)
 
Гайд состоит из двух частей. Первая рассчитана на десять минут: что нужно сделать и в каком порядке. Вторая разбирает каждый шаг подробно, со скриншотами, схемами, шаблонами и примерами запросов.
 
В тексте указано, откуда взято утверждение. Пометка (справка) значит, что это написано в официальной документации Яндекса или Claude Code. Пометка (автор) значит, что это из рилса и материалов Антона Петроченкова: расшифровка, переписка, записи экрана. Пометка (оценка) обозначает рекомендацию составителя гайда, которую никто независимо не проверял. Все токены, ключи, почты и названия кампаний на картинках замазаны.
 
Чек-лист из рилса: таблица «Аудит Яндекс.Директ 2026: чеклист» в Google Таблицах. Откройте её по этой ссылке, сохраните копию себе и загрузите в нейросеть (глава 5).
 
 
Часть 1. Быстрый старт
 
В чём задача
 
Отчёты по Директу, поиск площадок на исключение, правка ставок и объявлений занимают часы, если делать это руками в интерфейсе. Автор рилса подключил Директ к нейросети (Claude или Codex) через API. Теперь такие действия выполняются запросом обычными словами: нейросеть сама обращается к Директу, строит отчёт или показывает список изменений (автор).
 
Подключение состоит из нескольких шагов: приложение в Яндекс OAuth, заявка на доступ к API, получение токена. Заявку рассматривают сотрудники Яндекса. Срок в справке: от часа до трёх суток в рабочие дни, в пиковую нагрузку до семи дней (справка). Пока заявка рассматривается, нейросеть можно подготовить: загрузить чек-лист и сделать из него навык (автор).
 
Три шага
 
Три шага к управлению Директом из нейросети1 ДОСТУППриложение в OAuthи заявка на API2 ТОКЕНСсылка, «Разрешить»,копия токена3 НЕЙРОСЕТЬЧек-лист, навык,первые запросыБез одобренной заявки запросы к API не работают
 
Первый шаг даёт доступ: приложение и одобренная заявка. Второй шаг выдаёт токен, по которому Директ узнаёт вашу нейросеть. Третий шаг настраивает саму нейросеть: чек-лист, навык и первые запросы. Порядок важен: без одобренной заявки запросы к API не работают (справка).
 
Самопроверка за десять минут
Отметьте шаги, которые у вас уже сделаны, и нажмите кнопку.
  
Что сделать
Отмечайте выполненное: шкала доступа вверху будет расти.
Сегодня (около часа)
На этой неделе
В течение месяца
Лесенка доступа1 ПриложениеЯндекс OAuth2 ЗаявкаМои заявки3 ТокенРазрешить4 Управлениеотчёты и ставки
 
Чего не делать
 
     
  • Отправлять Client secret и токен в чат, в мессенджеры, в публичные репозитории. В справке сказано, что токен нельзя никому сообщать (справка).
    •  
  • Публиковать скриншоты с токенами и данными кабинета без замазывания. Автор просит замазывать их обязательно (автор).
    •  
  • Менять ставки и объявления на рабочем аккаунте без проверки. Сначала песочница, затем список изменений и ваше подтверждение (оценка).
    •  
  • Подавать заявку с общими словами. В переписке автора пример задач: выгрузка статистики или управление ставками (автор).
    •  
  • Ждать одобрения без дела. Чек-лист и навык готовятся заранее (автор).
    •  
 
 
Часть 2. Подробно
 
01
Как устроено подключение
 
Директ отдаёт данные и принимает команды через API. Нейросеть выполняет запросы к нему от вашего имени, поэтому ей нужны четыре вещи: приложение, заявка, токен и навык, который объясняет, что и как делать.
 
  
 Что Где взять Для чего 
   
 Приложение oauth.yandex.ru Выдаёт Client ID и Client secret (справка) 
 
 Client ID Страница приложения Идёт в заявку и в ссылку для получения токена (справка) 
 
 Client secret Страница приложения Секретный ключ, которым подписан токен. Сохраните его (справка, автор) 
 
 Заявка Директ, раздел API, «Мои заявки» Без одобренной заявки запросы к API не работают (справка) 
 
 OAuth-токен Ссылка oauth.yandex.ru/authorize Передаётся в каждом запросе в заголовке Authorization (справка) 
  
 
Путь запроса: от просьбы до данныхВЫПросьба обычнымисловамиНЕЙРОСЕТЬНавык и чек-листформируют запросAPI ДИРЕКТАТокен в заголовкеAuthorizationОТВЕТДанные изаголовок UnitsОтчёт или список изменений возвращается вам на подтверждение
 
Токен передаётся в заголовке запроса: Authorization: Bearer ваш_токен (справка). Ответ содержит заголовок Units с тремя значениями через косую черту: сколько баллов потрачено на запрос, сколько осталось, каков суточный лимит. Пример из справки: Units: 10/20828/64000.
 
Баллы (справка)
 
Каждому рекламодателю выдаётся индивидуальный суточный лимит баллов. Лимит делится на 24 интервала: в начале каждого интервала начисляется 1/24 суточного лимита, к ней добавляются неизрасходованные баллы за предыдущие 23 часа. Если баллов не хватает, запросы к API не выполняются. Одновременно допускается не более пяти запросов от одного рекламодателя.
 
  
 Метод За вызов За объект 
   
 Campaigns.get 10 1 
 
 AdGroups.get 15 1 
 
 Bids.get 15 3 за каждые 2000 фраз 
 
 Bids.set 25 0 
 
 Dictionaries.get 1 0 
  
 
Ошибка вызова стоит 20 баллов, кроме серверных ошибок (справка). Чтобы экономить баллы, в справке советуют хранить полученные данные у себя и запрашивать только изменившиеся объекты. Для вашей нейросети это значит: пусть она сохраняет выгрузку в файл и не запрашивает одно и то же повторно (оценка).
 
Что где лежит и что с этим делатьClient IDИдёт в заявку и в ссылку для получения токенаClient secretХранить в файле. Не отправлять в чати не публиковатьOAuth-токенТолько в заголовок Authorization.Файл или переменная вне проектаСтатус заявкиСмотреть на вкладке «Мои заявки»
 
Попробуйте самиучебная имитация, не настоящий API
 
 
    
 
 
> ожидание запроса
 
02
Приложение в Яндекс OAuth
 
Приложение нужно, чтобы Яндекс выдал идентификатор и секретный ключ. Порядок такой (справка, автор).
 
     
  1. Войдите в Яндекс под логином, который используете в Директе.
    2.  
  2. Откройте oauth.yandex.ru и нажмите «Создать приложение».
    3.  
  3. Выберите тип «Для доступа к API или отладки».
    4.  
  4. Укажите название сервиса и почту для связи.
    5.  
  5. В разделе «Доступ к данным» добавьте «Использование API Яндекс Директа (direct:api)».
    6.  
  6. Нажмите «Создать приложение».
    7.  
 
Выбор типа приложения на странице Яндекс OAuth. Запись экрана автора
Выбор типа приложения на странице Яндекс OAuth. Запись экрана автора
 
В рилсе автор ставит доступ к Яндекс Директу и к Яндекс Метрике: право на чтение статистики Метрики нужно, чтобы нейросеть видела и данные счётчиков (автор). Справка по Директу в перечне прав называет ещё «Работа с организациями Яндекс ID (passport:business)». Автор его не выбирает. Если сомневаетесь, сверьтесь с текущей справкой.
 
Форма создания приложения: название, почта, доступ к данным. Почта замазана
Форма создания приложения: название, почта, доступ к данным. Почта замазана
 
Запись экрана: выбор прав доступа. Почта замазана
Запись экрана: выбор прав доступа. Почта замазана
 
После создания страница покажет Client ID и Client secret. Сохраните оба значения в отдельный текстовый файл: они понадобятся для заявки и для получения токена (автор).
 
Страница приложения: Client ID и Client secret. Значения замазаны
Страница приложения: Client ID и Client secret. Значения замазаны
 
Пустой шаблон файла для хранения значений. Данные в него вставляете только вы
Пустой шаблон файла для хранения значений. Данные в него вставляете только вы
 
На странице приложения Яндекс может показывать предложение пройти верификацию через Госуслуги. Из окна на записи экрана следует, что верификация убирает пометку «Сервис не верифицирован» на приложениях, открывает подключение оплаты через Яндекс Пэй и позволяет создавать больше приложений. В рилсе автор этот шаг не проходит (автор).
03
Заявка на доступ к API
 
Заявка подаётся в веб-интерфейсе Директа (справка).
 
     
  1. Откройте раздел API. Если его нет, сначала настройте аккаунт Директа и создайте кампанию.
    2.  
  2. Нажмите «Получить доступ к API» и примите пользовательское соглашение.
    3.  
  3. Откройте вкладку «Мои заявки» и нажмите «Новая заявка».
    4.  
  4. Заполните форму и нажмите «Отправить».
    5.  
 
Идентификатор приложения выбирается из списка: это Client ID, полученный при регистрации. На одно приложение подаётся одна заявка (справка).
 
Путь заявки на доступЗаявкаподанаМодерацияот часа до 3 суток,в пик до 7 днейОдобренаТокенОтклоненапричины в«Мои заявки»После правок заявку подают зановоПесочницапроверка запросаБоевойаккаунт
 
Запись экрана: заполнение формы заявки
Запись экрана: заполнение формы заявки
 
На записи экрана автора форма содержит такие блоки: идентификатор приложения, контакты службы поддержки, данные о компании, утверждение о вашей работе, технические данные (язык программирования, протокол JSON или SOAP, версия библиотек), логины в Директе, для которых используется приложение, назначение и основные функции приложения, новые возможности для пользователей, схема взаимодействия, демо-доступ и пользовательское соглашение. Обязательные поля отмечены звёздочкой. В записи автор отмечает варианты об автоматизации работы, получении статистики и отчётов, управлении кампаниями и объявлениями, управлении ставками, выбирает протокол JSON и вписывает назначение «обработка статистики через ИИ» (автор).
 
Форма заявки на получение полного доступа к API Директа. Запись экрана автора
Форма заявки на получение полного доступа к API Директа. Запись экрана автора
 
Нижняя часть формы: функции приложения и пользовательское соглашение
Нижняя часть формы: функции приложения и пользовательское соглашение
 
 
Заявка на доступ к APIмакет, значения условные
 
 
ПолеЧто вписали
  
Идентификатор приложения
 
Контакты для связи
 
Для чего приложение
 
Основные функции
 
Пользовательское соглашение
 
 
Нажмите на красные ячейки, чтобы увидеть, что в них не так.
 
 
В переписке автор советует кратко описать, для каких задач вы будете использовать API, например выгрузка статистики в BI-систему или управление ставками (автор). Шаблон описания (оценка): «Приложение выгружает статистику и отчёты по моим кампаниям и помогает управлять ставками и объявлениями. Запросы выполняются от моего логина, изменения применяются после моего подтверждения».
 
Сроки
 
Рассмотрение заявок производится в рабочие дни с 10:00 до 19:00. Обработка занимает от часа до трёх суток в рабочие дни, в периоды пиковой нагрузки до семи дней (справка). Те же сроки приводит автор в переписке: от нескольких часов до трёх рабочих дней, при высокой нагрузке до семи дней (автор). В рилсе звучит «в течение нескольких часов»: это нижняя граница, ориентируйтесь на срок из справки.
 
Статус заявки виден на вкладке «Мои заявки». Если заявку отклонили, причины там же, заявку можно отредактировать и подать снова (справка).
04
Токен и его безопасность
 
После одобрения заявки получите токен (справка).
 
     
  1. Войдите в Яндекс под своим логином.
    2.  
  2. Откройте ссылку https://oauth.yandex.ru/authorize?response_type=token&client_id=ВАШ_CLIENT_ID, подставив свой Client ID.
    3.  
  3. Нажмите «Разрешить».
    4.  
  4. Яндекс покажет страницу с токеном и добавит его в адресную строку. Скопируйте токен.
    5.  
 
Автор описывает то же самое: после нажатия «Разрешить» токен нужно передавать в заголовках при каждом запросе к API (автор).
 
Страница приложения после создания. Данные замазаны
Страница приложения после создания. Данные замазаны
 
Где хранить
 
Положите токен в файл вне папки проекта или в переменную окружения и просите нейросеть читать его оттуда. Не вставляйте токен в сообщение чата и не добавляйте в репозиторий: тогда он останется в истории (оценка).
 
Когда токен перестаёт работать
 
В справке Яндекс ID перечислены случаи отзыва токена (справка): пользователь отозвал доступ на странице «Доступы к данным»; истёк срок жизни токена; владелец приложения изменил запрашиваемые права или удалил приложение; пользователь сменил пароль, включил или выключил двухфакторную аутентификацию, восстановил доступ к аккаунту или нажал «Выйти везде». В этом случае получите новый токен по той же ссылке.
 
Как токен ломается и как его заменитьТокенработаетЧто его отзываетпароль, двухфакторная защита, праваприложения, «Выйти везде», срокТокен отозванНовая ссылка«Разрешить», копияОбновить значениев файле или переменной
 
Срок жизни токена в справке Директа не указан. В документации Yandex Cloud для OAuth-токенов назван срок один год. Для Директа сверьте с интерфейсом.
 
Песочница
 
Песочница имитирует API Директа и изолирована от настоящих данных: объявления нигде не показываются, баланс не меняется, статистика содержит условные данные с той же структурой. Действуют те же ограничения по баллам. Данные хранятся месяц с последнего обращения (справка). Адрес для JSON-запросов к API v5: https://api-sandbox.direct.yandex.com/json/v5/{сервис} (по справке, сверьте перед использованием). Как включить песочницу и создать тестового пользователя, в найденных страницах не описано: сверьте с интерфейсом, раздел API. Автор в переписке пишет, что пока заявка рассматривается, запросы можно тестировать в песочнице (автор).
05
Нейросеть: чек-лист, навык, первые запросы
 
Чек-лист
 
В рилсе показана таблица «Аудит Яндекс.Директ 2026: чеклист». Методология Антона Петроченкова и Convert Monster, больше 80 проверок, взвешенная оценка. Столбцы: ID, проверка, критичность, как проверить, статус, находка, рекомендация, минуты, быстрая победа. Разделы идут с весами: например, «Трекинг и цели Метрики» 25%, «Минус-слова и нецелевой трафик» 20% (автор, по скриншоту).
 
Таблица чек-листа. Скриншот автора, личные данные замазаны
Таблица чек-листа. Скриншот автора, личные данные замазаны
 
Саму таблицу можно открыть по ссылке в начале гайда. Сохраните копию себе и загрузите её в нейросеть. Здесь показан скриншот.
 
Навык
 
Порядок из рилса (автор): пока заявка на модерации, вставляем в Claude или Codex чек-лист с оптимизацией Директа и просим на его основании сформировать навык или промпт. Навык это инструкция, которую нейросеть применяет к вашему аккаунту.
 
В Claude Code навык лежит в файле SKILL.md. Личные навыки хранятся в ~/.claude/skills/имя-навыка/, навыки проекта в .claude/skills/имя-навыка/. Файл начинается с блока между линиями ---, в нём поле description объясняет Claude, когда применять навык. Вызвать навык можно командой /имя-навыка (справка Claude Code). Для Codex подходящее место для инструкций сверьте с его документацией: в найденных источниках я это не подтвердил.
 
Шаблон навыка с правилами безопасности лежит в приложении А.
 
Первый запрос
 
Начните с песочницы. Попросите нейросеть выполнить запрос Campaigns.get к адресу песочницы с токеном из переменной окружения и показать в ответе заголовок Units. Пример запроса в приложении Б. Если ответ пришёл и баллы списались, связка работает.
06
Что можно делать
 
В рилсе автор перечисляет: создавать новые объявления, управлять кампаниями, поднимать и опускать ставки, выгружать площадки, строить любой отчёт (автор).
 
  
 Задача Что попросить Как работает 
   
 Отчёт за период Построить отчёт по расходу, кликам и лидам за две недели и сравнить с предыдущими Служба Reports, ответ в формате TSV (справка) 
 
 Площадки на исключение Выгрузить площадки и показать сайты и приложения с кликами без конверсий Отчёт по площадкам. Тип отчёта сверьте со справкой 
 
 Ставки Показать план изменений ставок, после подтверждения применить Bids.set стоит 25 баллов за вызов (справка) 
 
 Объявления Подготовить тексты и показать их, затем создать Сервис Ads. Методы сверьте со справкой 
  
 
Для изменений действует правило (оценка): нейросеть показывает список изменений и ждёт вашего «да». Без этого она работает только на чтение.
 
Примеры результатов из практики автора
 
На картинках ниже результаты из одного кабинета автора. Цифры нельзя переносить на другой проект, это примеры того, какого вида отчёты строит нейросеть (оценка).
 
Ответ Claude: итоги за две недели и таблица по кампаниям. Названия кампаний замазаны
Ответ Claude: итоги за две недели и таблица по кампаниям. Названия кампаний замазаны
 
Диагностика CPL: основные показатели и динамика
Диагностика CPL: основные показатели и динамика
 
Список площадок на исключение. Одна строка замазана
Список площадок на исключение. Одна строка замазана
 
Трафик по региону, ОС и разрешению за 60 дней
Трафик по региону, ОС и разрешению за 60 дней
 
РСЯ по сегментам за 14 дней
РСЯ по сегментам за 14 дней
07
Как понять, что это работает, и сколько времени экономит
 
Подключение работает, если выполняется всё из списка (оценка).
 
     
  1. Заявка одобрена, статус виден в «Мои заявки».
    2.  
  2. Запрос в песочницу возвращает ответ и заголовок Units.
    3.  
  3. Первый отчёт совпадает с интерфейсом по расходу и кликам за тот же период.
    4.  
  4. Навык ничего не меняет без вашего подтверждения.
    5.  
  5. Токен не попал ни в чат, ни в файлы проекта.
    6.  
  6. После смены пароля или прав доступа вы знаете, что токен нужно получить заново.
    7.  
 
Расчёт экономии времени
 
Деньги экономит внедрение, а не вступление в клуб. Расчёт ниже условный: подставьте свои цифры. Эффект от лучшей оптимизации рекламы здесь не считается, пример консервативный.
 
Формулы: сэкономленные часы в месяц = число отчётов × (минут вручную минус минут с нейросетью) / 60. Экономия в рублях = часы × стоимость часа. Порог окупаемости подписки = подписка / стоимость часа.
 
Пример (цифры условные): 20 отчётов в месяц, 40 минут вручную, 10 минут с нейросетью (запрос и проверка), час специалиста 1 500 ₽. Экономия 10 часов, то есть 15 000 ₽ в месяц. Подписка клуба 2 200 ₽ окупается, если сэкономить около 1,5 часа в месяц.
 
Таблица чувствительности (экономия в ₽ в месяц, 10 минут с нейросетью, час 1 500 ₽, цифры условные):
 
  
 Отчётов в месяц 20 минут вручную 40 минут вручную 60 минут вручную 
   
 10 2 500 7 500 12 500 
 
 20 5 000 15 000 25 000 
 
 40 10 000 30 000 50 000 
  
 
time_saver.exe
 
     
 
Экономия времени в месяц0
Экономия в месяц0
 
Экономия в год0
Порог окупаемости подписки0
 
Во сколько раз экономия больше подписки0
 
Цифры условные. Деньги экономит внедрение, а не вступление в клуб.
 
 
Закрытый клуб Петроченкова
 
Это был один гайд. В клубе таких десятки
  
Пространство для тех, кто живёт маркетингом: сильные специалисты, агентства и предприниматели. Каждую неделю новые разборы, эфиры и рабочие материалы.
 
     
  • Закрытые разборы проектов участников и кейсов Антона: с цифрами, ошибками и победами, которых нет в открытом доступе.
    •  
  • Живые эфиры с экспертами: ИИ в бизнесе, продажи, реклама, найм ассистента и не только.
    •  
  • Инструменты под задачу: скрипты, чек-листы, шаблоны и таблицы, которые можно внедрять сразу.
    •  
  • Сильное окружение: здесь находят подрядчиков, партнёров и обратную связь быстрее, чем на конференциях.
 
Подписка стоит дешевле одной ошибки в воронке, а она обычно обходится в десятки тысяч рублей.
 
Подписка2 200 ₽в месяц
 Выбрать тариф и зайти в клуб → 
Продление автоматическое. Карту можно отвязать в любой момент.
Конец файла. Спасибо, что дочитали.
Приложения
 
А. Шаблон навыка 
Скопируйте в SKILL.md, поменяйте названия под себя (шаблон, оценка).
 
---
name: direct-api
description: Работа с Яндекс Директом через API: отчёты, площадки, ставки, объявления. Используй, когда пользователь просит отчёт или изменение в Директе.
---

Правила:
1. Токен читай из переменной окружения YANDEX_DIRECT_TOKEN. Никогда не печатай его в ответе и не записывай в файлы.
2. Сначала работай с песочницей api-sandbox.direct.yandex.com. На боевой аккаунт переходи, только когда пользователь явно скажет.
3. По умолчанию только читай данные. Перед любым изменением ставок, объявлений или кампаний покажи список изменений и жди подтверждения.
4. После каждого запроса показывай заголовок Units: потрачено, остаток, суточный лимит.
5. Сохраняй выгрузки в файл и не запрашивай одни и те же данные повторно.
6. Проверяй отчёт: итоги расхода и кликов должны совпадать с интерфейсом за тот же период.
7. Используй чек-лист оптимизации Директа как список проверок и в ответе называй номер проверки.

 
Б. Примеры запросов 
Все примеры сверьте со справкой метода перед использованием.
 
Получение токена (справка):
 
https://oauth.yandex.ru/authorize?response_type=token&client_id=ВАШ_CLIENT_ID

 
Проверочный запрос к песочнице (пример структуры, поля метода сверьте):
 
curl -s -D - -X POST https://api-sandbox.direct.yandex.com/json/v5/campaigns \
  -H "Authorization: Bearer $YANDEX_DIRECT_TOKEN" \
  -H "Accept-Language: ru" \
  -H "Content-Type: application/json" \
  -d '{"method":"get","params":{"SelectionCriteria":{},"FieldNames":["Id","Name"]}}'

 
Структура тела запроса к службе Reports (справка): внутри params находится ReportDefinition с полями SelectionCriteria, FieldNames, ReportName, ReportType, DateRangeType, Format (поддерживается только TSV) и IncludeVAT. Адрес для JSON: https://api.direct.yandex.com/json/v501/reports.
 
В. Безопасность и юридическая заметка 
Токен даёт доступ к аккаунту Директа. Хранить его нужно как пароль (оценка). Если вы работаете с кампаниями клиентов, проверьте договор и политику конфиденциальности: можно ли передавать данные кампаний в нейросеть (оценка). При подаче заявки вы принимаете пользовательское соглашение «Правила разработки Приложений для взаимодействия с API Сервиса «Яндекс.Директ»» (по форме заявки). Эта заметка не юридическая консультация.
 
Г. Источники