Communitygithub.com

TheMattBerman/landing-page-factory

从网站或手动简报中提取运营商级别的源事实:声明、证据、行动号召、机制语言、信任信号、视觉模式和页面结构,并附带出处。这是页面工厂的第一阶段。

landing-page-factory 是什么?

这是一个名为“站点提取”的AI智能体技能,旨在从给定的网站URL或手动简报中提取结构化的源事实,为后续的落地页构建提供可靠的数据基础。它严格遵循“不合成,只提取”的原则,要求所有声明、证据、视觉模式等信息都必须有明确的出处,区分“观察到的”事实和“推断的”信息,避免将模糊信息美化为确定事实。该技能支持Firecrawl API进行深度站点提取,能够获取品牌标识、颜色、字体等视觉信息,同时也提供降级提取方案。最终输出结构化的Markdown和JSON文件(位于`workspace/brand/`目录下),包含品牌、声明、证据、行动号召、机制语言、信任信号、页面模式、视觉元素、受众信号等详细清单,并针对信息缺失或薄弱环节给出明确标记和后续行动建议。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/TheMattBerman/landing-page-factory/tree/HEAD/skills/site-extract

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

站点提取

当用户提供一个网站URL并希望构建落地页,但又不想经历繁琐的输入流程时,请使用此功能。

此阶段不进行合成,只负责提取。

如果你无法将某个声明、证据点或信任信号追溯回源,请将其标记为“缺失”或“推断”。不要悄悄将其升级为事实。

必需输入

  • 主要URL
  • 可选的产品URL
  • 可选的 --deep 参数
  • 如果源访问不完整,可选的简短手动简报片段

操作目标

构建一个下游技能可以信赖的源记录。

这意味着要提取:

  • 确切的声明语言
  • 确切的行动号召语言
  • 确切的证据点
  • 可见的页面模式
  • 机制语言
  • 信任信号
  • 视觉标识
  • 类别惯例

输出文件

写入:

  • workspace/brand/extract.md
  • workspace/brand/extract.json
  • workspace/brand/palette.json

硬性提取规则

  1. 尽可能保留确切的语言。引用,不要转述。
  2. 为每个证据项目和主要声明标记出处。
  3. 区分观察到的事实和推断。
  4. 如果源信号薄弱,请直接说明。
  5. 如果在提取后机制仍不明确,下游策略必须停止,直到问题解决。

必需的提取结构

# 品牌提取:[品牌]
来源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 必须包含机器可读的键:

  • brand
  • category
  • offer
  • hero_language
  • claims[]
  • 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 被运行时阻止、不可用或缺少密钥:

  1. 明确说明这一点
  2. 询问操作员是否愿意:
    • 提供/配置 Firecrawl
    • 在沙箱外运行本地 Firecrawl 提取命令
    • 接受降级的手动/基本提取
  3. 在进行公开发布质量的运行时,不要静默地使用降级提取。

仅当用户已明确批准降级时,才可以在不询问的情况下使用降级提取。

当 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 参数时:

  1. 抓取主页
  2. 抓取一个产品/服务页面
  3. 如果可用,抓取一个证据密集型页面
  4. 如果可用,抓取定价、常见问题解答或关于页面
  5. 合并发现结果,为每个项目附加源URL

默认深度优先级:

  • 产品页面
  • 评论/推荐页面
  • 常见问题解答/定价页面
  • 关于页面

降级行为

如果 Firecrawl 或抓取失败:

  • 抓取任何可访问的内容
  • 明确标记被阻止的部分
  • 请求操作员提供缺失的信任/证据/机制数据的屏幕截图或文本
  • 不要编造提取的结构,仿佛它是被观察到的一样

如果 Firecrawl 被 Cowork 或其他沙箱代理阻止:

  • 说明运行时必须允许访问 api.firecrawl.dev
  • 推荐本地预检命令路径,而不是假装 WebFetch 是等价的

停止/继续逻辑

满足以下条件时继续:

  • 产品/服务可识别
  • 行动号召可推断
  • 至少可以提取一些证据或信任信号

满足以下条件时降级:

  • 证据薄弱
  • 视觉标识不完整
  • 类别惯例不清晰

满足以下条件时停止并提醒操作员:

  • 无法识别独特的机制
  • 源信息过于单薄,无法将真实声明与营销迷雾区分开来
  • 出现受监管的声明但没有明确的证据

移交

提取完成后,运行 /page-strategy。

除非策略产出已存在,否则不要直接跳转到文案编写。

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

TheMattBerman/landing-page-factory

Build an evidence-backed brand profile from site extract and page strategy. Separates observed facts from synthesis so downstream skills preserve the brand instead of rewriting it.

TheMattBerman/landing-page-factory

Top-level operator skill for Landing Page Factory. Classifies requests, chooses stage order, enforces prerequisites and hard stops, manages variant pages, reruns changed stages, and handles page-package admin.

TheMattBerman/landing-page-factory

Build a deployable landing page from strategy, copy, visuals, and brand profile using category-aware routing, preservation hierarchy, and explicit QA. Single-file HTML output.

TheMattBerman/landing-page-factory

Write mechanism-preserving, proof-disciplined landing page copy from strategy, brand profile, and extract language bank. Includes mandatory sharpness audit and claim control.

TheMattBerman/landing-page-factory

Final landing-page QA pass against strategy, proof provenance, mechanism clarity, trust preservation, accessibility, and anti-slop. Gates whether a page is shippable or draft-only.

TheMattBerman/landing-page-factory

Normalize raw extract or manual brief into a page strategy artifact: mechanism, offer, audience, proof provenance, CTA, preservation plan, and review flags. Mandatory before copy or build.

TheMattBerman/landing-page-factory

Plan and generate visuals by preservation class: exact product, branded environment, or concept support. Uses strategy-driven shot selection and visual QA instead of generic vibe prompting.

相关技能