用途：通过 Brand.dev API 监测品牌提及、分析情感倾向并发现公关机会。需先在 .env、.env.local 或 ~/.claude/.env.global 中设置 BRANDDEV_API_KEY，可在 https://brand.dev/ 获取；未设置时应提示用户添加。所有请求发往 https://api.brand.dev/v1/，请求头为 Authorization: Bearer {BRANDDEV_API_KEY}。
主要能力：品牌搜索（GET /brand/search，参数 query、limit 默认20最大100、offset、sort=relevance|date、from_date、to_date），返回来源、标题、情感、日期与 URL；品牌信息查询（GET /brand/info，参数 domain 或 name），返回名称、域名、描述、行业、成立年份、总部、社交链接、logo、配色、员工规模；Logo 检测（GET /logo/search，参数 brand、domain、limit），用于发现未授权使用、合作伙伴曝光、活动报道与假冒产品；提及追踪（POST /monitors 创建监控，可设 name、keywords、exclude_keywords、sources、languages、notify_email；GET /monitors 列出；GET /monitors/{monitor_id}/mentions 获取结果）；情感分析（GET /brand/sentiment，参数 query、from_date、to_date、granularity=day|week|month），正向>0.3，中性-0.3到0.3，负向<-0.3；竞品对比可比较提及量与情感分布，找出竞品被提及而自身未覆盖的来源。
使用方式：按需调用上述端点，可用 curl 加 Authorization 头访问；响应可用 python3 解析 results 字段提取来源、标题、情感、日期与 URL。完整品牌审计流程为：拉取品牌信息、统计近30/90天提及量与来源分布、分析情感趋势并定位负面峰值、从提及数据中识别公关机会、检查 logo 曝光与未授权使用、最后按报告模板汇总概述、情感趋势、正面与负面提及、公关机会、竞品对比及行动项。
适用场景：品牌声誉监控、竞品分析、公关与内容机会挖掘、视觉资产与假冒监测、危机期高频跟踪。
限制：依赖有效 API Key 与 Brand.dev 服务；错误码包括 401 无效/过期密钥、403 权限不足、404 资源不存在（检查 monitor ID）、429 超出速率限制需重试、500 服务器错误稍后重试；未提供免费额度、价格与平台细节。建议关键词包含正确名称与常见拼写错误，排除自身域名，并为竞品也设置监控，至少每周检查一次，发布或危机期每日检查。