Навык полного цикла Яндекс Директа

yandex.direct

Навык для запуска Директа: Wordstat-семантика, ЕПК, комбинаторные объявления, модерация, Метрика и безопасные API-пакеты с dry-run

Скилл

Высокий риск

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

Почему такой уровень

  • Скрипт умеет выполнять реальную запись в Директ с флагом --execute, включая создание объявлений и кампаний
  • Требует токен Директа с доступом к боевому аккаунту
  • Перед первым запуском стоит проверить payload в режиме preview и убедиться, что кампании создаются остановленными
Все причины и проверки
Российский стек

shelpakovzhenya-art/yandex.direct

Установка

В терминале, через 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.

Понадобится: Node.js

Сверено с репозиторием 25 сент. 2026, коммит 6ed96d5.

Текст для агента

Установи навык командой 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

СкиллСредний рискРоссийский стекБез VPN12Звезды репозитория
Выбор редакции

MCP-сервер Яндекс Метрики, порожденный из спеки API: 108 методов, по умолчанию 10 инструментов, прозрачные фильтры и метаданные ответа

MCP-серверСредний рискРоссийский стекБез VPN2Звезды репозитория
Официальный

Открытый MCP-сервер и набор агентских скиллов для SEO: keyword research, конкуренты, обратные ссылки и аудит сайта по данным DataForSEO

MCP-серверСредний риск21,5 тыс.Звезды репозитория

Плагин Claude Code для SEO-аудита: технический SEO, E-E-A-T, schema, локальный и AI-поиск силами параллельных агентов

ПлагинВысокий риск17,9 тыс.Звезды репозитория
Foxx AIНавык полного цикла Яндекс Директа

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.