Скилл Яндекс Директа с оптимизацией по CPA
Yandex.Direct Skill для Claude Code
Скилл на Python без зависимостей: собирает кампании в Директе по blueprint, тянет лиды из Метрики и оптимизирует ставки к целевому CPA или ROI
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Создает и изменяет реальные кампании, ставки и бюджеты в боевом кабинете
- Автопилот может массово менять ставки без ручного контроля каждого шага
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/yandex-direct-skill-dlya-claude-codeОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Выполните в терминале в папке проекта
npx skills add slikti/skill_for_claude_code_yandex_direct --skill yandex-direct -a claude-code -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Выполните в терминале в папке проекта
npx skills add slikti/skill_for_claude_code_yandex_direct --skill yandex-direct -a cursor -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Выполните в терминале в папке проекта
npx skills add slikti/skill_for_claude_code_yandex_direct --skill yandex-direct -a github-copilot -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Выполните в терминале в папке проекта
npx skills add slikti/skill_for_claude_code_yandex_direct --skill yandex-direct -a codex -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Выполните в терминале в папке проекта
npx skills add slikti/skill_for_claude_code_yandex_direct --skill yandex-direct -a gemini-cli -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Выполните в терминале в папке проекта
npx skills add slikti/skill_for_claude_code_yandex_direct --skill yandex-direct -a cline -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Выполните в терминале в папке проекта
npx skills add slikti/skill_for_claude_code_yandex_direct --skill yandex-direct -a roo -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Форк Roo Code, папки .roo те же.
Выполните в терминале в папке проекта
npx skills add slikti/skill_for_claude_code_yandex_direct --skill yandex-direct -a opencode -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Скопируй папку yandex-direct из репозитория slikti/skill_for_claude_code_yandex_direct в ~/.claude/skills/, выполни cd scripts && cp config.example.json config.json, впиши OAuth-токен, counter_id и primary_goal_id, затем проверь связь командой python direct_api.py ping в режиме sandbox.
Другие способы из описания автора
cp -r yandex-direct ~/.claude/skills/Копирует папку скилла в глобальную директорию скиллов Claude Code.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Скилл строит кампании Яндекс Директа по API v5 из единого JSON-blueprint идемпотентно, без дублей при повторных запусках, ведет учет состояния в локальном state.json и умеет откатывать изменения через rollback.py. Отдельные скрипты собирают семантику с проверкой спроса, пишут объявления, работают с минус-словами и корректировками ставок, тянут лиды из Метрики и продажи из CRM для оптимизации по выручке, а не по заявкам. Есть автопилот недельного цикла с алертами аномалий бюджета, A/B-тест креативов со статистическим сравнением и генерация фото или баннеров через внешний API или MCP-коннектор. Все запросы, которые тратят деньги, требуют предварительного sandbox-режима и подтверждения перед переключением на боевой кабинет.
Для кого. Для директологов и владельцев малого бизнеса, которые хотят вести кампании Директа по целевой стоимости лида без ручной рутины.
Подходит, если
- Нужно собрать кампанию целиком из брифа: семантика, объявления, минус-слова
- Нужна оптимизация ставок к целевому CPA или ROI по данным из Метрики и CRM
- Нужен автопилот с алертами аномалий и откатом изменений
Не подходит, если
- Нет счетчика Метрики с настроенной целью: без нее оптимизация по лидам не заработает
- Нет отдельного сервиса или MCP-инструмента для генерации фото и баннеров, а нужны графические объявления
Пример запроса к агенту
Собери кампанию в Директе под доставку цветов в Москве с бюджетом 2000 рублей в деньОграничения
Нужен OAuth-токен с правами direct:api и metrika:read, счетчик Метрики и цель, а для креативов отдельный API-ключ или MCP-коннектор генерации изображений. По умолчанию включен режим sandbox, реальные деньги тратятся только после осознанного переключения на боевой кабинет. Зависимостей кроме стандартной библиотеки Python нет, но нужен установленный Python 3.8 и выше. Токен и config.json не коммитятся и должны храниться локально.
Как отключить. Удалите папку yandex-direct из .claude/skills/ проекта или из ~/.claude/skills/.
Проверка безопасности
- Создает и изменяет реальные кампании, ставки и бюджеты в боевом кабинете
- Автопилот может массово менять ставки без ручного контроля каждого шага
Коротко о README
README представляет скилл как замену директолога: сборка кампаний, объявления, лиды из Метрики, оптимизация ставок и бюджетов. Описаны установка копированием папки, настройка OAuth-токена и счетчика Метрики за 15 минут, список сценариев на русском языке, структура скриптов, режим песочницы по умолчанию, пайплайн генерации креативов через API или MCP и меры безопасности: gitignore для токена, подтверждение боевых правок, аудит-лог.
SKILL.md
--- name: yandex-direct description: Run and grow Yandex.Direct ad campaigns end-to-end via the Direct API v5 and Metrica. Create campaigns, ad groups, keywords and ads; generate ad copy (titles/texts/sitelinks); track leads; and optimize bids/budgets toward a target CPA/ROI. Use when the user asks to set up, manage, audit, scale, or optimize Yandex.Direct (Яндекс Директ) advertising, generate ad creatives/texts, lower CPA, find wasted spend, or report on campaign performance. --- # Yandex.Direct — autonomous campaign management Manage a user's Yandex.Direct account: build campaigns, write the copy, track leads through Metrica, and optimize spend toward a target cost-per-lead (CPA) and positive ROI. ## First: mandatory onboarding Before any API action, the agent must collect and confirm two access blocks: 1. Yandex.Direct access: OAuth token for Direct/Metrica, sandbox vs production mode, Metrica counter id + primary goal id 2. Creative production access for photos/banners: provider type (api or mcp), provider/service name, auth token, expected asset types If any of these are missing, stop and ask the user for them first. Do not invent credentials, do not silently skip the creative provider. **Money is real in production.** Confirm with the user before: switching sandbox to false, raising budgets/bids in production, or applying bulk changes on a live account.
Частые вопросы
Можно потратить деньги случайно?
По умолчанию включен sandbox, боевые изменения и массовые правки требуют явного подтверждения и флага --apply.
Как откатить изменения?
Скриптом rollback.py, состояние всех операций хранится локально в state.json для идемпотентности.
Похожие
Скиллы 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-поиск силами параллельных агентов