AB-Directolog-Skill — AB-Directo记录-技能
v5Эксперт по Яндекс.Директ: управляет кампаниями через API, получает данные, строит отчёты, анализирует эффективность и предлагает оптимизацию ставок.
by 运行时依赖
安装命令
点击复制技能文档
Яндекс.Директ агент — 技能.md Назначение
Этот скилл превращает OpenClaw-агента в эксперта по Яндекс.Директу. Агент умеет:
Работать с Direct API v5 через OAuth Получать данные по кампаниям, ключевым словам, объявлениям Запрашивать отчёты Анализировать эффективность рекламы Предлагать оптимизацию Подключение API
- Регистрация приложения
- Получение токенов
Токен получаем через OAuth:
https://oauth.yandex.com/授权? 响应_type=code& 命令行工具ent_id=<命令行工具ENT_ID>& redirect_uri=& scope=direct:API
После авторизации код обменивается на токен:
curl -X POST https://oauth.yandex.com/令牌 \
-d "grant_type=authorization_code" \
-d "code=" \
-d "命令行工具ent_id=<命令行工具ENT_ID>" \
-d "命令行工具ent_secret=<命令行工具ENT_SECRET>" \
-d "redirect_uri="
Ответ:
{
"访问_令牌": "AQAAA...",
"令牌_type": "bearer",
"expires_in": 86400
}
Важно: токен живёт 24 часа. Для refresh используй grant_type=refresh_令牌.
Переменные окружения
Добавь в .env агента:
YANDEX_DIRECT_命令行工具ENT_ID=your_命令行工具ent_id
YANDEX_DIRECT_命令行工具ENT_SECRET=your_命令行工具ent_secret
YANDEX_DIRECT_访问_令牌=your_访问_令牌
YANDEX_DIRECT_REFRESH_令牌=your_refresh_令牌
Тест подключения
curl -X POST "https://API.direct.yandex.com/json/v5/campAIgns" \
-H "Authorization: Bearer <令牌>" \
-H "Content-Type: 应用/json" \
-d '{
"method": "获取",
"params": {
"SelectionCriteria": {},
"FieldNames": ["Id", "Name", "状态"]
}
}'Структура памяти агента
Агент хранит контекст в memory/direct-memory.md:
memory/
├── direct-memory.md # Текущее состояние аккаунта
├── campAIgns/ # Данные по кампаниям
├── 报告s/ # Отчёты и аналитика
└── templates/ # Шаблоны объявлений
Пример memory/direct-memory.md
# Yandex.Direct Memory
Аккаунт
- 命令行工具ent ID: xxx
- Refresh 令牌: xxx (зашифрован)
- Последнее обновление: 2026-05-06
Кампании (последние 5)
ID Имя Статус Бюджет xxx Кампания 1 运行ning 500₽/день
Метрики (сегодня)
- Клики: 142
- Показы: 4820
- CTR: 2.95%
- Расход: 890₽
- Конверсии: 12
- CPA: 74₽
Последние действия
- 2026-05-06: Создана кампания "Летняя распродажа"
- 2026-05-05: Оптимизированы ставки для группы "Кроссовки"
Ключевые 端点s API
Кампании
POST https://API.direct.yandex.com/json/v5/campAIgns
{
"method": "获取",
"params": {
"SelectionCriteria": {
"状态es": ["运行ning"]
},
"FieldNames": ["Id", "Name", "状态", "DAIlyBud获取", "AvgCpc", "Impressions", "命令行工具cks"]
}
}
Объявления
POST https://API.direct.yandex.com/json/v5/ads
{
"method": "获取",
"params": {
"SelectionCriteria": {
"CampAIgnIds": [123456]
},
"FieldNames": ["Id", "CampAIgnId", "状态", "AdCategories"]
}
}
Ключевые слова
POST https://API.direct.yandex.com/json/v5/keywords
{
"method": "获取",
"params": {
"SelectionCriteria": {
"CampAIgnIds": [123456]
},
"FieldNames": ["Id", "Keyword", "Bid", "Competition", "Lowctrbid"]
}
}
Отчёты
POST https://API.direct.yandex.com/json/v5/报告s
{
"method": "获取",
"params": {
"SelectionCriteria": {
"DateFrom": "2026-05-01",
"DateTo": "2026-05-06"
},
"FieldNames": ["CampAIgnName", "命令行工具cks", "Impressions", "Cost", "ConversionRate"]
}
}
Сценарии использования
- Аудит кампании
Проверь кампанию "Летняя распродажа" — какие объявления показываются,
какие ключевые слова работают, где сливается бюджет.
Агент:
Запрашивает данные по кампании
Анализирует CTR по объявлениям
Находит неэффективные ключевые слова
Формирует отчёт с рекомендациями
- Оптимизация ставок
Понизь ставки на ключевые слова с CTR ниже 1% на 20%.
Агент:
Получает список keywords с CTR
Фильтрует низкоэффективные
Рассчитывает новые ставки
Отправляет batch-изменения через API
- Генерация отчёта
Сделай отчёт по всем кампаниям за последние 30 дней:
конверсии, расход, ROI.
Агент:
Запрашивает данные через 报告s API
Обрабатывает и агрегирует данные
Формирует таблицу и выводы
Обработка ошибок API
Код Значение Действие
1000 Достигнут дневной лимит Подождать до следующего дня
1001 Нет доступа к кампании Проверить права токена
1002 Кампания не найдена Уточнить ID кампании
1003 Недостаточно средств Показать предупреждение
1004 Токен истёк Обновить через refresh_令牌
8001 Превышен лимит запросов Добавить задержку 1 сек
При ошибке 1004 агент автоматически обновляет токен и повторяет запрос.
Формулы для анализа
CTR = (Клики / Показы) × 100
CPC = Расход / Клики
CPA = Расход / Конверсии
ROI = ((Доход - Расход) / Расход) × 100
Best practices
Всегда обновляй токен — токен живёт 24 часа, refresh_令牌 — 1 год
Используй batch-запросы — группируй изменения, не отправляй