Скилл для Яндекс Директа: от семантики до файла загрузки

Агент собирает фразы и минус-слова, пишет комбинаторные объявления, быстрые ссылки и уточнения, а скрипт проверяет лимиты Директа и готовит XLSX для загрузки или запросы к API.

Скачать скилл Как установить

Стеклянный знак Яндекса с жёлтым курсором, от него бирюзовые потоки к карточкам поисковых объявлений и воронке

Коротко: скилл берёт на себя рутину запуска кампании в Директе: группы по намерениям, фразы с операторами, минус-слова на кампанию и группы, до 7 заголовков и 3 текстов комбинаторного объявления, быстрые ссылки и уточнения. Скрипт проверяет каждую строку по лимитам Директа — 56 знаков в заголовке, 81 в тексте, 25 в уточнении — и выгружает XLSX для загрузки. Кампанию загружаете и запускаете вы. Скилл бесплатный, запуск на Claude Sonnet 5.5 через kosareva.cloud — ≈ 55 ₽ за кампанию на 3–5 групп.

/ Что делает

Что делает скилл

Агент пишет, скрипт считает: длину строк и дубли проверяет код, а не модель на глаз.

Семантика по группам

Группа — одно намерение: «купить», «с доставкой», «для офиса». Фразы с операторами ! + " [ ] и минус-словами.

Минус-слова

На кампанию и на группы, плюс кросс-минусовка: скрипт находит одинаковые фразы в разных группах.

Объявления ЕПК

До 7 заголовков по 56 знаков и до 3 текстов по 81 — разные по смыслу, без выдуманных скидок и «№1».

Быстрые ссылки и уточнения

До 8 ссылок по 30 знаков, заголовки четырёх — вместе до 66, уточнения по 25.

Проверка лимитов

Длина с узкими знаками и без, длина слов, 7 слов во фразе, отображаемая ссылка, суммы по блокам.

Файл для загрузки

XLSX по шаблону Директа для «Управления с помощью Excel» и Коммандера или JSON-запросы к API v5.

/ Для кого

Кому пригодится

Агентству и специалисту по Директу

Собрать черновик кампании нового клиента за вечер, а время потратить на стратегию и посадочные.

Маркетологу в компании

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

Владельцу небольшого бизнеса

Разобраться, из чего состоит кампания в Директе, и не получить отказ модерации за длину строк.

/ Пример

Как попросить и что получите

Ниже — настоящий вывод скрипта на учебной кампании из архива скилла. Сначала два уточнения не влезли в 25 знаков — файл не создан, пока их не поправили.

Собери кампанию ЕПК для example.ru/kofe: кофе в зёрнах, Москва и область, доставка на следующий день, есть поставки в офисы по договору. Растворимый и капсулы не продаём. Нужен файл для загрузки через Excel.

$ python3 scripts/direct_campaign.py check campaign.json
Кампания «Кофе в зёрнах — поиск, Москва»: групп 2, фраз 7, объявлений 2
✗ группа «Кофе в зёрнах — купить», объявление 1: уточнение
  «Доставка на следующий день» — 26 знаков, можно 25
✗ группа «Кофе для офиса», объявление 1: уточнение
  «Договор и закрывающие документы» — 31 знак, можно 25

✗ Ошибок: 2, предупреждений: 0. Файл для Директа не создан

$ python3 scripts/direct_campaign.py xlsx campaign.json kampaniya.xlsx
✓ Лимиты Директа соблюдены, предупреждений: 0
→ kampaniya.xlsx — строк объявлений: 7

Название группы:  Кофе в зёрнах — купить
Фраза:            кофе в зернах +с доставкой
Заголовок 1:      Кофе в зёрнах с обжаркой под заказ
Заголовок 2:      Свежая обжарка — отправим через день
Текст 1:          Обжариваем каждую партию после заказа. Доставка…
Быстрые ссылки:   Каталог сортов||Доставка и оплата||Обжарка под заказ||Для офиса
Уточнения:        Доставка на завтра||Обжарка после заказа||Пачки 250 г и 1 кг
Минус на группу:  растворимый, капсулы

/ Что внутри

Файлы скилла

Обычные текстовые файлы и скрипты на Python без сторонних зависимостей — перед установкой их можно прочитать целиком.

/ Архив, 17 КБ

yandex-direct.zip

Папка yandex-direct — распакуйте её в папку скиллов агента.

SKILL.md — Порядок работы: бриф, семантика, минус-слова, объявления, проверка, выгрузка
scripts/direct_campaign.py — Проверка лимитов и дублей, выгрузка XLSX и JSON для API — только стандартная библиотека Python
references/limits.md — Лимиты Директа и операторы ключевых фраз со ссылками на справку
references/api.md — Загрузка файлом и через API v5: доступ, песочница, порядок запросов
examples/campaign.json — Учебная кампания на две группы — проверить скилл можно без своих данных

Скачать архив

/ Отдельно

SKILL.md

Инструкция для агента — обычный Markdown. По ней видно, что и как агент будет делать с вашими файлами.

В начале — name и description: по ним агент решает, когда включать скилл
Справочники из references/ агент открывает, только когда они нужны
Скрипт проверки и выгрузки работает на вашем компьютере и ничего не отправляет в интернет
В Директ скилл ничего не загружает: файл загружаете вы, API — только с вашим токеном
Учебная кампания в examples/ выдумана: магазин, сайт и тексты
Это обычный текст — поправьте под свои шаблоны и правила

Скачать SKILL.md

/ Установка

Поставить за минуту

Архив — это папка скилла. Её нужно положить туда, где агент ищет скиллы, и перезапустить агента, если он уже открыт.

/1
Скачайте архив
yandex-direct.zip — внутри папка yandex-direct со SKILL.md и остальными файлами.
/2
Распакуйте в папку скиллов
Claude Code — ~/.claude/skills/, Codex — ~/.agents/skills/, Cursor — ~/.cursor/skills/. Для одного проекта — те же папки внутри проекта.
/3
Подключите агента к ключу
Чтобы платить за токены в рублях, Claude Code и Codex подключаются к kosareva.cloud переменными окружения — инструкция.

Получить API-ключ

Пути проверены по документации Claude Code, Codex и Cursor 9 октября 2026.

# macOS / Linux
S=yandex-direct
curl -LO https://kosareva.cloud/skills/$S/$S.zip
mkdir -p ~/.claude/skills
unzip -o $S.zip -d ~/.claude/skills/

# Windows (PowerShell)
$S = "yandex-direct"
curl.exe -LO "https://kosareva.cloud/skills/$S/$S.zip"
Expand-Archive "$S.zip" "$HOME\.claude\skills" -Force

# Запуск: в Claude Code наберите /yandex-direct
# или просто опишите задачу — агент подхватит скилл сам

# macOS / Linux
S=yandex-direct
curl -LO https://kosareva.cloud/skills/$S/$S.zip
mkdir -p ~/.agents/skills
unzip -o $S.zip -d ~/.agents/skills/

# Windows (PowerShell)
$S = "yandex-direct"
curl.exe -LO "https://kosareva.cloud/skills/$S/$S.zip"
Expand-Archive "$S.zip" "$HOME\.agents\skills" -Force

# Запуск: в Codex наберите $yandex-direct или откройте список /skills

# macOS / Linux
S=yandex-direct
curl -LO https://kosareva.cloud/skills/$S/$S.zip
mkdir -p ~/.cursor/skills
unzip -o $S.zip -d ~/.cursor/skills/

# Windows (PowerShell)
$S = "yandex-direct"
curl.exe -LO "https://kosareva.cloud/skills/$S/$S.zip"
Expand-Archive "$S.zip" "$HOME\.cursor\skills" -Force

# Cursor читает и ~/.claude/skills — второй копии не нужно
# Запуск: в чате агента наберите /yandex-direct

/ Сколько стоит запуск

Скилл бесплатный — платите за токены агента

Считаем один запуск: кампания на 3–5 групп: агент читает скилл и справочник лимитов, собирает фразы, минус-слова и объявления, дважды прогоняет проверку и выгружает файл — 14 обращений к модели, контекст растёт с 26 до 72 тыс. токенов, ответ ~1,5 тыс. токенов за обращение. Цены — из каталога kosareva.cloud за 1 млн токенов, в рублях.

Модель	Вход / выход за 1 млн	С кэшем	Без кэша
Claude Sonnet 5.5 — Claude Code	216 / 1 080 ₽	≈ 55 ₽	≈ 170 ₽
GPT-5.6 — Codex	432 / 2 160 ₽	≈ 103 ₽	≈ 340 ₽

За запуск уходит ≈ 683 тыс. токенов на вход, из них ≈ 611 тыс. — повтор уже прочитанного, и ≈ 21 тыс. на выход. Claude Code и Codex кэшируют повторяющийся контекст сами: он идёт по цене чтения из кэша (у Claude Sonnet 5.5 — 21,6 ₽ за 1 млн), поэтому реальная цена ближе к колонке «С кэшем». Точная сумма — в расходах по ключу в кабинете. В Cursor скилл работает на моделях вашей подписки Cursor — этот расход мы не считаем.

/ Как пользоваться

Как собрать кампанию

Первая кампания — около часа вместе с правками. Дальше агент работает по вашему брифу и правилам, которые вы допишете в SKILL.md.

Дайте бриф

Что продаёте, ссылки на посадочные страницы, регион, чем отличаетесь — только факты, — и чего точно не продаёте.

/yandex-direct кампания для example.ru/kofe, Москва

Проверьте семантику

Агент предложит группы и фразы по смыслу. Частотность проверьте в Вордстате: доступа к нему у агента нет.

Поправьте объявления

Заголовки и тексты — черновик. Уберите то, чего нет на сайте, допишите свои факты, агент перепроверит длину.

Получите файл

Скрипт не создаст файл, пока есть ошибки: Директ всё равно не принял бы такие строки.

python3 scripts/direct_campaign.py xlsx campaign.json kampaniya.xlsx

Загрузите в Директ

Инструменты → «Управление с помощью Excel» → создать новую кампанию. Стратегию, бюджет и цели Метрики задайте в настройках кампании.

/ Честно

Чего скилл не делает

Ведёте много клиентов в Директе и нужен скилл под ваши шаблоны?

Написать в Telegram

Не запускает рекламу

Файл загружаете вы, на модерацию отправляете вы. Через API — только с вашим OAuth-токеном и после проверки.

Не знает частотность и ставки

Доступа к Вордстату и прогнозу бюджета у агента нет — фразы проверяйте в Директе.

Не настраивает стратегию

Бюджет, стратегия, цели и счётчик Метрики — в настройках кампании в интерфейсе Директа.

Не гарантирует модерацию

Длину строк скрипт проверит, а соответствие правилам рекламы оценивает Яндекс.

/ FAQ

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

Скилл сам загрузит кампанию в Директ?

Нет. Он готовит файл XLSX для загрузки через «Управление с помощью Excel» или Директ Коммандер и JSON-запросы к API. Загрузка через API возможна только с OAuth-токеном владельца аккаунта и одобренной заявкой на доступ — агент спросит, прежде чем что-то отправлять, и начнёт с песочницы.

Подходит ли для Единой перфоманс-кампании?

Да, файл собирается под ЕПК: комбинаторное объявление с заголовками 1–7 и текстами 1–3. Для API в файле — первый заголовок и текст плюс доп. заголовок; комбинаторные варианты целиком надёжнее загружать файлом.

Откуда лимиты и что, если Директ их поменяет?

Из справки Директа, сверены 9 октября 2026 года, ссылки — в references/limits.md. Числа лежат в одном месте в начале скрипта: поменялись правила — поправьте их там или скачайте обновлённый скилл.

Агентству можно вести так нескольких клиентов?

Да. Удобно завести в kosareva.cloud отдельный API-ключ на каждого клиента с лимитом в рублях: расход агента по клиенту будет виден по ключу, а в API Директа клиент выбирается заголовком Client-Login.

/ Дальше

Дальше

Запускайте скиллы на ключе kosareva.cloud

Claude Code и Codex подключаются к нашему API за пару минут. Оплата в рублях — картой РФ или СБП от 50 ₽, юрлицам по счёту.

Получить ключ