Открытый скилл Яндекс.Директа для ИИ-агентов. Как поставить и что пробовать в первую очередь
Меня зовут Александр Поляков, я занимаюсь рекламой и AI-автоматизацией. В январе писал здесь, как подключить Claude к Вордстату.
Теперь выложил открытый скилл для Яндекс.Директа поверх официального API: ИИ-агент читает кабинет, считает метрики, готовит объявления и вносит правки. Скилл бесплатный, код открыт, к конкретной модели не привязан.
Ниже — как поставить, что попробовать в первый вечер и чего он не умеет принципиально.
Что такое скилл и почему он, а не системный браузер
Скилл — это папка: файл с инструкцией и набор скриптов на Python без сторонних зависимостей. Агент читает инструкцию, выбирает нужную команду и запускает её сам.
Чем это лучше агента в браузере:
- агенту не надо разбирать интерфейс: под каждое действие уже есть команда с известным результатом;
- агент не сочиняет запросы к API на ходу, а выбирает из готовых команд, и пишущие команды по умолчанию ничего не записывают (об этом ниже);
- интерфейс Директа перекраивают несколько раз в год, браузерный агент ломается после каждого редизайна, а API живёт годами;
- пока задача не про Директ, в контексте модели лежит только описание скилла в две строки. Инструкция подгружается, когда нужна.
Такую папку с инструкциями понимает любой агент, который поддерживает навыки. Я пользуюсь скиллом в Claude Code и в веб-версии Claude, но кроме этого у меня есть проекты и в Codex и в Cursor.
Для регулярных задач скилл живёт на сервере: там его запускает Hermes — открытый агент, подключённый к телеграму. Он просыпается по расписанию, собирает сводку и присылает её сам. OpenClaw в этой роли тоже подойдёт.
Внутри 19 команд: кабинеты и доступы, кампании и группы, объявления, фразы и дополнения, ставки и корректировки, отчёты по целям, загрузка картинок, выгрузка настроек и превью объявлений.
Почему я готов пускать агента в кабинет с живыми деньгами
Это главное возражение, и у меня самого оно жило около года.
Ещё в прошлом году всю автоматизацию контекстной рекламы через ИИ я делал с обязательной приёмкой человеком. В этом году начал эксперименты с агентами — и косяки у людей встречаются чаще, чем у LLM. Все примеры ниже — ошибки, которые сделали люди, а нашёл агент.
Любая пишущая команда в скилле по умолчанию работает вхолостую: читает актуальное состояние, показывает «было — станет» и ничего не записывает. Запись включается отдельным флагом, после неё команда перечитывает объект и показывает, что реально изменилось.
Сверху можно поставить хуки — проверки, которые запускаются перед каждой командой агента: вызов с записью хук может заблокировать и вернуть агенту замечание.
Как поставить скилл
Скилл лежит в моём репозитории, установка описана в README: через маркетплейс Claude Code, копированием папки в проект или клонированием всего репозитория. На уровне системы нужен Python 3.11 или новее, сторонних библиотек нет.
Самое сложное — ключ. Зарегистрировать приложение на oauth.yandex.ru недостаточно: для него нужно отдельно подать заявку на доступ к API Директа и дождаться одобрения. Я написал подробный гайд, куда идти и что писать. Агент, который увидит скилл без токена, сам подскажет, что делать, но этот шаг советую пройти руками.
Что попробовать на старте
Дальше можно просто поговорить с кабинетом. Промпты привожу как есть — они рабочие.
Обзор по кабинету
Собери сводку за прошлый месяц против позапрошлого: расход, клики, конверсии по выбранным целям, CPA, доля спецразмещения. Отдельно поиск и сети
В Директе есть отчёты, но добираться до сводных таблиц в последних версиях неудобно. Reports API отдаёт всё одним запросом, а агент сразу считает CPA и разницу между периодами. Первым делом он спросит, какие цели считать конверсиями — это не занудство, без этого CPA бессмысленна.
Сверка цен в заголовках с сайтом.
Для каждой посадочной покажи: какая цена стоит в заголовках объявлений, какая минимальная цена реально доступна на странице, сколько объявлений затронуто
Классика: на одной посадочной цену поправили в московской кампании, а в питерской и российской копиях осталась старая. Правили одну из трёх.
Следующий шаг — сравнить с ценами конкурентов и поднимать ставки только там, где вы выгоднее. Об этом ниже, в связке с Поиском.
Сверка графических креативов
Собери сверку изображений в объявлениях Директа: посмотри каждое изображение и все объявления, в которых оно стоит. Отметь, где товар на фото не совпадает с текстом
У автодилера так нашлось объявление, где текст обещал одну модель, а на фотографии стояла другая.
Разбор конверсий по условиям показа.
Покажи, по каким группам смыслов пришли конверсии за период, и предложи, что минусовать
Скилл умеет добавлять минус-фразы на уровне кампании, группы, самой фразы, библиотеки наборов, а также останавливать и удалять условия показа. В одном из разборов он перечислил все эти возможности и тут же сказал, что чистка минус-словами здесь бессмысленна: заказы шли из одного узкого куста запросов, а деньги утекали в широкие условия показа. Обычный чат-помощник в этом месте нагенерил бы двести минус-слов.
Другие сценарии
Замена текстов объявлений. Самый частый повод — даты. У автодилера каждый месяц в объявлениях новая акция «только до 30.09», и каждый раз часть объявлений кто-то забывает поправить. Агент находит все объявления со старой датой, показывает «было — станет» и после подтверждения переписывает. Для новых объявлений скилл собирает комбинаторный комплект заголовков и текстов и до записи показывает, какие сочетания не влезают в лимиты — это первая картинка в статье.
Превью для согласования. Скилл собирает HTML-страницу: как объявление выглядит в поиске на десктопе и на мобильном, с быстрыми ссылками и уточнениями. Клиент открывает её, тыкает в строку, которая не нравится, пишет замечание, а в конце выгружает все правки одним текстом. Этот текст отдаём агенту как промпт, и он вносит правки в кабинет.
Связки с остальными скиллами
Скилл Директа лежит в одном репозитории с моими скиллами Вордстата, Метрики, Вебмастера и Яндекс Поиска, и агент может вызывать их в одной задаче.
Самая полезная связка на сегодня — цены конкурентов. Скилл Поиска ходит в Яндекс через Search API и возвращает вместе со ссылками короткие выдержки со страниц: цена конкурента приезжает прямо в ответ, парсер сайтов не нужен. Стоит это 1 500 ₽ за 1 000 запросов с выдержками или 488 ₽ без них. Дальше по фразам, где ваша цена ниже или срок поставки короче, скилл Директа поднимает ставку.
Раз в квартал такой обзор делают все. Раз в неделю не делает почти никто, потому что руками это полдня на кабинет.
Про регулярность отдельно. В 2021 году я писал здесь, как собирал отчётность в телеграм. Сейчас та же задача — это это просто бот на Hermes/Openclaw.
Чего скилл не умеет
Мастер кампаний. Его нет в API, и никакой скилл это не обойдёт. Агент подготовит пошаговую инструкцию с готовыми текстами и значениями, но кнопки в интерфейсе нажимать придётся самому.
Старые текстовые объявления. Летом Яндекс раскатал комбинаторные объявления, и скилл пишет только их. У старых объявлений он поменяет быстрые ссылки и уточнения, а основные тексты — нет: перечислит такие объявления и отправит в интерфейс.
Всё, чего нет в API. Официальное API покрывает далеко не весь кабинет. Скилл различает три случая — нет команды, нет метода в API, нет возможности в Директе — и даёт либо инструкцию, либо комментарий почему не получится.
Решать за вас, что считать результатом. Перед расчётом CPA агент спросит, какие цели ценны для бизнеса, и не возьмёт «все конверсии» по умолчанию.
Ссылки
Репозиторий со скиллами:
Непосредственно скилл Яндекс.Директа:
Разборы, новые скиллы и инструменты я выкладываю в телеграм-канале: Поляков считает. Скилл буду дорабатывать — предложения и баги присылайте в канал или в личку.
И вопрос: что бы вы первым делом доверили агенту в рекламном кабинете, а что не доверили бы ни за что? Интересно сверить со своим списком.