Скилл Яндекс Директа

Yandex Direct Skill

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

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

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

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

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

silverov/yandex-direct-skill

Установка

Работает в

Ручная установка

cp -r yandex-direct ~/.claude/skills/

После клонирования репозитория скопируйте папку скилла в директорию скиллов Claude Code.

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

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

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

  • Может создавать и менять кампании, ставки и объявления в реальном рекламном аккаунте
  • Тратит рекламный бюджет через API, ошибка агента приведет к реальным расходам

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

Что делает

Скилл дает агенту команды для работы с Яндекс Директом через REST API v5: аудит аккаунта, список кампаний, создание кампаний с группами и объявлениями, управление ключевыми словами и минус-словами, отчеты по CTR, CPC и расходу, рекомендации по оптимизации и анализ бюджета. Аудит проходит по 55 проверкам в шести категориях (конверсии и Метрика, слив бюджета, структура аккаунта, ключевые слова, объявления, настройки и таргетинг), взвешенный балл переводится в грейд от A до F. В комплект входят справочники с бенчмарками российского рынка по CTR, CPC и CVR и таблицей решений по стратегиям ставок.

Для кого. Для специалистов по контекстной рекламе и маркетологов, которые ведут кампании в Яндекс Директе и хотят поручить рутину агенту.

Подходит, если

  • Нужен быстрый аудит аккаунта Яндекс Директа с оценкой и списком проблем
  • Нужно создать кампанию или объявления через агента, не заходя в интерфейс Директа
  • Нужны регулярные отчеты по CTR, CPC и расходу с учетом бенчмарков рынка

Не подходит, если

  • Нужна реклама в Google Ads, VK или другой системе: скилл покрывает только Директ
  • Нет доступа к API Директа и OAuth-токена: без них скилл не заработает

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

Проведи аудит моего аккаунта в Яндекс Директе и покажи, что сливает бюджет

Ограничения

Нужен собственный доступ к API Директа и OAuth-токен, которые Яндекс выдает по заявке. Учетные данные хранятся в незашифрованном JSON-файле на диске, права на файл нужно ограничивать вручную. Проект молодой и написан под конкретный кейс одного агентства, формальных релизов и тестов нет. Скрипты интеграции написаны на bash и рассчитаны на Unix-окружение.

Как отключить. Удалите папку yandex-direct из директории скиллов агента, например ~/.claude/skills/yandex-direct.

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

Сколько проверок делает аудит?

55 проверок в шести категориях с весами, итоговый балл 0-100 переводится в грейд A-F.

Где хранится токен Директа?

В файле ~/.secrets/yandex-direct.json вместе с client_id и client_secret, доступ к файлу нужно ограничить самостоятельно.

Обсуждение

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

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

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

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

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

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

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

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

Agent Skill для Библиотеки Яндекс Директа: аудиторные сегменты, фиды, пакетные стратегии, A/B-эксперименты и посадочные страницы

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

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

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

Альтернативы

Инструменты других авторов для тех же задач.

Коротко о README

README описывает скилл как первый open source инструмент для Яндекс Директа под AI-агентов, сделанный для OpenClaw и совместимых с Claude Code. Перечислены восемь команд, структура аудита из 55 проверок по шести категориям с весами, бенчмарки рынка по CTR, CPC и CVR и шаги установки: заявка на API, получение OAuth-токена, сохранение credentials и копирование папки скилла. Авторы рассказывают, что сделали скилл за вечер для настройки своих кампаний и прогнали аудит на собственном аккаунте. Лицензия MIT.

Бейдж для README

Исходный SKILL.md

---
name: direct
description: >
  Yandex Direct (API v5) advertising audit, management, and optimization.
  Full account audits, campaign management, keyword operations, reporting,
  budget analysis, and optimization recommendations for Russian market PPC.
  Triggers on: "Яндекс Директ", "Yandex Direct", "директ", "РСЯ", "YAN",
  "direct audit", "direct campaigns", "direct report", "direct optimize".
argument-hint: "audit | campaigns | create | keywords | report | optimize | budget | negative"
allowed-tools:
  - Read
  - Grep
  - Glob
  - Bash
  - WebFetch
---

# Yandex Direct — PPC Audit & Management (API v5)

Full-cycle Yandex Direct management: account audits, campaign CRUD, keyword
management, reporting, optimization, and budget analysis.

## Quick Reference

| Command | What it does |
|---------|-------------|
| /direct audit | Full account audit (all campaigns), scoring 0-100 |
| /direct campaigns | List campaigns with statuses and key metrics |
| /direct create | Create campaign (Search/YAN) with ad groups, keywords, ads |
| /direct keywords | Keyword management (list, add, update bids, pause) |
| /direct report | Performance stats (CTR, CPC, conversions, spend) |
| /direct optimize | Optimization recommendations (pause losers, adjust bids) |
| /direct budget | Budget spend analysis and forecasting |
| /direct negative | Negative keyword management (campaign & shared sets) |

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