站点提取
当用户提供一个网站URL并希望构建落地页,但又不想经历繁琐的输入流程时,请使用此功能。
此阶段不进行合成,只负责提取。
如果你无法将某个声明、证据点或信任信号追溯回源,请将其标记为“缺失”或“推断”。不要悄悄将其升级为事实。
必需输入
- 主要URL
- 可选的产品URL
- 可选的
--deep参数 - 如果源访问不完整,可选的简短手动简报片段
操作目标
构建一个下游技能可以信赖的源记录。
这意味着要提取:
- 确切的声明语言
- 确切的行动号召语言
- 确切的证据点
- 可见的页面模式
- 机制语言
- 信任信号
- 视觉标识
- 类别惯例
输出文件
写入:
workspace/brand/extract.mdworkspace/brand/extract.jsonworkspace/brand/palette.json
硬性提取规则
- 尽可能保留确切的语言。引用,不要转述。
- 为每个证据项目和主要声明标记出处。
- 区分观察到的事实和推断。
- 如果源信号薄弱,请直接说明。
- 如果在提取后机制仍不明确,下游策略必须停止,直到问题解决。
必需的提取结构
# 品牌提取:[品牌]
来源URL:
- [url 1]
- [url 2]
提取日期:[日期]
置信度:高 | 中 | 低
## 1. 品牌 + 类别
- 品牌名称:
- 产品类别:
- 主要产品/服务:
- 商业模式:
- 地域/市场提示:
## 2. 确切的英雄区域语言
| 元素 | 确切文本 | 来源URL | 出处 |
|---|---|---|---|
| 标题 | | | 观察到 |
| 副标题 | | | 观察到 |
| 首要行动号召 | | | 观察到 |
| 次要行动号召 | | | 观察到 |
## 3. 声明清单
| 声明 | 类型 | 来源URL | 部分 | 出处 | 需要证据? |
|---|---|---|---|---|---|
| | 效益 / 机制 / 优越性 / 社会证明 / 保证 | | | 观察到 / 推断 | 是 / 否 |
## 4. 证据清单
| 证据项 | 类别 | 确切措辞 / 值 | 来源URL | 部分 | 备注 |
|---|---|---|---|---|---|
| | 推荐 / 统计数据 / 评论数 / 徽标 / 新闻 / 保证 | verified_source / derived_source / missing | | | |
## 5. 行动号召清单
| 行动号召文本 | 目标页面推测 | 来源URL | 在首屏? | 备注 |
|---|---|---|---|---|
## 6. 机制语言清单
- 品牌重复使用的独特机制短语
- 值得保留的产品解释短语
- 描述竞品失败的语言
- 处理异议的语言
## 7. 信任信号清单
- 保证
- 物流/退货/保修
- 认证/新闻/徽标
- 合规/安全/权威信号
- 表示合法性的类别惯例
## 8. 页面模式清单
| 部分顺序 | 出现内容 | 作用 | 值得保留? |
|---|---|---|---|
## 9. 视觉元素清单
- 主色
- 字体家族/类别
- 产品摄影风格
- UI / 截图风格(如有)
- 形状语言
- 密度/间距感觉
- 对信任至关重要的设计惯例
## 10. 受众信号
- 目标受众是谁
- 认知阶段线索
- 专业程度线索
- 明确的痛点语言
- 明确的渴望语言
## 11. 缺失/薄弱区域
- 缺失的机制细节
- 无支持的声明
- 薄弱的证据
- 无法访问的页面
- 任何需要操作员决策的事项
JSON 协议
extract.json 必须包含机器可读的键:
brandcategoryofferhero_languageclaims[]proof_inventory[]cta_inventory[]mechanism_language[]trust_cues[]page_patterns[]visual_motifs[]audience_signals[]missing_flags[]confidence
Firecrawl 集成
此处必须进行提供商选择。
如果 FIRECRAWL_API_KEY 可用,则必须使用 Firecrawl 进行站点提取。
当 Firecrawl 已配置或预期使用时,不要静默地替换为通用浏览、WebFetch 或单页抓取。
如果 Firecrawl 被运行时阻止、不可用或缺少密钥:
- 明确说明这一点
- 询问操作员是否愿意:
- 提供/配置 Firecrawl
- 在沙箱外运行本地 Firecrawl 提取命令
- 接受降级的手动/基本提取
- 在进行公开发布质量的运行时,不要静默地使用降级提取。
仅当用户已明确批准降级时,才可以在不询问的情况下使用降级提取。
当 Firecrawl 可用时,使用带有 "branding" 格式的 v2 API:
curl -s -X POST "https://api.firecrawl.dev/v2/scrape" \
-H "Authorization: Bearer $FIRECRAWL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.com",
"formats": ["branding", "markdown", "screenshot"],
"onlyMainContent": false,
"maxAge": 172800000
}'
"branding" 格式返回结构化的品牌标识:
- 徽标 URL
- 调色板(主色、辅色、强调色、背景色、文本色)
- 字体家族
- 间距等级
- UI 组件样式
- 配色方案(亮色/暗色)
"markdown" 格式提供页面内容,用于声明和证据提取。 "screenshot" 格式提供视觉参考(URL 24 小时后过期)。
使用 scripts/firecrawl-extract.sh 自动运行此操作并保存所有输出。
深度模式
当使用 --deep 参数时:
- 抓取主页
- 抓取一个产品/服务页面
- 如果可用,抓取一个证据密集型页面
- 如果可用,抓取定价、常见问题解答或关于页面
- 合并发现结果,为每个项目附加源URL
默认深度优先级:
- 产品页面
- 评论/推荐页面
- 常见问题解答/定价页面
- 关于页面
降级行为
如果 Firecrawl 或抓取失败:
- 抓取任何可访问的内容
- 明确标记被阻止的部分
- 请求操作员提供缺失的信任/证据/机制数据的屏幕截图或文本
- 不要编造提取的结构,仿佛它是被观察到的一样
如果 Firecrawl 被 Cowork 或其他沙箱代理阻止:
- 说明运行时必须允许访问
api.firecrawl.dev - 推荐本地预检命令路径,而不是假装 WebFetch 是等价的
停止/继续逻辑
满足以下条件时继续:
- 产品/服务可识别
- 行动号召可推断
- 至少可以提取一些证据或信任信号
满足以下条件时降级:
- 证据薄弱
- 视觉标识不完整
- 类别惯例不清晰
满足以下条件时停止并提醒操作员:
- 无法识别独特的机制
- 源信息过于单薄,无法将真实声明与营销迷雾区分开来
- 出现受监管的声明但没有明确的证据
移交
提取完成后,运行 /page-strategy。
除非策略产出已存在,否则不要直接跳转到文案编写。