Communitygithub.com

TheMattBerman/landing-page-factory

從網站或人工簡報中提取運營級別的原始事實:主張、證據、CTA、機制語言、信任線索、視覺模式及頁面結構,並附帶來源追溯。Page Factory 的第一步。

landing-page-factory 是什麼?

「Landing Page Factory」的第一階段「Site Extract」是一個嚴謹的源資料擷取技能,旨在解決落地頁生成過程中的資訊膨脹與事實失真問題。當用戶提供網站 URL 時,此技能不會進行任何合成或生成,而是專注於從原始內容中提取運營級別的原始事實,包括精確的主張語言、CTA 文字、證據點、機制語言、信任線索、視覺識別及類別慣例。其核心設計哲學是「可追溯性」:每一項主張、證據和信任線索都必須能夠追溯到其原始來源,並明確標註是「觀察到的事實」還是「推斷」,若無法追溯則直接標記為缺失或推斷,絕不悄悄升級為事實。此技能支援任何可透過 URL 存取的網站,並深度整合 Firecrawl API 以進行結構化的品牌資料擷取,同時也提供手動簡報作為替代方案。最終產出為結構化的 markdown 文件、JSON 合約和調色板檔案,為後續的頁面策略與文案生成提供可靠的事實基礎。

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Site Extract

當用戶提供網站 URL 且希望建立登陸頁面,但又不想經歷繁瑣的輸入流程時,使用此技能。

此階段不進行合成,只進行提取。

如果無法將某項主張、證據點或信任線索追溯到來源,請將其標記為「缺失」或「推斷」。請勿悄悄將它升級為事實。

必要輸入

  • 主要 URL
  • 可選的產品 URL
  • 可選的 --deep 參數
  • 若來源存取不完整,可選的人工簡報片段

操作者目標

建立一個下游技能可以信賴的來源記錄。

這意味著提取:

  • 確切的主張語言
  • 確切的 CTA 語言
  • 確切的證據點
  • 可見的頁面模式
  • 機制語言
  • 信任線索
  • 視覺識別
  • 類別慣例

輸出檔案

請寫入:

  • 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 | 來源出處 |
|---|---|---|---|
| 標題 | | | 觀察到 |
| 副標題 | | | 觀察到 |
| 主要 CTA | | | 觀察到 |
| 次要 CTA | | | 觀察到 |

## 3. 主張清單
| 主張 | 類型 | 來源 URL | 區段 | 來源出處 | 需要證據嗎? |
|---|---|---|---|---|---|
|  | 利益 / 機制 / 優越性 / 社會證明 / 保證 | | | 觀察到 / 推斷 | 是 / 否 |

## 4. 證據清單
| 證據項目 | 類別 | 確切用語 / 數值 | 來源 URL | 區段 | 備註 |
|---|---|---|---|---|---|
|  | 見證 / 統計 / 評論數 / 標誌 / 新聞 / 保證 | verified_source / derived_source / missing | | | |

## 5. CTA 清單
| CTA 文字 | 目標頁面猜測 | 來源 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 格式會回傳結構化的品牌識別:

  • Logo URL
  • 色彩調色盤(主色、輔助色、強調色、背景色、文字色)
  • 字體家族
  • 間距比例
  • UI 元件樣式
  • 色彩方案(淺色/深色)

markdown 格式提供頁面內容,用於主張和證據提取。 screenshot 格式提供視覺參考(URL 在 24 小時後過期)。

使用 scripts/firecrawl-extract.sh 自動執行此操作並儲存所有輸出。

深度模式

當使用 --deep 時:

  1. 抓取首頁
  2. 抓取一個產品/服務頁面
  3. 抓取一個證據豐富的頁面(如果有的話)
  4. 抓取價格、常見問題或關於頁面(如果有的話)
  5. 合併所有發現,並為每個項目附加來源 URL

預設深度優先順序:

  • 產品頁面
  • 評論/見證頁面
  • 常見問題/價格頁面
  • 關於頁面

降級行為

如果 Firecrawl 或抓取失敗:

  • 擷取任何可存取的內容
  • 明確標記被封鎖的區段
  • 要求操作者提供遺失的信任/證據/機制資料的螢幕截圖或文案
  • 請勿憑空捏造提取的結構,假裝它是觀察到的結果

如果 Firecrawl 被 Cowork 或其他沙箱代理封鎖:

  • 說明 api.firecrawl.dev 必須由執行環境允許
  • 建議使用本機預檢命令路徑,而非假裝 WebFetch 與之等效

停止 / 繼續邏輯

在以下情況下繼續:

  • 可識別提供
  • 可推斷 CTA
  • 至少可以提取部分證據或信任線索

在以下情況下降級:

  • 證據薄弱
  • 視覺識別不完整
  • 類別慣例不明確

在以下情況下停止並通知操作者:

  • 無法識別獨特的機制
  • 來源過於薄弱,無法將真實主張與行銷迷霧區分開來
  • 出現受監管的主張,但沒有明確的證據

交接

提取完成後,執行 /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.

相關技能