landing-ads - SKILL.md Agent Skill

name: landing-ads description: Подготовить рекламные материалы для лендинга — UTM-разметку, тексты объявлений, ключевые фразы и минус-слова под Яндекс.Директ и Google Ads, с экспортом для Директ.Коммандера / Google Ads Editor. Использовать, когда нужно завести рекламную кампанию на лендинг или вариант A/B. Генерирует артефакты (без трат и без живых API); запуск кампаний — решение человека.

landing-ads — рекламные материалы для лендинга

Готовит всё, что нужно загрузить в рекламные кабинеты на лендинг (или вариант A/B): UTM-ссылки, тексты объявлений в рамках форматов, ключевые фразы и минус-слова, экспорт-файлы. Артефакты, не запуск. Токенов на API сейчас нет (ADR-0007), поэтому skill не создаёт кампании и ничего не тратит — только собирает материалы и инструкции.

Жёсткие правила

Деньги — решение человека. Skill НЕ запускает кампании и НЕ тратит бюджет. Он отдаёт материалы + инструкцию по загрузке. Запуск, ставки и бюджет выставляет человек.
Правдивость (правила копирайта проекта). Объявления не обещают того, чего нет: без выдуманных цифр, гарантий, «№1», несуществующих акций. Источник фактов — бриф (в будущем — RAG по базе знаний).
UTM консистентны с аналитикой. Разметка должна сходиться с целями Метрики/GA4 и метками A/B-варианта, иначе статистику по каналам/вариантам не свести (см. landing-experiment).
Трафик-гейт. Лить платный трафик имеет смысл, когда лендинг готов к замерам (аналитика подключена). Предупреди, если запускают рекламу на неготовую к конверсии страницу.

Workflow

1. Вход

Бриф (оффер, аудитория, SEO-тема, ограничения) — формат в .claude/skills/new-landing/reference/brief-schema.md.
URL лендинга (прод) и, если это A/B, — id эксперимента и список вариантов.
Каналы: Яндекс.Директ и/или Google Ads.

2. UTM-разметка

python3 .claude/skills/landing-ads/scripts/build_utm.py \
  --url https://example.com/ --campaign <slug> [--channels yandex,google] [--variants A,B]

Схема и соглашения — reference/utm-scheme.md. Выдаёт таблицу ссылок (канал × вариант) и CSV в ads/<campaign>/utm.csv.

3. Тексты объявлений

Сгенерируй по reference/ad-formats.md (лимиты символов и количество для каждого канала; правила копирайта). Под каждый канал, при A/B — под каждый вариант (с соответствующим utm_content). Сохрани в ads/<campaign>/ads.<channel>.json.

4. Ключевые фразы и минус-слова

Из брифа и SEO-исследования (ключевые фразы). Сгруппируй по интенту, добавь минус-слова. Сохрани в ads/<campaign>/keywords.<channel>.txt.

5. Экспорт и проверка

Собери экспорт-файлы для Директ.Коммандера / Google Ads Editor (колонки — в ad-formats.md).

Проверь лимиты:

python3 .claude/skills/landing-ads/scripts/check_ads.py ads/<campaign>/ads.<channel>.json --channel <yandex|google>

6. Инструкция + журнал

Приложи короткую инструкцию: как импортировать в кабинет, как связать цели Метрики/конверсии Google с кампанией, какие UTM смотреть в отчётах, гейт трафик-гейт.

Залогируй:

python3 .claude/skills/landing-journal/scripts/log_event.py \
  --event changed --landing <slug> --summary "Подготовлены рекламные материалы: <campaign>" \
  --details "каналы=<...>; варианты=<...>"

Будущее (при появлении токенов — отдельный ADR)

Автозагрузка кампаний через API Яндекс.Директ / Google Ads и автосбор расхода/конверсий. Тогда — строго с подтверждением трат человеком и лимитами бюджета. Сейчас — заглушка: материалы готовятся здесь, загрузка ручная.