Funnel-creatives cheatsheet

Performante in-funnel ad-creative generator · branch feat/funnel-creatives · 18 commits

Что это

По IG-handle юзера автоматически создаёт 3 рекламных креатива 1080×1350 за ~30s. 6 niche bundles, 3 DR-preset композиции, full A/B/C set.

@handle → HikerAPI → Gemini Flash classifier →
niche.yaml bundle → assembler picks 3 hooks +
3 presets → Vertex Nano Banana × 3 → 3 PNG

Cost & speed

Step	Cost	Time
HikerAPI fetch (analyze)	~$0.001	1-3s
Gemini Flash classify	~$0.0001	~1s
Vertex Nano Banana × 3	$0.135	~25-30s
TOTAL per visit	~$0.137	~30s

Где код

~/agents-monorepo-funnel/services/creative-generation-service/src/funnel/

analyzer/    — IG → niche + palette
templates/   — 6 YAML niche bundles + loader
slots/       — assembler (bundle → 3 SlotSpec)
render/      — Vertex client + fallback + cost
qa/          — text_overlay (disabled)
state/       — in-memory sessions + jobs + worker
routes/      — 4 HTTP endpoints

Endpoints

Method	Path
POST	/api/funnel/analyze-insta
POST	/api/funnel/draft-creatives
GET	/api/funnel/job/:id
GET	/api/funnel/health

Test commands

cd ~/agents-monorepo-funnel/services/\
creative-generation-service

# Vertex sanity
npx ts-node scripts/verify-vertex.ts

# HikerAPI sanity
npx ts-node scripts/verify-hiker.ts instagram

# Full A/B/C set (real ICP)
npx ts-node scripts/smoke-e2e.ts ambassador_stom --all

State

Phase	Status
Foundation (1-6)	✓
Render Engine (7-12)	✓ LIVE
IG Analyzer (24-29)	✓ LIVE
Niche YAML + assembler (14-23)	✓ LIVE
HTTP API + worker (30-35)	✓ (in-memory)
Text overlay (12.5)	disabled
Higgsfield fallback (8)	stub
QA + Eval (36-42)	не сделано
Supabase swap (prod)	migration ready

ICP — handles для теста

Только local SMB РФ/КЗ (1k-50k followers). НЕ Nike/McDonald's.

Niche	Tested
medical	@ambassador_stom · @alaclinic.kz · @ideal.stom
beauty	TODO local salon
fitness	TODO local studio
ecom	TODO handmade brand
restaurant	TODO local cafe

Документы

Spec: ~/ai-system/projects/ai-targetolog/specs/04-funnel-creatives-design.md
Plan: ~/agents-monorepo-funnel/docs/plans/2026-05-29-funnel-creatives.md
README: ~/agents-monorepo-funnel/services/creative-generation-service/src/funnel/README.md
Memory: feedback-performante-ica-real-smb-not-global-brands · idea-svg-structure-reference

Production checklist (партнёру)

Apply migration 001_funnel_tables.sql
Swap in-memory stores → Supabase
Implement Higgsfield fallback client
Add unit tests per module
Set prod env (Vertex ADC + Hiker paid + Supabase)
Hook static serve → Supabase Storage
Wire frontend Section 3 на endpoints

Демо

Real ICP gallery @ambassador_stom →

3 креатива: "Имплант за 1 визит" · "Брекеты от 30 000 ₸" · "Первый осмотр бесплатно"

classified medical · medical.yaml palette #0D5C8E · 30s · $0.135

Funnel-creatives · prototype cheatsheet