Навык полного цикла Яндекс Директа
yandex.direct
Навык для запуска Директа: Wordstat-семантика, ЕПК, комбинаторные объявления, модерация, Метрика и безопасные API-пакеты с dry-run
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Скрипт умеет выполнять реальную запись в Директ с флагом --execute, включая создание объявлений и кампаний
- Требует токен Директа с доступом к боевому аккаунту
- Перед первым запуском стоит проверить payload в режиме preview и убедиться, что кампании создаются остановленными
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/yandex-directОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Выполните в терминале в папке проекта
npx skills add shelpakovzhenya-art/yandex.direct --skill yandex-direct -a claude-code -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 6ed96d5
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/shelpakovzhenya-art/yandex.direct.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/yandex-direct/
git -C "$tmp" checkout 6ed96d5babda57d85600b70823a532e92c73e40e
mkdir -p .claude/skills
cp -R "$tmp/skills/yandex-direct" .claude/skills/yandex-directКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add shelpakovzhenya-art/yandex.direct --skill yandex-direct -a cursor -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 6ed96d5
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/shelpakovzhenya-art/yandex.direct.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/yandex-direct/
git -C "$tmp" checkout 6ed96d5babda57d85600b70823a532e92c73e40e
mkdir -p .agents/skills
cp -R "$tmp/skills/yandex-direct" .agents/skills/yandex-directКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add shelpakovzhenya-art/yandex.direct --skill yandex-direct -a github-copilot -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 6ed96d5
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/shelpakovzhenya-art/yandex.direct.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/yandex-direct/
git -C "$tmp" checkout 6ed96d5babda57d85600b70823a532e92c73e40e
mkdir -p .github/skills
cp -R "$tmp/skills/yandex-direct" .github/skills/yandex-directКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add shelpakovzhenya-art/yandex.direct --skill yandex-direct -a codex -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 6ed96d5
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/shelpakovzhenya-art/yandex.direct.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/yandex-direct/
git -C "$tmp" checkout 6ed96d5babda57d85600b70823a532e92c73e40e
mkdir -p .agents/skills
cp -R "$tmp/skills/yandex-direct" .agents/skills/yandex-directКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add shelpakovzhenya-art/yandex.direct --skill yandex-direct -a gemini-cli -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 6ed96d5
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/shelpakovzhenya-art/yandex.direct.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/yandex-direct/
git -C "$tmp" checkout 6ed96d5babda57d85600b70823a532e92c73e40e
mkdir -p .agents/skills
cp -R "$tmp/skills/yandex-direct" .agents/skills/yandex-directКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/shelpakovzhenya-art/yandex.direct.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/yandex-direct/
git -C "$tmp" checkout 6ed96d5babda57d85600b70823a532e92c73e40e
mkdir -p .devin/skills
cp -R "$tmp/skills/yandex-direct" .devin/skills/yandex-directКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Бывший Windsurf.
Выполните в терминале в папке проекта
npx skills add shelpakovzhenya-art/yandex.direct --skill yandex-direct -a cline -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 6ed96d5
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/shelpakovzhenya-art/yandex.direct.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/yandex-direct/
git -C "$tmp" checkout 6ed96d5babda57d85600b70823a532e92c73e40e
mkdir -p .cline/skills
cp -R "$tmp/skills/yandex-direct" .cline/skills/yandex-directКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add shelpakovzhenya-art/yandex.direct --skill yandex-direct -a roo -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 6ed96d5
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/shelpakovzhenya-art/yandex.direct.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/yandex-direct/
git -C "$tmp" checkout 6ed96d5babda57d85600b70823a532e92c73e40e
mkdir -p .roo/skills
cp -R "$tmp/skills/yandex-direct" .roo/skills/yandex-directКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Форк Roo Code, папки .roo те же.
Выполните в терминале в папке проекта
npx skills add shelpakovzhenya-art/yandex.direct --skill yandex-direct -a opencode -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 6ed96d5
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/shelpakovzhenya-art/yandex.direct.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/yandex-direct/
git -C "$tmp" checkout 6ed96d5babda57d85600b70823a532e92c73e40e
mkdir -p .agents/skills
cp -R "$tmp/skills/yandex-direct" .agents/skills/yandex-directКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/shelpakovzhenya-art/yandex.direct.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/yandex-direct/
git -C "$tmp" checkout 6ed96d5babda57d85600b70823a532e92c73e40e
mkdir -p .agents/skills
cp -R "$tmp/skills/yandex-direct" .agents/skills/yandex-directКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/shelpakovzhenya-art/yandex.direct.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/yandex-direct/
git -C "$tmp" checkout 6ed96d5babda57d85600b70823a532e92c73e40e
mkdir -p .agents/skills
cp -R "$tmp/skills/yandex-direct" .agents/skills/yandex-directКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Установи навык командой npx skills add shelpakovzhenya-art/yandex.direct, задай токены Wordstat и Директа в .env.local, вызывай его фразой Используй $yandex-direct.
Другие способы из описания автора
npx skills add shelpakovzhenya-art/yandex.directКоманда быстрой установки из README.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Навык $yandex-direct проводит агента через весь цикл рекламы в Директе: собирает семантику через Wordstat v2 с ассоциациями и сезонностью, отделяет измеренные данные от гипотез, проектирует структуру ЕПК с разделением Поиска, РСЯ, бренда и ретаргетинга, генерирует комбинаторные объявления ResponsiveAd (до 7 заголовков и 3 текстов), проверяет модерацию и соответствие посадочной странице, строит план измерения через цели Метрики, CPA и ДРР, и проектирует A/B-тесты. Скрипт yandex_direct_toolkit.py умеет вызывать Wordstat и Direct API напрямую без сторонних Python-пакетов, но по умолчанию все вызовы это preview: реальная запись в Директ требует флага --execute и отдельного токена подтверждения, который печатает предпросмотр.
Для кого. Для специалистов по контекстной рекламе, которые хотят вести запуск Директа от семантики до боевых объявлений через агента с контролем на каждом шаге.
Подходит, если
- Нужен полный цикл: семантика, структура кампаний, объявления, модерация, измерение
- Важно контролировать live-изменения через явное подтверждение перед каждой записью
- Нужны комбинаторные объявления ResponsiveAd под API v501
Не подходит, если
- Нужен только safe read-only аудит без возможности реальной записи: тут запись предусмотрена архитектурой
- Нет доступа к Wordstat v2 и Direct API токенам: без них навык работает только в режиме советов без реальных данных
Пример запроса к агенту
Собери семантику для установки теплиц в Московской области, спроектируй ЕПК и подготовь комбинаторные объявления без публикацииОграничения
Токены Wordstat (YANDEX_SEARCH_API_KEY, YANDEX_FOLDER_ID) и Директа (YANDEX_DIRECT_TOKEN) нужно завести самостоятельно и никогда не коммитить. Платные вызовы Wordstat и live-запись в Директ требуют отдельных токенов подтверждения. Навык не гарантирует продажи или победу над конкурентами, он усиливает только управляемые части: качество спроса, релевантность и скорость итераций.
Как отключить. Удалите папку skills/yandex-direct из каталога навыков агента.
Проверка безопасности
- Скрипт умеет выполнять реальную запись в Директ с флагом --execute, включая создание объявлений и кампаний
- Требует токен Директа с доступом к боевому аккаунту
- Перед первым запуском стоит проверить payload в режиме preview и убедиться, что кампании создаются остановленными
Коротко о README
README на русском и английском описывает десять режимов навыка: сбор семантики, проверку интента, анализ конкурентов, архитектуру ЕПК, комбинаторные объявления, посадочные страницы, модерацию, Метрику и оптимизацию, A/B-тесты и безопасный API. Показаны команды установки через npx skills add, примеры запуска toolkit-скрипта с валидацией пакета и сборкой payload, требования к переменным окружения и команды верификации через unittest.
SKILL.md
--- name: yandex-direct description: >- Планирует, создает, проверяет и оптимизирует кампании Яндекс Директа: Wordstat-семантика, интенты, ЕПК, комбинаторные объявления, минус-фразы, посадочные, Метрика, эксперименты и безопасные API-пакеты. Использовать для запуска, аудита или масштабирования Яндекс Директа; не использовать как обещание гарантированных продаж. --- # Yandex Direct Growth Engine Управляй не кликами, а проверяемой экономикой: целевые конверсии, прибыль, маржа, ДРР/CPA и качество лидов. Не обещай результат, который зависит от аукциона, оффера, сайта или внешнего спроса. ## Неподвижные правила - Перед исследованием установи продукт, географию, тип клиента, целевое действие, маржу/допустимый CPA, бюджет, URL и факты, которые можно подтвердить на сайте. - Не выдумывай частотность, цены, сроки, отзывы, рейтинги, гарантии и преимущества. - Перед live-записью покажи точный payload, окружение, объекты, бюджет и последствия; получи отдельное явное подтверждение. Создавай новые кампании остановленными. - Не меняй ставки, бюджеты, стратегии, статусы и минус-фразы live-аккаунта как побочный эффект аудита. Чтение аккаунта не разрешает запись.
Частые вопросы
Может ли навык сразу опубликовать кампанию?
Нет, все вызовы Wordstat и Direct по умолчанию preview, живая запись требует флага --execute и отдельного токена подтверждения.
Нужны ли сторонние Python-пакеты?
Нет, скрипт yandex_direct_toolkit.py вызывает Wordstat v2 и Direct API напрямую.
Похожие
Скиллы DataLens
DataLens Skills
Официальные скиллы DataLens (Яндекс) для Claude Code, Codex и OpenCode: SDK, HTML-отчеты и разбор прав RLS
MCP Яндекс Метрики со всеми 108 методами API
Yandex Metrika MCP Server
MCP-сервер Яндекс Метрики, порожденный из спеки API: 108 методов, по умолчанию 10 инструментов, прозрачные фильтры и метаданные ответа
Открытый MCP-сервер и набор агентских скиллов для SEO: keyword research, конкуренты, обратные ссылки и аудит сайта по данным DataForSEO
Плагин Claude Code для SEO-аудита: технический SEO, E-E-A-T, schema, локальный и AI-поиск силами параллельных агентов