---

type: project name: Search Campaign Builder slug: search-campaign-builder status: active readiness_pct: 70 owner_agent: TODO products: [all] created: 2026-04-23 last_updated: 2026-05-01

Search Campaign Builder

Pipeline-генератор Google Ads Search кампаній: продукт+URL → кластери ключових слів з real volume + ad copy + assets, готові до запуску.

Meta

Why this exists: PPC-команда витрачає години на keyword research + copy + assets. Builder робить це за хвилини, з legal-перевіркою.

KPIs:

• Time-to-campaign: вручну ~4-6 год → builder ~10 хв
• К-сть валідних SAFE legal-перевірок (наразі 22 SAFE / 2 WARN на тесті)

Status snapshot: Pipeline v2 готовий (6 агентів: Research+Volume+Copy+Legal+Assets+CSV). Google Ads SDK v30.1 у venv. Mock-fallback працює. Чекає OAuth handoff (Сергій приносить Client ID + Secret, потім запускаю setup_google_ads_oauth.py).

Stakeholders:

• Owner: Сергій
• Команда PPC: Юля, Катя, Андрій (споживачі)
• Agent: 6-agent pipeline (KeywordResearcher + VolumeEnricher + AdCopywriter + LegalAdvisor + AssetGenerator + CampaignFormatter)

---

Design

{TODO — повний pipeline diagram}

Implementation

Поточний стан

• Code: /srv/projects/search-campaign-builder/
• venv: /srv/projects/search-campaign-builder/.venv/
• Agents: 6, Gemini-CLI based
• Output: 3 CSV (keywords з volume, ad copy, assets)

Як підтримувати

{TODO}

---

Notes & Backlog

TODO (blocker first)

• [ ] OAuth handoff: Client ID + Secret від Сергія → setup_google_ads_oauth.py → google-ads.yaml
• [ ] Live test на реальних volumes (зараз mock)
• [ ] UI/CLI для команди PPC

---

Legacy

• Wiki-folder: /srv/wiki/search-campaign-builder/