Brand Analyzer：AI 品牌身份分析器

使用 Gemini Flash 模型并结合 Google 搜索增强功能，对任意品牌进行分析，生成结构完整、符合标准的品牌身份 JSON 档案。

概述

Brand Analyzer 通过以下步骤构建结构化的品牌身份档案：

1. 调研：借助 Google 搜索获取品牌官方信息（如官网、营销活动、视觉识别系统等）
2. 分析：解析品牌行为模式、视觉规律、摄影风格及语调（tone of voice）
3. 生成：依据标准模板输出完整的 JSON 格式品牌档案
4. 存储：将档案持久化保存，供所有创意工作流复用

适用场景

• 用户明确提出“分析某品牌”或“创建品牌档案”类请求时
• 在运行 Ad-Ready 流程前，目标品牌尚未收录于品牌目录中
• 用户提及一个当前尚无对应档案的品牌时
• 需要更新或刷新已有品牌档案时

快捷命令

分析品牌并保存至指定文件

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

分析品牌并自动存入 Ad-Ready 品牌目录

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

--auto-save 参数会自动将档案保存至 ~/clawd/ad-ready/configs/Brands/{Brand_Name}.json

直接输出至标准输出（stdout）

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

输入参数

输出格式

生成的 JSON 档案严格遵循 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": { ... }
}

与其他工作流的集成

Ad-Ready

生成的品牌档案将自动作为 brand_profile 选项，在广告生成过程中被调用。

Morpheus Fashion Design

品牌视觉识别要素（如配色体系、摄影风格、语调）可用于指导 Morpheus 的系列策划与 Campaign 制作。

自定义工作流

可加载任意品牌 JSON 档案，从中提取视觉识别规范、语调指南或 Campaign 执行准则，服务于各类创意任务。

分析方法论

本分析器采用三阶段递进式分析流程：

第一阶段：官方资料调研（基于 Google 搜索）

• 检索品牌官网、企业页面、官方新闻稿及公开声明等权威信源
• 锁定基础且不可争议的规范性数据：品牌名称、创立背景、市场定位、愿景、使命、标语等

第二阶段：营销活动调研（基于 Google 搜索）

• 利用 Google 图片搜索与 Pinterest 平台挖掘历史广告 Campaign 视觉素材
• 识别并采集 10+ 个具有代表性的独立 Campaign
• 将这些 Campaign 视为关键分析参照样本

第三阶段：归纳式视觉分析

• 开展跨 Campaign 的横向视觉比对分析
• 识别高频复现的摄影风格、色彩系统、字体组合等视觉范式
• 补全官方资料中未覆盖的视觉身份字段

API 密钥配置

本工具依赖 Gemini API。密钥可通过以下任一方式提供：

• 设置 GEMINI_API_KEY 环境变量
• 使用 --api-key 命令行参数显式传入