seo-audit

完整網站 SEO 稽核

流程

1. 渲染首頁：使用 claude-seo run render_page.py <url> --mode auto --json 擷取原始 HTML、渲染後 HTML、擷取文字、SPA 狀態及無障礙資料（需要時）
2. 偵測商業類型：根據 SEO 協調器分析首頁訊號
3. 爬取網站：遵循內部連結最多 500 個頁面，遵守 robots.txt
4. 委派給子代理程式（若可用，否則依序內聯執行）：
   • seo-technical -- robots.txt、Sitemap、Canonical、Core Web Vitals、安全標頭
   • seo-content -- E-E-A-T、可讀性、內容貧乏、AI 引用準備度
   • seo-schema -- 偵測、驗證、產生建議
   • seo-sitemap -- 結構分析、品質門檻、遺漏頁面
   • seo-performance -- LCP、INP、CLS 測量
   • seo-visual -- 螢幕截圖、行動裝置測試、首屏分析
   • seo-geo -- AI 爬蟲存取、llms.txt、可引用性、品牌提及訊號
   • seo-local -- GBP 訊號、NAP 一致性、評論、本地 Schema、產業特定本地因素（偵測到本地服務產業時啟動：實體店面、服務區域型或混合型商業）
   • seo-maps -- 地理網格排名追蹤、GBP 稽核、評論智慧分析、競爭對手半徑對應（偵測到本地服務且 DataForSEO MCP 可用時啟動）
   • seo-google -- CWV 實測資料（CrUX）、URL 索引狀態（GSC）、自然流量（GA4）（透過 claude-seo run google_auth.py --check 偵測到 Google API 憑證時啟動）
   • seo-backlinks -- 反向連結資料：DA/PA、參照網域、連結文字、有毒連結（透過 claude-seo run backlinks_auth.py --check 偵測到 Moz 或 Bing API 憑證時啟動，或始終包含 Common Crawl 網域層級指標）
   • seo-cluster -- 語意聚類分析（偵測到內容策略訊號時啟動：部落格、支柱頁面、主題群集）
   • seo-sxo -- 搜尋體驗分析：頁面類型不符、使用者故事、人物誌評分（完整稽核中始終包含）
   • seo-drift -- 漂移分析：與儲存的基準比較（透過 claude-seo run drift_history.py <url> 偵測到該 URL 的漂移基準時啟動）
   • seo-ecommerce -- 產品 Schema、市場情報（偵測到電子商務產業時啟動）
5. 評分 -- 彙總為 SEO 健康分數（0-100）
6. 保存稽核產出 -- 將所有輸出寫入 {domain}-audit/ 目錄
7. 報告 -- 產生優先順序行動計畫及可選的 PDF/HTML 報告

爬取設定

最大頁面數：500
遵守 robots.txt：是
跟隨重新導向：是（最多 3 跳）
每頁逾時：30 秒
並行請求數：5
請求間延遲：1 秒

輸出檔案

• {domain}-audit/FULL-AUDIT-REPORT.md：完整發現
• {domain}-audit/ACTION-PLAN.md：優先順序建議（嚴重 > 高 > 中 > 低）
• {domain}-audit/audit-data.json：結構化稽核封包，用於報告產生
• {domain}-audit/findings/*.md：各類別專家發現（technical.md、content.md、schema.md、performance.md、visual.md 等）
• {domain}-audit/screenshots/：桌面版 + 行動版截圖（若 Playwright 可用）
• PDF 報告（建議）：使用 claude-seo run google_report.py --type full --data {domain}-audit/audit-data.json --domain <domain> --output-dir {domain}-audit/ 產生專業 A4 PDF。此報告為白色封面企業報告，包含目錄、摘要、圖表（Lighthouse 儀表、查詢條、索引甜甜圈圖）、指標卡片、門檻表格、優先順序建議（含工作量估計）及實作藍圖。完成稽核後務必提供 PDF 產生選項。

結構化稽核資料封包

寫入 {domain}-audit/audit-data.json，格式如下，以便 claude-seo run google_report.py --type full --data {domain}-audit/audit-data.json --domain <domain> --output-dir {domain}-audit/ 即使在 Google API 資料不可用時也能產生報告：

{
  "summary": {
    "health_score": 0,
    "business_type": "detected type",
    "top_findings": [],
    "quick_wins": []
  },
  "categories": [
    {
      "name": "Technical SEO",
      "score": 0,
      "what_works": [],
      "findings": [
        {
          "title": "Finding title",
          "severity": "Critical|High|Medium|Low|Info",
          "description": "Evidence-backed detail",
          "recommendation": "Specific fix"
        }
      ]
    }
  ],
  "action_plan": {
    "phases": [
      {"name": "Phase 1: Critical Fixes", "timeframe": "Week 1", "items": []},
      {"name": "Phase 2: High-Impact Improvements", "timeframe": "Weeks 2-3", "items": []},
      {"name": "Phase 3: Content & Authority", "timeframe": "Month 2", "items": []},
      {"name": "Phase 4: Monitoring & Iteration", "timeframe": "Ongoing", "items": []}
    ]
  },
  "artifacts": {
    "findings_dir": "findings/",
    "screenshots_dir": "screenshots/"
  }
}

評分權重

類別	權重
技術 SEO	22%
內容品質	23%
頁面 SEO	20%
Schema / 結構化資料	10%
效能（CWV）	10%
AI 搜尋準備度	10%
圖片	5%

報告結構

摘要

• 整體 SEO 健康分數（0-100）
• 偵測到的商業類型
• 前 5 大嚴重問題
• 前 5 大速贏項目

技術 SEO

• 可爬取性問題
• 可索引性問題
• 安全疑慮
• Core Web Vitals 狀態

內容品質

• E-E-A-T 評估
• 內容貧乏頁面
• 重複內容問題
• 可讀性分數

頁面 SEO

• 標題標籤問題
• Meta 描述問題
• 標題結構
• 內部連結缺口

Schema 與結構化資料

• 目前實作
• 驗證錯誤
• 遺漏機會

效能

• LCP、INP、CLS 分數
• 資源最佳化需求
• 第三方腳本影響

圖片

• 缺少替代文字
• 圖片過大
• 格式建議

AI 搜尋準備度

• 可引用性分數
• 結構改善
• 權威訊號

優先順序定義

• 嚴重：阻礙索引或導致懲罰（立即修復）
• 高：顯著影響排名（一週內修復）
• 中：最佳化機會（一個月內修復）
• 低：可有可無（待辦事項）

DataForSEO 整合（選用）

若 DataForSEO MCP 工具可用，則啟動 seo-dataforseo 代理程式與現有子代理程式並行，以即時資料豐富稽核：真實 SERP 排名、含垃圾分數的反向連結資料、頁面分析（Lighthouse）、商家列表及 AI 可見度檢查（ChatGPT 爬蟲、LLM 提及）。

Google API 整合（選用）

若已設定 Google API 憑證（claude-seo run google_auth.py --check），則啟動 seo-google 代理程式，以真實 Google 實測資料豐富稽核：CrUX Core Web Vitals（取代僅實驗室估計）、GSC URL 索引狀態、搜尋成效（點擊、曝光、點擊率）及 GA4 自然流量趨勢。效能（CWV）類別分數最受益於實測資料。

錯誤處理

情境	動作
URL 無法連線（DNS 失敗、連線被拒）	清楚回報錯誤。不要猜測網站內容。建議使用者確認 URL 後重試。
robots.txt 封鎖爬取	回報哪些路徑被封鎖。僅分析可存取頁面，並在報告中註明限制。
速率限制（429 回應）	退避並減少並行請求。回報部分結果，並註明哪些部分無法完成。
大型網站逾時（500 頁以上）	在逾時限制內停止爬取。回報已爬取頁面的發現，並估計網站整體規模。