Яндекс Директ через API: промт и плейбук

Ты эксперт по Яндекс Директ API v5 и Яндекс Метрике.
Создай полный комплект Python-скриптов для запуска рекламы с нуля.
Скрипты должны работать на Python stdlib (только urllib, json, csv — без pip).
Токены читаются из файла .env в корне проекта.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
ТВОИ ДАННЫЕ (заменить на реальные)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

YANDEX_DIRECT_TOKEN=   # OAuth-токен (как получить — см. раздел ниже)
YANDEX_DIRECT_LOGIN=   # логин рекламного аккаунта

БИЗНЕС:
  Название:            [например: Школа кайтсёрфинга]
  Продукт/услуга:      [например: обучение кайтсёрфингу, курсы от 27 000 руб]
  Посадочная страница: [например: https://mysite.ru/]
  Регион бизнеса:      [например: Анапа, Краснодарский край]

МЕТРИКА:
  Счётчик ID:          [ID счётчика Метрики]
  Цель «Заявка» ID:    [ID цели — создать в Метрике если нет]
  Ценность заявки:     [например: 500 руб]

ДИРЕКТ:
  Sitelink Set ID:     [ID набора быстрых ссылок — создать в UI или пропустить]
  Video Creative ID:   [ID видеодополнения — пропустить если нет]
  CPA цель:            [сколько готов платить за заявку, например 700 руб]
  Недельный бюджет РСЯ: [например: 7000 руб]
  Потолок ставки РСЯ:  [например: 150 руб/клик]

ГЕО (ID регионов, найти на tech.yandex.ru/regions):
  Поиск холодный:      [например: 213,1,2,10174,35,37,38,39]
  РСЯ:                 [те же или шире]
  Конкуренты из других городов: [например: 213,1,11]

АУДИТОРИЯ КОНКУРЕНТОВ (боль и крючок):
  Боль клиента:        [например: катается на озере, прогресс медленный]
  Наше преимущество:   [например: на море ветер стабильнее, результат за 3 дня]

МИНУС-СЛОВА:
  Чужие темы:          [например: серфинг, вейкборд, виндсёрфинг, яхта]
  Чужое гео:           [если работаешь локально — чужие города]
  Коммерческий мусор:  [купить, цена, продам, бу, бесплатно, аренда]
  Инфо-мусор:          [видео, скачать, форум, отзыв, вики, что такое]

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
ЧТО СОЗДАТЬ (6 скриптов)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

1. setup_campaigns.py — 4 кампании:
   • search         — Поиск, холодный трафик, AVERAGE_CPA
   • search_rt      — Поиск, ретаргет, AVERAGE_CPA (CPA × 0.8)
   • rsya_rt        — РСЯ ретаргет, WB_MAXIMUM_CONVERSION_RATE
   • rsya_konkurenti— РСЯ конкуренты, WB_MAXIMUM_CONVERSION_RATE
   Все кампании: ADD_METRICA_TAG=YES, AttributionModel=AUTO, статус SUSPENDED

2. setup_groups.py — группы объявлений:
   • Поиск: автотаргетинг ТОЛЬКО COMPETITOR=YES (остальные NO)
   • РСЯ ретаргет: группа «Ретаргетинг»
   • РСЯ конкуренты: группа «Интересы и привычки» (URL добавить вручную в UI!)
   API-нюанс: AutotargetingCategories = массив [...], НЕ {"Items": [...]}

3. setup_ads.py — по 5 объявлений на кампанию:
   Title ≤56 / Title2 ≤30 / Text ≤81 символов
   Для конкурентов: сравнение «твой способ vs наш», скорость результата
   Для ретаргета: FOMO («были у нас — осталось N мест»)

4. setup_retargeting.py — ретаргет-инфраструктура:
   POST /json/v5/retargetinglists — правила Rules.Arguments[].ExternalId
   POST /json/v5/audiencetargets  — ставка ContextBid ≥ 20 000 000 (= 20 руб)
   (При 300 000 = 0.30 руб алгоритм не покупает показы!)

5. report_search_queries.py — раз в 3 дня:
   SEARCH_QUERY_PERFORMANCE_REPORT → разделить на мусор / нормальные
   Отправить в Telegram через Bot API

6. diag_campaigns.py — диагностика:
   Проверить статусы, стратегии, GoalId, audience targets, ADD_METRICA_TAG

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
КРИТИЧЕСКИЕ ПРИНЦИПЫ
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

1. Метрика загружается БЕЗ ожидания cookie-согласия
2. Цель стратегии = Заявка (НЕ «просмотр страницы», НЕ «переход в мессенджер»)
3. На старте — WB_MAXIMUM_CONVERSION_RATE (PAY_FOR_CONVERSION требует 10+ конв/неделю)
4. Автотаргетинг — только COMPETITOR (Узкие запросы)
5. Ставки audiencetargets — минимум 20 руб
6. «Интересы и привычки» — только в UI, через API недоступно
7. ADD_METRICA_TAG = YES во всех кампаниях
8. Мусорные площадки РСЯ — чистить раз в месяц через UI
9. Поисковые запросы — аудит раз в 3 дня, добавлять в минус-слова

YANDEX_DIRECT_TOKEN=y0_AgAAAA...
YANDEX_DIRECT_LOGIN=твой_логин
TELEGRAM_BOT_TOKEN=...    # для отчётов
TELEGRAM_CHAT_ID=...      # твой chat_id

# Все скрипты читают .env одинаково:
for line in Path('.env').read_text(encoding='utf-8').splitlines():
    if not line.strip() or line.startswith('#') or '=' not in line: continue
    k, v = line.split('=', 1)
    os.environ.setdefault(k.strip(), v.strip().strip('"').strip("'"))

# Правильно — при UPDATE передавать как массив []:
"AutotargetingCategories": [
    {"Category": "EXACT",       "Value": "NO"},
    {"Category": "COMPETITOR",  "Value": "YES"},
    {"Category": "BROADER",     "Value": "NO"},
    {"Category": "ACCESSORY",   "Value": "NO"},
    {"Category": "ALTERNATIVE", "Value": "NO"},
]
# НЕ как объект {"Items": [...]} — это формат ответа GET, не запроса UPDATE

{
  "method": "add",
  "params": {
    "RetargetingLists": [{
      "Name": "Был на сайте",
      "Rules": [{
        "Arguments": [{           // НЕ Goals, НЕ MetrikaGoals
          "ExternalId": 330452088, // НЕ MetrikaGoalId
          "Operator": "ANY"        // НЕ Type, НЕ OR
        }],
        "MembershipLifeSpan": 540  // НЕ Time, НЕ Days
      }]
    }]
  }
}

{
  "method": "add",
  "params": {
    "AudienceTargets": [{
      "AdGroupId": GROUP_ID,
      "RetargetingListId": LIST_ID,
      "ContextBid": 20000000   // 20 руб (МИНИМУМ)
                                   // При 300 000 = 0.30 руб → 0 показов
    }]
  }
}

# Ежедневная статистика в 09:00 МСК (06:00 UTC)
0 6 * * *   root  python3 /usr/local/bin/yd_daily_stats.py >> /var/log/yd_stats/$(date +\%Y-\%m-\%d).log 2>&1

# Аудит поисковых запросов каждые 3 дня в 09:00 МСК
0 6 */3 * * root  python3 /usr/local/bin/yd_search_queries.py >> /var/log/yd_queries/$(date +\%Y-\%m-\%d).log 2>&1

H = {
    "Authorization":   f"Bearer {TOKEN}",
    "Client-Login":    LOGIN,
    "Accept-Language": "ru",
    "Content-Type":    "application/json; charset=utf-8",
}
H_REPORT = {
    **H,
    "processingMode":      "auto",
    "skipReportHeader":    "true",
    "skipColumnHeader":    "false",
    "skipReportSummary":   "true",
    "returnMoneyInMicros": "false",
}