Brand Analyzer：AI 品牌身份分析器

使用 Gemini Flash 搭配 Google 搜索增强功能，对任意品牌进行分析，生成结构化的品牌身份 JSON 档案。

概述

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

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

适用场景

• 用户提出“分析一个品牌”或“创建品牌档案”类请求时
• 在 Brand 不在 Ad-Ready 品牌目录中时，运行 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

⚠️ 强制要求：每次新增品牌档案后必须立即推送至 GitHub

每生成并保存一个新品牌档案，都必须立即推送至 GitHub 仓库。 此为硬性要求——ComfyDeploy 的部署流程依赖该仓库拉取品牌档案。

cd ~/clawd/ad-ready
git add configs/Brands/{Brand_Name}.json
git commit -m "Add brand profile: {Brand Name}"
git push origin main

请勿跳过此步骤。ComfyDeploy 上的广告生成流水线需从仓库中读取品牌档案才能正常运行。

直接输出至标准输出（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 时尚设计

品牌视觉识别系统（色彩体系、摄影风格、语气语调等）可为 Morpheus 营销活动提供策略依据。

自定义工作流

可加载任意品牌档案 JSON 文件，从中提取视觉识别、语气语调或营销活动规范，用于各类创意任务。

分析方法论

本分析器采用三阶段分析法：

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

• 检索品牌官网、企业页面、官方新闻稿及公开声明等权威信源
• 锁定核心基准数据：品牌名、标语（tagline）、所属品类、市场定位（positioning）、愿景（vision）、使命（mission）、创立故事（origin_story）

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

• 利用 Google 图片搜索与 Pinterest 搜寻历史广告活动素材
• 识别并收录 10+ 个具有代表性的独立营销活动
• 将这些活动视为关键分析参照样本

第三阶段：推演式视觉分析

• 开展跨活动的横向视觉模式比对分析
• 归纳高频出现的摄影风格、色彩系统、字体排印特征
• 补全官方资料中未覆盖的视觉识别字段

API 密钥配置

本工具调用 Gemini API，可通过以下任一方式配置密钥：

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