名称： brand-analyzer
描述： 分析品牌以生成全面的品牌身份档案（JSON）。当用户想要分析品牌、创建品牌档案或需要品牌数据用于广告生成时使用。存储档案以便在 Ad-Ready、Morpheus 和其他创意工作流中复用。可以列出和更新现有档案。

品牌分析器：AI 品牌身份档案生成器

使用 Gemini Flash 结合 Google 搜索，分析任何品牌以生成全面的品牌身份 JSON 档案。

概述

品牌分析器通过以下步骤创建结构化的品牌身份档案：
1. 研究：通过 Google 搜索（官方数据、广告活动、视觉识别）
2. 分析：品牌行为、视觉模式、摄影风格、语气语调
3. 生成：遵循标准模板的完整 JSON 档案
4. 存储：存储档案以便在所有创意工作流中复用

使用时机

• 用户要求“分析一个品牌”或“创建品牌档案”
• 在运行 Ad-Ready 之前，若品牌不在目录中
• 当用户提及一个尚无档案的品牌时
• 需要更新/刷新现有品牌档案时

快速命令

分析品牌并保存到文件

GEMINI_API_KEY="$KEY" uv run {baseDir}/scripts/analyze.py \
  --brand "品牌名称" \
  --output ./brands/品牌名称.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 "添加品牌档案: {Brand Name}"
git push origin main

切勿跳过此步骤。 ComfyDeploy 上的广告生成流水线需要代码仓库中的档案才能正常工作。

打印到标准输出

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 搜索）

• 品牌官网、企业页面、官方通讯
• 锁定权威数据：名称、创立信息、定位、愿景、使命、标语

第二阶段：广告活动研究（通过 Google 搜索）

• 通过 Google 图片和 Pinterest 查找广告活动
• 识别 10 个以上不同的广告活动
• 将其作为分析参考材料

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

• 对视觉模式进行横截面分析
• 识别重复出现的摄影风格、色彩体系、字体
• 填充官方数据未涵盖的视觉识别字段

API 密钥

使用 Gemini API。通过以下方式设置：
- GEMINI_API_KEY 环境变量
- --api-key 标志