--- name: ad-ready description: Generate professional advertising images from product URLs using the Ad-Ready pipeline on ComfyDeploy. Use when the user wants to create ads for any product by providing a URL, optionally with a brand profile (70+ brands) and funnel stage targeting. Supports model/talent integration, brand-aware creative direction, and multi-format output. Differs from Morpheus (manual fashion photography) — Ad-Ready is URL-driven, brand-intelligent, and funnel-stage aware. ---

Ad-Ready: AI Advertising Image Generator

Generate professional advertising images from product URLs using a 4-phase AI pipeline on ComfyDeploy.

Source: github.com/PauldeLavallaz/ads_SV

---

Pipeline Architecture

The pipeline runs as a ComfyUI custom node deployed on ComfyDeploy. A single ProductToAds_Manual node executes 4 phases internally:

┌─────────────────────────────────────────────────────────────┐
│                  ProductToAds_Manual Node                     │
│                                                             │
│  PHASE 1: Product Scraping (Gemini Flash)                   │
│  ─────────────────────────────────────────                   │
│  Scrapes product URL → extracts title, description,         │
│  features, price, materials, image URLs                      │
│  Also scrapes HTML for high-res product images (≥1000px)    │
│                                                             │
│  PHASE 2: Campaign Brief Generation (Gemini Flash)          │
│  ────────────────────────────────────────────────            │
│  Brand Identity + Product Data + References →                │
│  10-point Campaign Brief (creative direction)                │
│                                                             │
│  PHASE 3: Blueprint Generation (Gemini Flash)               │
│  ──────────────────────────────────────────────              │
│  Master Prompt (funnel stage) + Brief + Keywords →           │
│  Production-Ready JSON Blueprint                             │
│                                                             │
│  PHASE 4: Image Generation (Nano Banana Pro / Imagen 3)     │
│  ──────────────────────────────────────────────────          │
│  Blueprint + all reference images → final ad image           │
│                                                             │
└─────────────────────────────────────────────────────────────┘

Phase 2: Campaign Brief (The Creative Brain)

The Brief Generator is the most critical intermediate step. It acts as a "Senior Art Director" that translates raw data into actionable creative direction using a 10-point framework:

1. Strategic Objective — Why this campaign exists (awareness/positioning/launch)
2. Central Message — One idea perceivable without text
3. Visual Tone of Voice — Register: calm/energetic/intimate/monumental
4. Product Role — Hero vs co-protagonist vs implicit presence
5. Visual Language & Brand Coherence — Non-negotiable brand codes
6. Photographer & Equipment — Photography as concept, not execution
7. Extended Art Direction — Styling, casting, poses, hair/makeup, layout
8. Environment & Context — Where and why (conceptual, never decorative)
9. Texture, Material & Product Render — How surfaces are perceived
10. Final Image Signature — Finish, grain, temporal positioning

Without the brief, the Master Prompt must guess creative strategy. With it, the Master Prompt only executes.

The brief prompt template is included at {baseDir}/configs/Brief_Generator/brief_prompt.json.

Phase 3: Master Prompts (8 Funnel Stages)

Each funnel stage has a specialized Master Prompt that generates a production-ready JSON Blueprint. All share the same internal simulation:

• ROUND -1: Brand Identity Forensics (stages 03+) — Unified Brand Style Manifest
• ROUND 0: Fidelity Lock — Product geometry & talent identity are IMMUTABLE
• ROUND 1: Stage Strategy — Strategic approach specific to funnel position
• ROUND 2: Graphic Design — UI, typography, CTA engineering

The Blueprint JSON covers: scene production, talent lock, camera perspective, subject action/pose/wardrobe, lighting, product constraints, layout architecture, typography, CTA engineering, and brand asset placement.

Master prompt files are included at {baseDir}/configs/Product_to_Ads/.

Reference Analyzer

Reference images (referencia) are optional and off by default. The pipeline generates creative direction internally from Brand Identity + Campaign Brief. Only use a reference when the user explicitly asks to clone a specific ad's style.

When used, the reference is analyzed for pose, photographic style, and location cues.

---

⚠️ CRITICAL: Required Inputs Checklist

Before running ANY ad generation, ensure these are provided:

| Input | Required? | How to Get It | |-------|-----------|---------------| | --product-url | ✅ ALWAYS | User provides the product page URL | | --product-image | ✅ ALWAYS | Download from the product page, or user provides | | --brand-profile | ✅ NEVER EMPTY | Pick from catalog or run brand-analyzer first. NEVER leave as "No Brand" if a brand is known | | --prompt-profile | ✅ ALWAYS | Choose based on campaign objective | | --aspect-ratio | Default: 4:5 | Change if needed for platform | | --model | 🔶 OPTIONAL | Model/talent face. Ads with talent perform much better. Empty = product-only ad (no person). When used, pick from ~/clawd/models-catalog/catalog/images/ (114 models available) | | --logo | 🔶 OPTIONAL | Try to find it. Use if good quality & easy to get. Skip if low-res or hard to find. Empty = bypassed | | --reference | 🔶 OPTIONAL (off) | Only when user explicitly asks to clone a reference ad. Empty = bypassed | | --creative-brief | 🔶 ON-DEMAND | Only when user gives explicit creative direction. Omit to let pipeline auto-generate from brand profile | | --language | 🔶 ON-DEMAND | Only when user requests a specific language. Omit to use default (es) |

🚨 NEVER Skip These Steps:

1. Product image — Download the main product photo from the product URL. The scraper is fragile; always provide a product image explicitly.
2. Brand profile — If the brand doesn't exist in the catalog, run brand-analyzer skill FIRST to generate one. Never submit with "No Brand" when a brand is known.
3. Brand logo — TRY to find it (Clearbit, logo.dev, brand website). Use if good quality. If not found or low-res, skip it — the variable accepts empty string (bypassed server-side).
4. Reference — Do NOT search for references by default. Only provide when the user explicitly asks to clone a specific ad or says "find a good ad to clone".

---

Auto-Preparation Workflow

When the user asks to generate an ad:

1. User provides: product URL + brand name + objective

2. CHECK brand profile exists:
   → ls ~/clawd/ad-ready/configs/Brands/ | grep -i "{brand}"
   → If not found: run brand-analyzer skill first

3. DOWNLOAD product image:
   → Visit the product URL or fetch the page
   → Find and download the main product image
   → Save to /tmp/ad-ready-product.jpg

4. DOWNLOAD brand logo:
   → Search "{brand name} logo PNG" or fetch from brand website
   → Download clean logo image
   → Save to /tmp/ad-ready-logo.png

...