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

yandex.direct

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

  • 0 ★ репозитория
  • Последний коммит
  • MIT
Скилл

Широкий доступ

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

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

shelpakovzhenya-art/yandex.direct

Установка

Работает в

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/yandex-direct

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

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

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Навык $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 из каталога навыков агента.

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

Может ли навык сразу опубликовать кампанию?

Нет, все вызовы Wordstat и Direct по умолчанию preview, живая запись требует флага --execute и отдельного токена подтверждения.

Нужны ли сторонние Python-пакеты?

Нет, скрипт yandex_direct_toolkit.py вызывает Wordstat v2 и Direct API напрямую.

Чем навык полного цикла Яндекс Директа отличается от других навыков для Директа?

Навык $yandex-direct проводит агента через весь цикл рекламы: семантика через Wordstat v2 с ассоциациями и сезонностью, разделение измеренных данных и гипотез, структура кампаний, ЕПК, комбинаторные объявления, модерация, Метрика и API-пакеты с режимом dry-run.

Может ли навык сразу опубликовать кампанию и нужны ли сторонние пакеты Python?

Пакеты с dry-run сначала показывают, что изменится, публикацию вы подтверждаете сами. Установка: npx skills add shelpakovzhenya-art/yandex.direct, навык для Codex. Требования к Python смотрите в README. Риск высокий, работа идет с рекламным бюджетом.

Обсуждение

Вопросов и отзывов пока нет.

Российский стек

Read-only навык для Codex: структура ЕПК, Поиск и РСЯ, минус-слова, модерация, стратегии и цели Метрики без доступа к API

СкиллМинимальный доступ
Российский стек

Плагин Codex и Claude Code со скиллами и MCP для Яндекс Директа, Метрики, Wordstat v2, Roistat, amoCRM и Yandex Search API

ПлагинШирокий доступ21Звезды репозитория
Российский стек

Скилл для аудита и ведения кампаний Яндекс Директа через API v5: 55 проверок, грейд A-F, создание объявлений и отчеты

СкиллШирокий доступ64Звезды репозитория
Российский стек

Скилл ведет новую кампанию Яндекс Директа от брифа до черновика в кабинете: семантика, минус-слова, объявления, цели Метрики и ставки

СкиллШирокий доступ14Звезды репозитория
Российский стек

MCP-сервер для аналитики Директа, Метрики, Wordstat и Аудиторий: сырые отчеты, сопоставление данных и HTML-дашборд

MCP-серверРасширенный доступ9Звезды репозитория

Коротко о README

README на русском и английском описывает десять режимов навыка: сбор семантики, проверку интента, анализ конкурентов, архитектуру ЕПК, комбинаторные объявления, посадочные страницы, модерацию, Метрику и оптимизацию, A/B-тесты и безопасный API. Показаны команды установки через npx skills add, примеры запуска toolkit-скрипта с валидацией пакета и сборкой payload, требования к переменным окружения и команды верификации через unittest.

Бейдж для README

Исходный SKILL.md

---
name: yandex-direct
description: >-
  Планирует, создает, проверяет и оптимизирует кампании Яндекс Директа:
  Wordstat-семантика, интенты, ЕПК, комбинаторные объявления, минус-фразы,
  посадочные, Метрика, эксперименты и безопасные API-пакеты. Использовать для
  запуска, аудита или масштабирования Яндекс Директа; не использовать как
  обещание гарантированных продаж.
---

# Yandex Direct Growth Engine

Управляй не кликами, а проверяемой экономикой: целевые конверсии, прибыль,
маржа, ДРР/CPA и качество лидов. Не обещай результат, который зависит от
аукциона, оффера, сайта или внешнего спроса.

## Неподвижные правила

- Перед исследованием установи продукт, географию, тип клиента, целевое действие,
  маржу/допустимый CPA, бюджет, URL и факты, которые можно подтвердить на сайте.
- Не выдумывай частотность, цены, сроки, отзывы, рейтинги, гарантии и преимущества.
- Перед live-записью покажи точный payload, окружение, объекты, бюджет и последствия;
  получи отдельное явное подтверждение. Создавай новые кампании остановленными.
- Не меняй ставки, бюджеты, стратегии, статусы и минус-фразы live-аккаунта как
  побочный эффект аудита. Чтение аккаунта не разрешает запись.

Сообщить о проблеме