SEO 審計技能
使用 SEOmator CLI 對網站進行 SEO、技術、內容、效能、安全性、JavaScript 渲染以及 AI 就緒度審計。
SEOmator 透過分析網站結構和內容,依據 251 條規則 在 20 個類別 中進行全面網站審計。
它會提供一份含嚴重性等級、受影響 URL 以及可行修復建議的問題清單。
連結
- SEOmator npm 套件:npmjs.com/package/@seomator/seo-audit
- GitHub 儲存庫:github.com/seo-skills/seo-audit-skill
- Web 介面:seomator.com/free-seo-audit-tool
此技能的功能
此技能讓 AI 代理能夠依據 20 個類別 的 251 條規則 來審計網站,包括:
- 核心 SEO(19 條規則):標準網址、索引指令、標題唯一性、標準網址衝突/迴圈
- 效能(22 條規則):LCP、CLS、FCP、TTFB、INP、壓縮、快取、最小化、HTTP/2
- 連結(19 條規則):損毀連結、重新導向鏈、錨點文字、孤兒頁面、localhost/片段連結
- 圖片(14 條規則):替代文字、尺寸、延遲載入、現代格式、替代文字長度、背景圖片
- 安全性(16 條規則):HTTPS、HSTS、CSP、外部連結安全性、洩漏的密碼、SSL 到期/通訊協定
- 技術 SEO(13 條規則):robots.txt、sitemap.xml、URL 結構、404 頁面、軟 404、錯誤代碼
- 可爬取性(18 條規則):Sitemap 衝突、可索引性訊號、標準網址鏈、分頁問題
- 結構化資料(13 條規則):Schema.org 標記、文章、組織、常見問題、產品、麵包屑
- JavaScript 渲染(13 條規則):渲染 DOM 檢查、原始 vs 渲染不匹配、SSR 偵測
- 無障礙性(12 條規則):ARIA 標籤、色彩對比、表單標籤、地標、觸控目標
- 內容(17 條規則):字數、可讀性、關鍵字密度、重複偵測、像素寬度
- 社交(9 條規則):Open Graph 標籤、Twitter 卡片、分享按鈕、個人檔案連結
- E-E-A-T(14 條規則):作者署名、引用、信任訊號、關於/聯絡頁面、YMYL 偵測
- URL 結構(14 條規則):關鍵字 slug、停用詞、大寫、底線、session ID、追蹤參數
- 重新導向(8 條規則):重新導向迴圈、類型(301/302)、meta refresh、JavaScript 重新導向、損毀的重新導向
- 行動裝置(5 條規則):字型大小、水平捲動、侵入性插頁廣告、視口問題
- 國際化(10 條規則):lang 屬性、hreflang 驗證(返回連結、衝突、不匹配)
- HTML 驗證(9 條規則):DOCTYPE、字元集、head 結構、lorem ipsum、多個標題/描述
- AI/GEO 就緒度(5 條規則):語意 HTML、AI 機器人存取、llms.txt、Schema 漂移
- 法律遵循(1 條規則):Cookie 同意
審計會爬取網站,根據審計規則分析每個頁面,並回傳一份全面的報告,其中包含:
- 整體健康分數(0-100)附字母等級(A-F)
- 各類別的通過/警告/失敗統計
- 依規則分組的特定問題與受影響 URL
- 可行的修復建議
何時使用
在需要以下情況時使用此技能:
- 分析網站的 SEO 健康狀態
- 除錯技術 SEO 問題
- 檢查損毀連結與重新導向鏈
- 驗證 meta 標籤、標準網址與結構化資料
- 審計安全性標頭、SSL 與 HTTPS
- 檢查無障礙性合規
- 分析 JavaScript 渲染與 SSR 相容性
- 評估 AI/GEO 就緒度(語意 HTML、llms.txt、機器人存取)
- 偵測跨頁面的重複內容
- 驗證 hreflang 與國際化設定
- 檢查 HTML 文件結構與驗證
- 以多種格式產生網站審計報告
- 比較變更前後的網站健康狀態
先決條件
此技能需要安裝 SEOmator CLI。
安裝
npm install -g @seomator/seo-audit
驗證安裝
檢查 seomator 是否已安裝且系統已準備就緒:
seomator self doctor
此命令會檢查:
- Node.js 版本(建議 18+)
- npm 可用性
- 用於 Core Web Vitals 與 JS 渲染的 Chrome/Chromium
- ~/.seomator 的寫入權限
- 本地設定檔是否存在
設定
執行 seomator init 會在目前目錄中建立 seomator.toml 設定檔。
seomator init # 互動式設定
seomator init -y # 使用預設值
seomator init --preset blog # 部落格最佳化設定
seomator init --preset ecommerce # 電子商務設定
seomator init --preset ci # 最小 CI 設定
如果目錄中沒有 seomator.toml,請在執行審計前先用 seomator init 建立一個。
用法
AI 代理最佳實務
你應該始終優先使用 --format llm — 它會提供專為 AI 代理設計的 token 最佳化 XML 輸出(比 JSON 小 50-70%)。
審計時:
- 偏好即時網站而非本地開發伺服器,以獲得準確的效能與渲染資料
- 使用
--no-cwv加速審計,當不需要 Core Web Vitals 與 JS 渲染檢查時 - 將修復範圍規劃為並行任務,當實施多個修復時
- 在實施修復後執行型別檢查/格式化(tsc、eslint、prettier 等)
網站發現
如果使用者未提供要審計的網站:
- 檢查本地開發伺服器設定(package.json scripts、.env 檔案)
- 尋找 Vercel/Netlify 專案連結
- 檢查環境變數中的部署 URL
- 詢問使用者要審計哪個 URL
如果同時擁有本地與即時網站,建議審計即時網站以獲得準確結果。
基本工作流程
# 快速單頁審計,使用 LLM 輸出
seomator audit https://example.com --format llm --no-cwv
# 多頁爬取(最多 50 頁)
seomator audit https://example.com --crawl -m 50 --format llm --no-cwv
# 完整審計,包含 Core Web Vitals + JS 渲染分析
seomator audit https://example.com --crawl -m 20 --format llm
進階選項
強制重新爬取(忽略快取):
seomator audit https://example.com --refresh --format llm
恢復中斷的爬取:
seomator audit https://example.com --resume --format llm
僅審計特定類別:
seomator audit https://example.com -c core,security,js --format llm --no-cwv
儲存 HTML 報告以供分享:
seomator audit https://example.com --format html -o report.html
用於除錯的詳細輸出:
seomator audit https://example.com --format llm -v
命令參考
審計命令選項
| 選項 | 別名 | 說明 | 預設值 |
|---|---|---|---|
--format <fmt> | -f | 輸出格式:console、json、html、markdown、llm | console |
--max-pages <n> | -m | 要爬取的最大頁數 | 10 |
--crawl | 啟用多頁爬取 | false | |
--categories <list> | -c | 要審計的類別(逗號分隔) | 全部 |
--refresh | -r | 忽略快取,重新取得 | false |
--resume | 恢復中斷的爬取 | false | |
--no-cwv | 跳過 Core Web Vitals + JS 渲染 | false | |
--verbose | -v | 顯示進度 | false |
--output <path> | -o | 輸出檔案路徑 | |
--config <path> | 設定檔路徑 | ||
--save | 儲存至 ~/.seomator | false |
其他命令
seomator init # 建立設定檔
seomator self doctor # 檢查系統設定
seomator config --list # 顯示所有設定值
seomator report --list # 列出先前的報告
seomator db stats # 顯示資料庫統計
輸出格式
| 格式 | 標誌 | 最佳用途 |
|---|---|---|
| console | --format console | 人類終端機輸出(預設) |
| json | --format json | CI/CD、程式化處理 |
| html | --format html | 獨立報告、分享 |
| markdown | --format markdown | 文件、GitHub |
| llm | --format llm | AI 代理(建議) |
--format llm 輸出是一種緊湊的 XML 格式,針對 token 效率進行了最佳化:
- 比 JSON 輸出小 50-70%
- 問題按嚴重性排序(關鍵優先)
- 每個問題包含修復建議
- 乾淨的標準輸出,便於傳遞給 AI 工具
範例
範例 1:使用 LLM 輸出的快速審計
# 使用者詢問:「檢查 example.com 的 SEO 問題」
seomator audit https://example.com --format llm --no-cwv
範例 2:大型網站的深度爬取
# 使用者詢問:「進行徹底審計,最多 100 頁」
seomator audit https://example.com --crawl -m 100 --format llm --no-cwv
範例 3:變更後的重新審計
# 使用者詢問:「重新審計網站,忽略快取結果」
seomator audit https://example.com --refresh --format llm --no-cwv
範例 4:產生可分享的報告
# 使用者詢問:「建立一個我可以分享的 HTML 報告」
seomator audit https://example.com --crawl -m 20 --format html -o seo-report.html
範例 5:專注於特定領域
# 使用者詢問:「只要檢查我的 JavaScript 渲染與重新導向」
seomator audit https://example.com -c js,redirect --format llm
評估結果
分數範圍
| 分數 | 等級 | 意義 |
|---|---|---|
| 90-100 | A | 優異 — 僅需微調最佳化 |
| 80-89 | B | 良好 — 處理警告 |
| 70-79 | C | 需要改進 — 需優先修復 |
| 50-69 | D | 差 — 多個關鍵問題 |
| 0-49 | F | 嚴重 — 需要解決重大問題 |
優先順序(依類別權重)
為了獲得最大影響,請依此順序修復問題:
- 核心(12%)— Meta 標籤、標準網址、H1、索引
- 效能(12%)— Core Web Vitals + 最佳化
- 連結(8%)— 內部連結結構
- 圖片(8%)— 效能 + 無障礙性
- 安全性(8%)— 信任訊號、SSL
- 技術 SEO(7%)— 爬取基礎
- 可爬取性(5%)— 可索引性、分頁
- 結構化資料(5%)— 豐富摘要
- JavaScript 渲染(5%)— 渲染 DOM、SSR
- 內容(5%)— 文字品質 + 重複
- 無障礙性(4%)— WCAG 合規
- 社交(3%)— 社交分享
- E-E-A-T(3%)— 信任、專業
- URL 結構(3%)— URL 衛生
- 重新導向(3%)— 重新導向鏈
- 行動裝置(2%)— 視口、字型
- 國際化(2%)— Hreflang
- HTML 驗證(2%)— 文件結構
- AI/GEO 就緒度(2%)— 語意 HTML、AI 機器人
- 法律遵循(1%)— Cookie 同意
依嚴重性修復
- 失敗(狀態:「fail」)— 必須立即修復
- 警告(狀態:「warn」)— 應盡快修復
- 通過(狀態:「pass」)— 無需處理
輸出摘要
實施修復後,向使用者總結所有進行的變更。
規劃範圍時,請組織任務使其能夠以子代理並行執行,以加速實作。
疑難排解
seomator 命令找不到
如果看到此錯誤,表示 seomator 未安裝或不在 PATH 中。
解決方法:
npm install -g @seomator/seo-audit
Core Web Vitals 未測量
如果缺少 CWV 指標,可能是 Chrome/Chromium 不可用。
解決方法:
- 安裝 Chrome、Chromium 或 Edge
- 執行
seomator self doctor以驗證瀏覽器偵測 - 如果不需要 CWV,請使用
--no-cwv跳過
爬取超時或效能緩慢
對於大型網站,審計可能需要幾分鐘。
解決方法:
- 使用
--verbose查看進度 - 使用
-m 20限制頁面數量以加快結果 - 使用
--no-cwv跳過基於瀏覽器的測量
無效的 URL
確保 URL 包含通訊協定:
# 錯誤
seomator audit example.com
# 正確
seomator audit https://example.com
運作方式
- 擷取:下載頁面 HTML 並測量回應時間
- 解析:提取 DOM、meta 標籤、連結、圖片、結構化資料
- 豐富化:每次審計擷取一次 robots.txt 和 sitemap
- 渲染(如果啟用 CWV):透過 Playwright 擷取渲染 DOM 以進行 JS 渲染分析
- 爬取(如果啟用):發現並擷取連結的頁面
- 分析:對每個頁面執行 251 條審計規則
- 評分:計算類別與整體加權分數
- 報告:以要求的格式產生輸出
結果儲存在 ~/.seomator/ 中,可透過 seomator report 稍後擷取。
資源
- 完整規則參考:請參閱
docs/SEO-AUDIT-RULES.md了解所有 251 條規則 - 儲存架構:請參閱
docs/STORAGE-ARCHITECTURE.md了解資料庫詳細資訊 - CLI 幫助:
seomator --help與seomator <command> --help