Скилл Яндекс Директа с оптимизацией по CPA

Yandex.Direct Skill для Claude Code

Скилл на Python без зависимостей: собирает кампании в Директе по blueprint, тянет лиды из Метрики и оптимизирует ставки к целевому CPA или ROI

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

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

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

  • Создает и изменяет реальные кампании, ставки и бюджеты в боевом кабинете
  • Автопилот может массово менять ставки без ручного контроля каждого шага
Все причины и проверки
Российский стек

slikti/skill_for_claude_code_yandex_direct

Установка

Работает в

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

npx skillfoxx add skills/yandex-direct-skill-dlya-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/.

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

Можно потратить деньги случайно?

По умолчанию включен sandbox, боевые изменения и массовые правки требуют явного подтверждения и флага --apply.

Как откатить изменения?

Скриптом rollback.py, состояние всех операций хранится локально в state.json для идемпотентности.

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

Скилл на Python без зависимостей строит кампании по API v5 из единого JSON-blueprint идемпотентно, без дублей при повторных запусках, ведет состояние в state.json, умеет откатывать изменения. Тянет лиды из Метрики и оптимизирует ставки к целевому CPA или ROI.

Можно ли случайно потратить деньги и как откатить изменения?

Скилл управляет рекламным кабинетом, поэтому деньги потратить можно: проверяйте blueprint и бюджеты до запуска. Изменения откатываются средствами скилла по записям в state.json. Установка: cp -r yandex-direct ~/.claude/skills/. Риск высокий.

Обсуждение

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

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

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

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

Agent Skill для аудита, оптимизации и API v5 Яндекс Директа целиком: поиск, РСЯ, ЕПК, стратегии, атрибуция и Директ Коммандер

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

Пять cache-first скиллов на shell для Direct, Метрики, Вебмастера, Wordstat и Search API: Claude сам решает, какой запустить

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

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

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

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

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

Коротко о README

README представляет скилл как замену директолога: сборка кампаний, объявления, лиды из Метрики, оптимизация ставок и бюджетов. Описаны установка копированием папки, настройка OAuth-токена и счетчика Метрики за 15 минут, список сценариев на русском языке, структура скриптов, режим песочницы по умолчанию, пайплайн генерации креативов через API или MCP и меры безопасности: gitignore для токена, подтверждение боевых правок, аудит-лог.

Бейдж для README

Исходный 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.

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