The first open-source skill for managing Yandex Direct via AI agents.

Audit, create, optimize, and report on Yandex Direct campaigns — all through natural language commands. Built for OpenClaw and compatible AI agent frameworks.

Authors: Nick Serebrov & Kobe 🐍

55 checks across 6 categories:

• Conversions & Metrika (25%) — tracking setup, goals, attribution
• Wasted Spend / Negatives (20%) — negative keywords, search query analysis
• Account Structure (15%) — campaign organization, naming, geo split
• Keywords & Quality (15%) — match types, quality score, relevance
• Ads & Extensions (15%) — moderation, sitelinks, callouts, images
• Settings & Targeting (10%) — geo, bidding strategy, bid modifiers

Scoring: weighted algorithm → 0-100 score → grade A through F.

├── SKILL.md                          # Main skill file (agent instructions)
├── references/
│   ├── yandex-audit.md               # 55 audit checks (YD01-YD55)
│   ├── scoring-system.md             # Weighted scoring algorithm
│   ├── benchmarks.md                 # Russian market benchmarks (CTR, CPC, CVR)
│   ├── bidding-strategies.md         # Bidding strategy decision tree
│   ├── compliance.md                 # FZ-38, ad moderation rules
│   └── image-specs.md               # Image sizes for YAN (RSY) ads
├── scripts/
│   ├── yd-api.sh                     # Generic API v5 wrapper
│   ├── yd-report.sh                  # Reports service wrapper
│   └── yd-audit.sh                   # Automated audit data collection
└── agents/
    └── audit-yandex.md               # Audit subagent instructions

Apply for Yandex Direct API access at direct.yandex.ru → API settings.

https://oauth.yandex.ru/authorize?response_type=token&client_id=YOUR_CLIENT_ID

cat > ~/.secrets/yandex-direct.json << 'EOF'
{
  "client_id": "your_client_id",
  "client_secret": "your_client_secret",
  "oauth_token": "your_oauth_token"
}
EOF
chmod 600 ~/.secrets/yandex-direct.json

Copy the yandex-direct folder to your agent's skills directory:

# OpenClaw
cp -r yandex-direct ~/clawd/skills/

# Claude Code
cp -r yandex-direct ~/.claude/skills/

Tell your agent: "Run a Yandex Direct audit" — and watch the magic happen.

Built-in benchmarks for the Russian PPC market:

Benchmarks vary by industry — see references/benchmarks.md for full data.

This skill was born in one evening. We needed to set up Yandex Direct campaigns for stepback.ru. After creating campaigns via API in 3 minutes, we found claude-ads — a great skill for Google/Meta/LinkedIn ads, but with zero Yandex support. So we built our own, ran an audit on our account (Grade D → C+), and fixed the issues on the spot.

MIT — use it, fork it, improve it.

Первый open-source скилл для управления Яндекс Директом через AI-агентов.

Аудит, создание, оптимизация и отчёты по кампаниям Яндекс Директа — всё через команды на естественном языке. Создан для OpenClaw и совместимых AI-агентных фреймворков.

Авторы: Ник Серебров & Коби 🐍

55 проверок по 6 категориям:

• Конверсии и Метрика (25%) — настройка целей, атрибуция, трекинг
• Слив бюджета / минус-слова (20%) — минус-слова, анализ поисковых запросов
• Структура аккаунта (15%) — организация кампаний, именование, гео
• Ключевые слова и качество (15%) — типы соответствия, показатель качества
• Объявления и расширения (15%) — модерация, быстрые ссылки, уточнения, изображения
• Настройки и таргетинг (10%) — гео, стратегии ставок, корректировки

Оценка: взвешенный алгоритм → балл 0-100 → грейд от A до F.

Подайте заявку на доступ к API Яндекс Директа: direct.yandex.ru → Настройки API.

https://oauth.yandex.ru/authorize?response_type=token&client_id=ВАШ_CLIENT_ID

cat > ~/.secrets/yandex-direct.json << 'EOF'
{
  "client_id": "ваш_client_id",
  "client_secret": "ваш_client_secret",
  "oauth_token": "ваш_oauth_token"
}
EOF
chmod 600 ~/.secrets/yandex-direct.json

Скопируйте папку yandex-direct в директорию скиллов вашего агента:

# OpenClaw
cp -r yandex-direct ~/clawd/skills/

# Claude Code
cp -r yandex-direct ~/.claude/skills/

Скажите агенту: «Проведи аудит Яндекс Директа» — и наблюдайте.

Этот скилл родился за один вечер. Нам нужно было настроить кампании в Яндекс Директе для stepback.ru. После создания кампаний через API за 3 минуты мы нашли claude-ads — отличный скилл для Google/Meta/LinkedIn, но без поддержки Яндекса. Поэтому мы создали свой, прогнали аудит на своём аккаунте (Грейд D → C+) и исправили проблемы на месте.

MIT — используйте, форкайте, улучшайте.