Site Extract
當用戶提供網站 URL 且希望建立登陸頁面,但又不想經歷繁瑣的輸入流程時,使用此技能。
此階段不進行合成,只進行提取。
如果無法將某項主張、證據點或信任線索追溯到來源,請將其標記為「缺失」或「推斷」。請勿悄悄將它升級為事實。
必要輸入
- 主要 URL
- 可選的產品 URL
- 可選的
--deep參數 - 若來源存取不完整,可選的人工簡報片段
操作者目標
建立一個下游技能可以信賴的來源記錄。
這意味著提取:
- 確切的主張語言
- 確切的 CTA 語言
- 確切的證據點
- 可見的頁面模式
- 機制語言
- 信任線索
- 視覺識別
- 類別慣例
輸出檔案
請寫入:
workspace/brand/extract.mdworkspace/brand/extract.jsonworkspace/brand/palette.json
嚴格提取規則
- 盡可能保留確切的語言。引用,不要改寫。
- 為每個證據項目和主要主張標記來源出處。
- 區分觀察到的事實與推斷。
- 如果來源訊號薄弱,直接說出來。
- 如果提取後機制仍不明確,下游策略必須停止,直到問題解決為止。
必要的提取結構
# 品牌提取:[品牌名稱]
來源 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 必須包含機器可讀的鍵,用於:
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 格式會回傳結構化的品牌識別:
- Logo URL
- 色彩調色盤(主色、輔助色、強調色、背景色、文字色)
- 字體家族
- 間距比例
- UI 元件樣式
- 色彩方案(淺色/深色)
markdown 格式提供頁面內容,用於主張和證據提取。
screenshot 格式提供視覺參考(URL 在 24 小時後過期)。
使用 scripts/firecrawl-extract.sh 自動執行此操作並儲存所有輸出。
深度模式
當使用 --deep 時:
- 抓取首頁
- 抓取一個產品/服務頁面
- 抓取一個證據豐富的頁面(如果有的話)
- 抓取價格、常見問題或關於頁面(如果有的話)
- 合併所有發現,並為每個項目附加來源 URL
預設深度優先順序:
- 產品頁面
- 評論/見證頁面
- 常見問題/價格頁面
- 關於頁面
降級行為
如果 Firecrawl 或抓取失敗:
- 擷取任何可存取的內容
- 明確標記被封鎖的區段
- 要求操作者提供遺失的信任/證據/機制資料的螢幕截圖或文案
- 請勿憑空捏造提取的結構,假裝它是觀察到的結果
如果 Firecrawl 被 Cowork 或其他沙箱代理封鎖:
- 說明
api.firecrawl.dev必須由執行環境允許 - 建議使用本機預檢命令路徑,而非假裝 WebFetch 與之等效
停止 / 繼續邏輯
在以下情況下繼續:
- 可識別提供
- 可推斷 CTA
- 至少可以提取部分證據或信任線索
在以下情況下降級:
- 證據薄弱
- 視覺識別不完整
- 類別慣例不明確
在以下情況下停止並通知操作者:
- 無法識別獨特的機制
- 來源過於薄弱,無法將真實主張與行銷迷霧區分開來
- 出現受監管的主張,但沒有明確的證據
交接
提取完成後,執行 /page-strategy。
除非策略文件已存在,否則請勿直接跳到文案撰寫。