visual-research

visual-research 是一个完整流程技能，用于调研品牌的视觉识别：从各可用来源采集图像，并打包为带 13 节竞品分析的可视化 HTML 报告。流程为 DISCOVER → CAPTURE → EXTRACT → ANALYZE → PACKAGE。所需工具：curl（必需，用于 Instagram API 调用与图片下载，macOS/Linux 预装）；可选 GEMINI_API_KEY（Gemini Vision，用于配色提取与构图分析，缺失则回退到 Claude 内置视觉）；可选 CLI 工具 Playwright（全页截图，安装命令 npx playwright install chromium）、yt-dlp（YouTube/TikTok 缩略图，pip3 install yt-dlp）、Scrapling（反爬抓取，pip3 install scrapling）。设置阶段会检查各前置条件并报告缺失项，若有缺失需用户确认后才继续。来源选择阶段让用户多选社交媒体（Instagram、TikTok、YouTube、X）、设计行业来源（Agency case studies、Brand New、Awwwards、Trade press）与其他来源（App Store、Press/media kit、Financial data）；网站首页加英雄图管线始终包含。用户可用内联或 JSON 品牌配置输入，仅提供品牌名时在 Phase 1 发现其余信息。各阶段受来源门控，只处理选中的来源。提取阶段优先获取英雄图与官方 logo，并包含图像分辨率最大化（去除 CDN 缩放参数）与图像校验步骤，以防止损坏图像污染对话上下文。限制：使用依赖外部工具与 API 密钥；token 估算为近似值；第三方页面 cookie 弹窗可能影响截图，需脚本化 Playwright 处理。具体收费与价格暂未提供。