Скилл Яндекс Директа для Claude Code
Yandex Direct Skill for Claude Code
Claude Code скилл для API v5 Яндекс Директа: кампании, объявления, ключевые фразы, ставки, отчеты и справочники через bash-скрипты
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Скрипты приостанавливают и возобновляют показ кампаний, объявлений и ключевых фраз
- Отправляет объявления на модерацию, после которой начинаются реальные показы
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/yandex-direct-skill-for-claude-codeОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Выполните в терминале в папке проекта
npx skills add elsvv/yandex-direct-skill --skill yandex-direct -a claude-code -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Выполните в терминале в папке проекта
npx skills add elsvv/yandex-direct-skill --skill yandex-direct -a cursor -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Выполните в терминале в папке проекта
npx skills add elsvv/yandex-direct-skill --skill yandex-direct -a github-copilot -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Выполните в терминале в папке проекта
npx skills add elsvv/yandex-direct-skill --skill yandex-direct -a codex -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Выполните в терминале в папке проекта
npx skills add elsvv/yandex-direct-skill --skill yandex-direct -a gemini-cli -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Выполните в терминале в папке проекта
npx skills add elsvv/yandex-direct-skill --skill yandex-direct -a cline -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Выполните в терминале в папке проекта
npx skills add elsvv/yandex-direct-skill --skill yandex-direct -a roo -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Форк Roo Code, папки .roo те же.
Выполните в терминале в папке проекта
npx skills add elsvv/yandex-direct-skill --skill yandex-direct -a opencode -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Установи скилл: claude skill install elsvv/yandex-direct-skill, зарегистрируй OAuth-приложение с правом direct:api на oauth.yandex.ru/client/new, получи токен командой bash ~/.claude/skills/yandex-direct/scripts/get_token.sh --client-id ВАШ_ID и проверь подключение check_connection.sh.
Другие способы из описания автора
claude skill install elsvv/yandex-direct-skillУстанавливает скилл через встроенную команду Claude Code.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Скилл дает Claude Code набор bash-скриптов поверх API v5 Яндекс Директа: проверка токена, список и управление кампаниями с приостановкой, возобновлением и архивацией, то же самое для объявлений плюс отправка на модерацию, приостановка и возобновление ключевых фраз, выгрузка асинхронных TSV-отчетов и запрос справочников вроде регионов и валют. SKILL.md отдельно фиксирует полную схему API v5: базовые URL для прода и песочницы, формат запросов и ошибок, систему единиц (Units) и типичные коды ошибок, так что модель может собирать и прямые вызовы к сервисам, которых нет в готовых скриптах.
Для кого. Для тех, кто ведет рекламу в Яндекс Директе и хочет получать отчеты и управлять статусами кампаний из Claude Code без переключения в кабинет.
Подходит, если
- Нужно поставить кампанию на паузу или снова включить прямо из чата
- Нужен отчет по поисковым запросам или расходу за произвольный период
- Нужно собрать нестандартный запрос к сервису API v5, которого нет в готовых скриптах
Не подходит, если
- Нужно создавать новые кампании, объявления или ключевые слова: готовых скриптов на это нет
- Нужен графический интерфейс или подтверждение каждого шага клиентом: скрипты выполняются напрямую
- Нужен другой агент, кроме Claude Code: скилл заточен под его формат
Пример запроса к агенту
Покажи активные кампании и построй отчет по расходу за последние 7 дней с разбивкой по кампаниямОграничения
Готовые скрипты умеют только чтение, приостановку, возобновление, архивацию и модерацию, но не создание объектов: для остального нужно собирать запрос вручную по справке из SKILL.md. Токен получают отдельным OAuth-приложением с правом direct:api. Скрипты нужно запускать через bash с абсолютными путями, из zsh напрямую source не работает.
Как отключить. Удалите каталог ~/.claude/skills/yandex-direct или выполните обратную команду удаления скилла, если она поддерживается вашей версией Claude Code.
Проверка безопасности
- Скрипты приостанавливают и возобновляют показ кампаний, объявлений и ключевых фраз
- Отправляет объявления на модерацию, после которой начинаются реальные показы
Коротко о README
README дает команду установки скилла, шаги регистрации OAuth-приложения и получения токена и таблицу из шести готовых скриптов с назначением каждого, плюс примеры вызовов для статистики кампаний, отчетов и справочников. SKILL.md добавляет полную справку по API v5: заголовки авторизации, структуру запроса и ответа, систему единиц Units и таблицу типичных кодов ошибок.
SKILL.md
---
name: yandex-direct
description: |
Manage Yandex Direct campaigns, ads, keywords, bids, reports via API v5.
Use when the user needs to work with Yandex Direct API — campaign management,
ad groups, ads, keywords, bids, targeting, reports, statistics, dictionaries,
or any other Yandex Direct API operation.
Triggers: Yandex Direct, Direct API, campaigns API, ad management API,
keyword bids, Yandex advertising API, Direct reports, Direct statistics.
---
# Yandex Direct API v5
## Essentials
### Base URLs
| Environment | JSON Endpoint | SOAP Endpoint |
|-------------|--------------|---------------|
| **Production** | `https://api.direct.yandex.com/json/v5/{service}` | `https://api.direct.yandex.com/v5/{service}` |
| **Sandbox** | `https://api-sandbox.direct.yandex.com/json/v5/{service}` | `https://api-sandbox.direct.yandex.com/v5/{service}` |
### Authentication
All requests require an OAuth token in the `Authorization` header.Частые вопросы
Можно ли создавать новые кампании?
Готовых скриптов для этого нет, но SKILL.md описывает полную схему запросов add, и модель может собрать такой вызов вручную через функции common.sh.
Есть ли доступ к песочнице?
Да, переменная YANDEX_DIRECT_SANDBOX=true переключает базовый URL на api-sandbox.direct.yandex.com.
Похожие
Скилл, который убирает из текста приметы ИИ-письма по списку Википедии и не добавляет выдуманных фактов
Marketing Skills: маркетинговые скиллы для агентов
Marketing Skills for AI Agents
Около пятидесяти скиллов по CRO, копирайтингу, SEO, аналитике, рекламе и запуску продукта для кодовых агентов
MCP-сервер SendPulse
SendPulse MCP
Официальный удаленный MCP-сервер SendPulse: статистика, рассылки и данные пользователей через чат с агентом
MCP Яндекс Директа из машиночитаемой схемы
yandex-direct-mcp
MCP-сервер и CLI на всех 113 методах API v5 Яндекс Директа, собранных из WSDL: по умолчанию только 9 читающих, запись включается явно