Brand Analyzer: AI Brand Identity Profiler

Analyze any brand to generate a comprehensive brand identity JSON profile using Gemini Flash with Google Search grounding.

Overview

Brand Analyzer creates structured brand identity profiles by:

• Researching the brand via Google Search (official data, campaigns, visual identity)
• Analyzing brand behavior, visual patterns, photography style, tone of voice
• Generating a complete JSON profile following the standard template
• Storing the profile for reuse across all creative workflows

When to Use

• User asks to "analyze a brand" or "create a brand profile"
• Before running Ad-Ready when the brand isn't in the catalog
• When the user mentions a brand that doesn't have a profile yet
• To update/refresh an existing brand profile

Quick Commands

Analyze a brand and save to file

GEMINI_API_KEY="$KEY" uv run {baseDir}/scripts/analyze.py \
  --brand "Brand Name" \
  --output ./brands/Brand_Name.json

Analyze and auto-save to Ad-Ready brands catalog

GEMINI_API_KEY="$KEY" uv run {baseDir}/scripts/analyze.py \
  --brand "Heredero Gin" \
  --auto-save

The --auto-save flag automatically saves to ~/clawd/ad-ready/configs/Brands/{Brand_Name}.json

Print to stdout

GEMINI_API_KEY="$KEY" uv run {baseDir}/scripts/analyze.py --brand "Nike"

Inputs

Output Format

The generated JSON follows the standard brand identity template used by Ad-Ready:

{
  "brand_info": { "name", "tagline", "category", "positioning", "vision", "mission", "origin_story" },
  "brand_values": { "core_values", "brand_promise", "differentiators", "non_negotiables" },
  "target_audience": { "demographics", "psychographics" },
  "tone_of_voice": { "personality_traits", "communication_style", "language_register", ... },
  "visual_identity": { "logo", "color_system", "typography", "layout_principles" },
  "photography": { "style", "technical" },
  "campaign_guidelines": { "visual_tone", "model_casting", "product_presentation", ... },
  "brand_behavior": { "do_dont", "immutability" },
  "channel_expression": { "retail", "digital", "print" },
  "compliance": { ... }
}

Integration with Other Workflows

Ad-Ready

Morpheus Fashion Design

Custom Workflows

Analysis Methodology

The analyzer follows a 3-phase approach:

Phase 1: Official Research (via Google Search)

• Brand website, corporate pages, official communications
• Locks canonical data: name, founding, positioning, vision, mission, tagline

Phase 2: Campaign Research (via Google Search)

• Google Images and Pinterest for advertising campaigns
• Identifies 10+ distinct campaigns
• Treats them as analytical reference material

Phase 3: Deductive Visual Analysis

• Cross-sectional analysis of visual patterns
• Identifies recurring photography style, color systems, typography
• Fills visual identity fields not covered by official data

API Key

Uses Gemini API. Set via:

• GEMINI_API_KEY environment variable
• --api-key flag