核心用法
Brand Analyzer 是一款 AI 驱动的品牌身份分析工具，通过三阶段方法论为任意品牌生成结构化的 JSON 配置文件。用户只需提供品牌名称，工具即自动执行：Phase 1 官方研究（抓取品牌官网、企业页面锁定核心定位信息）、Phase 2 campaign 研究（分析 Google Images/Pinterest 广告素材）、Phase 3 视觉推导分析（交叉比对识别摄影风格、色彩系统、字体规律）。输出遵循 Ad-Ready 标准模板，涵盖品牌信息、价值观、目标受众、语调风格、视觉识别、摄影规范、渠道表达等 10 大模块。
显著优点
1. 全流程自动化：无需人工调研，AI 完成从信息搜集到结构化输出的完整链路，单次分析即可生成可直接投入生产的品牌资产包。
2. 工作流深度集成：原生支持 --auto-save 自动同步至 Ad-Ready 品牌目录，Morpheus 时尚设计等下游工具可直接调用，消除数据孤岛。
3. 方法论严谨：三阶段分析框架区分"官方锁定数据"与"推导性视觉判断"，既保证核心信息的准确性，又保留创意解读空间。
4. 输出标准化：JSON Schema 统一，便于程序化解析和跨团队协作，替代传统 PDF 品牌手册的碎片化传递。
潜在缺点与局限性
- 外部 API 强依赖：核心功能绑定 Gemini API 与 Google Search，服务中断或政策变更将直接导致工具失效，无离线 fallback 方案。
- 品牌覆盖盲区：小众品牌、新兴 DTC 品牌或区域品牌可能因网络信息不足导致分析质量下降，视觉推导存在主观偏差风险。
- 实时性瓶颈：依赖搜索引擎快照，无法捕捉品牌最新 campaign 或刚发布的视觉升级，需定期手动刷新。
- 输出路径风险：
--output参数接受任意文件系统路径，虽经sanitize_brand_name()()过滤，但用户误操作仍可能覆盖关键文件。
适合的目标群体
- 广告创意团队：需快速为新客户建立品牌档案，支撑 Ad-Ready 等 AI 广告生成工作流。
- 品牌策略顾问：为 pitch 阶段快速产出竞品分析或行业基准研究。
- 电商运营/设计师：管理多品牌矩阵，需标准化归档各品牌视觉规范。
- 营销技术开发者：构建自动化创意中台，需结构化品牌数据作为 LLM prompt 上下文。
使用风险
- API 成本与配额：Gemini Flash 调用伴随 token 消耗，大规模批量分析需监控用量；Google Search 工具可能受速率限制。
- 数据隐私合规：分析竞品品牌时，输出内容可能包含受版权保护的视觉描述或 campaign 策略摘要，商用需法律审核。
- 调试日志残留：调试模式下生成的
/tmp/brand-analyzer-debug-*.txt可能包含 API 响应原始数据，生产环境需确保清理机制。 - 版本兼容性：
google-genai>=1.0.0为较新库，与旧版 SDK 存在 breaking change，升级需谨慎验证。