yandex-direct-manager

Установка

git clone https://github.com/ai-hub-open/yandex-direct-manager.git
cd yandex-direct-manager
python install.py
cp -r yandex-direct-manager ~/.claude/skills/

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

Что делает

Скилл проводит агента по десяти шагам создания кампании и на каждом сохраняет файл в рабочую папку, поэтому после обрыва сессии работа продолжается с места остановки. Агент собирает бриф, строит маски и проверяет частотности в Wordstat, расширяет и кластеризует семантику, проектирует структуру единой кампании и три уровня минус-слов. Затем настраивает цели в Метрике, пишет объявления с проверкой лимитов Директа, готовит стратегию торгов и после предпросмотра создает кампанию в статусе черновика. Цена клика берется из данных аккаунта, аукциона или прогноза с указанием источника, а на контрольных точках агент ждет решения маркетолога.

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

Пример запроса к агенту

Сделай рекламную кампанию в Директе для доставки цветов по Москве, бюджет 100 тысяч в месяц

Ограничения

Скилл только создает новую кампанию и не ведет ее дальше. Для Директа и Wordstat используются хостовые MCP-серверы click.ru, нужен API-токен click.ru, и доступны только кабинеты, подключенные в click.ru. Для скриптов нужен Python 3.9, без запуска кода часть проверок выполняется вручную. Проект до версии 1.0, состав шагов может меняться.

Как отключить. Удалите папку yandex-direct-manager из ~/.claude/skills и уберите MCP-серверы командой python -m scripts.setup_yandex_direct_mcp с флагом --remove.

Проверка безопасности

• Создает кампании, объявления, ставки и цели Метрики в рабочем рекламном кабинете
• Передает токен click.ru и данные кабинета через сторонние хостовые MCP-серверы

Коротко о README

README на русском описывает договор скилла: на входе бриф и доступ к кабинету, на выходе кампания и файлы с обоснованием. Таблица маршрута перечисляет шаги и их артефакты, отдельно объяснены источники цены клика, загрузка картинок и контрольные точки. Установка через install.py и копирование в каталог скиллов, подключение MCP скриптом с токеном click.ru. Лицензия Apache 2.0.

SKILL.md

---
name: yandex-direct-manager
description: Тактический пайплайн создания рекламной кампании в Яндекс.Директе через MCP — сбор семантики через Wordstat, кластеризация на НЧ/СЧ/ВЧ и Поиск/РСЯ, минусация (3 уровня + кросс), создание объявлений по лимитам Директа, настройка целей в Метрике, выбор стратегии торгов и заливка в DRAFT. Используй когда пользователь говорит «сделай РК в Директе», «собери семантику», «нужны ключи и минусы», «напиши объявления», «запусти кампанию», «залей через MCP». Не для аналитики, не для оптимизации работающих кампаний, не для стратегии бренда — только создание новой кампании от брифа до DRAFT.
---

# Yandex Direct — пайплайн создания кампании

Скилл проводит маркетолога от брифа до залитой в **DRAFT** рекламной кампании в Яндекс.Директе. Фокус — только **создание**: семантика → кластеризация → минусы → объявления → заливка. Аналитика, оптимизация уже работающих кампаний, исследования рынка — **не задача этого скилла**.

Пайплайн опирается на два MCP: `yandex-direct` (прогноз CPC, аудит аккаунта, дедупликация, заливка кампании целиком) и `yandex-wordstat` (частотности и сбор семантики на Шагах 1 и 3). Оба — **хостовые серверы aihub.click.ru**: локально ничего не запускается, Bun и клон репозитория не нужны. Подключение — `scripts/setup_yandex_direct_mcp.py` (пишет конфиги Cursor / Claude Code / Claude Desktop), общий справочник — `docs/hosted-mcp-setup.md` репозитория пакета. Скилл не проверяет подключение MCP заранее — если на каком-то шаге инструмент не отвечает, обрабатываем ошибку по месту: Шаг 2 уходит на справочник CPC, Шаги 1 и 3 — на `scripts/wordstat_api.py` или браузер, Шаг 10 — на Директ Коммандер.

## Что нужно от среды

**Обязательный минимум — две способности:**

- **Чтение и запись файлов** в рабочей папке `direct-campaigns/<slug>/`. На этом держится весь пайплайн: каждый шаг порождает артефакт, следующий шаг его читает.
- **Диалог с пользователем** — задать вопрос, получить ответ, дождаться подтверждения. Без этого не работают гейты `[GATE: маркетолог]`, а они здесь не формальность: заливка идёт только после явного «ОК».

Похожие