網站稽核技能
使用 squirrelscan CLI 對網站進行 SEO、技術、內容、效能與安全稽核。
squirrelscan 提供 CLI 工具 squirrel,支援 macOS、Windows 和 Linux。它透過模擬瀏覽器、搜尋爬蟲,並根據超過 230 條規則分析網站的結構和內容,進行全面的網站稽核。
它會列出所有問題以及修復建議。
連結
- squirrelscan 網站位於 https://squirrelscan.com
- 文件(包含規則參考)位於 docs.squirrelscan.com
你可以使用下列範本查詢任何規則的文件:
https://docs.squirrelscan.com/rules/{rule_category}/{rule_id}
範例:
https://docs.squirrelscan.com/rules/links/external-links
此技能的作用
此技能讓 AI 代理能夠根據超過 230 條規則(涵蓋 21 個類別)稽核網站,包括:
- SEO 問題:Meta 標籤、標題、描述、標準網址、Open Graph 標籤
- 技術問題:損毀連結、重新導向鏈、頁面速度、行動裝置友善度
- 效能:頁面載入時間、資源使用、快取
- 內容品質:標題結構、圖片替代文字、內容分析
- 安全性:外洩機密、HTTPS 使用、安全標頭、混合內容
- 無障礙:替代文字、色彩對比、鍵盤導航
- 可用性:表單驗證、錯誤處理、使用者流程
- 連結:檢查內部和外部的損毀連結
- E-E-A-T:專業性、經驗、權威性、可信度
- 使用者體驗:使用者流程、錯誤處理、表單驗證
- 行動裝置:檢查行動裝置友善度、響應式設計、觸控友善元素
- 可爬性:檢查可爬性、robots.txt、sitemap.xml 等
- 結構化資料:Schema.org 標記、結構化資料、豐富摘要
- 法律:法律要求合規性、隱私權政策、服務條款
- 社交:Open Graph、Twitter 卡片以及驗證結構、摘要等
- 網址結構:長度、連字號、關鍵字
- 關鍵字:關鍵字堆砌
- 內容:內容結構、標題
- 圖片:替代文字、色彩對比、圖片大小、圖片格式
- 在地 SEO:NAP 一致性、地理元資料
- 影片:VideoObject 結構、無障礙
以及更多
稽核會爬取網站,根據稽核規則分析每個頁面,並回傳一份綜合報告,包含:
- 整體健康分數(0-100)
- 類別細項(核心 SEO、技術 SEO、內容、安全性)
- 具體問題及受影響的網址
- 損毀連結偵測
- 可行的建議
- 規則的層級有 error、warning 和 notice,同時也有 1 到 10 的等級
使用時機
當你需要以下項目時,請使用此技能:
- 分析網站健康狀態
- 除錯技術 SEO 問題
- 修復上述所有問題
- 檢查損毀連結
- 驗證 Meta 標籤和結構化資料
- 產生網站稽核報告
- 比較變更前後的網站健康狀態
- 改善網站效能、無障礙、SEO、安全性等
你應盡可能頻繁地重新進行稽核,以確保網站保持健康且效能良好。
先決條件
此技能需要 squirrel CLI 已安裝並在 PATH 中。
驗證:
squirrel --version
設定
執行 squirrel init 在目前目錄中建立 squirrel.toml 設定檔。如果沒有,請建立一個並指定專案名稱:
squirrel init -n my-project
# 覆寫現有設定
squirrel init -n my-project --force
使用方式
簡介
有三個程序可以執行,它們都會快取在本機專案資料庫中:
- crawl - 執行爬取或重新整理、繼續爬取的子命令
- analyze - 分析爬取結果的子命令
- report - 以所需格式(llm、text、console、html 等)產生報告的子命令
audit 命令是這三個程序的包裝器,會依序執行:
squirrel audit https://example.com --format llm
你應該始終優先使用 llm 格式選項——它是專為你設計的,提供詳盡且精簡的輸出格式。
首次掃描應為表面掃描,快速且淺層地收集網站的基本資訊,例如結構、內容和技術棧。此掃描可以快速完成,且不會影響網站效能。
第二次掃描應為深度掃描,徹底且詳細地收集網站更多資訊,例如安全性、效能和無障礙。此掃描可能需要較長時間,並可能影響網站效能。
如果使用者未提供要稽核的網站,請詢問他們想要稽核哪個網址。
你應偏好稽核線上網站——只有這樣才能獲得網站的真實表現、效能或渲染問題。
如果你同時有本機和線上網站要稽核,提示使用者選擇要稽核哪一個,並建議他們選擇線上網站。
你可以將稽核報告中的修復套用至線上網站對應的本機程式碼。
規劃工作範圍時,讓子代理可以並行執行以加速修復。
實作修復時,利用子代理來加速實作。
套用修復後,驗證程式碼仍然可以建置,並通過專案中所有既有檢查。
基本工作流程
稽核流程分為兩個步驟:
- 執行稽核(儲存至資料庫,顯示主控台輸出)
- 以所需格式匯出報告
# 步驟 1:執行稽核(預設:主控台輸出)
squirrel audit https://example.com
# 步驟 2:以 LLM 格式匯出
squirrel report <audit-id> --format llm
回歸差異
當你需要偵測稽核之間的回歸時,請使用差異模式:
# 將目前報告與基準稽核 ID 比較
squirrel report --diff <audit-id> --format llm
# 將最新網域報告與基準網域比較
squirrel report --regression-since example.com --format llm
差異模式支援 console、text、json、llm 和 markdown。不支援 html 和 xml。
執行稽核
執行稽核時:
- 呈現報告 – 向使用者顯示稽核結果和分數
- 提出修復 – 列出你可以修復的問題,並要求使用者在進行變更前確認
- 並行處理已批准的修復 – 使用子代理進行大量內容編輯(替代文字、標題、描述)
- 疊代 – 修復一批 → 重新稽核 → 呈現結果 → 提出下一批
- 暫停判斷 – 損毀連結、結構變更和任何模糊不清的問題應標記給使用者審閱
- 顯示前後對比 – 在每次修復批次後呈現分數比較
-
疊代迴圈:修復一批問題後,重新稽核並繼續修復,直到:
- 分數達到目標(通常 85 分以上),或
- 僅剩需要人為判斷的問題(例如「此連結是否應移除?」)
-
平等對待所有修復:程式碼變更和內容變更同等重要。
-
並行處理內容修復:對於影響多個檔案的問題:
- 派生子代理同時修復
- 範例:7 個檔案需要替代文字 → 派 1-2 個代理修復所有
- 範例:30 個檔案有標題問題 → 派代理批次編輯
-
完成標準:
- ✅ 所有錯誤已修復
- ✅ 所有警告已修復(或記錄為需人為審閱)
- ✅ 重新稽核查證改善
- ✅ 向前後對比給使用者
修復完成後,詢問使用者是否想要檢閱變更。
分數目標
| 起始分數 | 目標分數 | 預期工作 |
|---|---|---|
| < 50 (F 級) | 75+ (C 級) | 主要修復 |
| 50-70 (D 級) | 85+ (B 級) | 中等修復 |
| 70-85 (C 級) | 90+ (A 級) | 微調 |
| > 85 (B+ 級) | 95+ | 精修 |
只有當分數超過 95(A 級)且覆蓋率設為 FULL(--coverage full)時,網站才算完成且修復。
問題類別
| 類別 | 修復方法 | 可並行處理 |
|---|---|---|
| Meta 標籤/標題 | 編輯頁面元件或元資料 | 否 |
| 結構化資料 | 在頁面範本中加入 JSON-LD | 否 |
| 缺少 H1/標題 | 編輯頁面元件 + 內容檔案 | 是(內容) |
| 圖片替代文字 | 編輯內容檔案 | 是 |
| 標題層級 | 編輯內容檔案 | 是 |
| 描述過短 | 編輯內容 frontmatter | 是 |
| HTTP→HTTPS 連結 | 在內容中尋找並取代 | 是 |
| 損毀連結 | 手動審閱(標記給使用者) | 否 |
對於可並行處理的修復:派分子代理,並指定特定檔案給它們。
內容檔案修復
許多問題需要編輯內容檔案。這些與程式碼修復同等重要:
- 圖片替代文字:為圖片加入描述性替代文字
- 標題層級:修復跳過的標題層級
- Meta 描述:延長 frontmatter 中的簡短描述
- HTTP 連結:將不安全的連結更新為 HTTPS
使用子代理並行處理修復
當使用者批准一批修復時,你可以使用子代理並行套用:
- 先詢問使用者 – 在派分子代理之前,務必確認要套用哪些修復
- 對相同修復類型,將 3-5 個檔案分組給一個子代理
- 僅並行處理獨立檔案(無共享元件或設定)
- 在單一訊息中派發多個子代理以並行執行
進階選項
稽核更多頁面:
squirrel audit https://example.com --max-pages 200
強制重新爬取(忽略快取):
squirrel audit https://example.com --refresh
繼續中斷的爬取:
squirrel audit https://example.com --resume
用於除錯的詳細輸出:
squirrel audit https://example.com --verbose
常用選項
稽核命令選項
| 選項 | 別名 | 說明 | 預設值 |
|---|---|---|---|
--format <fmt> | -f <fmt> | 輸出格式:console, text, json, html, markdown, llm | console |
--coverage <mode> | -C <mode> | 覆蓋率模式:quick, surface, full | surface |
--max-pages <n> | -m <n> | 要爬取的最大頁數(上限 5000) | 依覆蓋率而異 |
--output <path> | -o <path> | 輸出路徑 | - |
--refresh | -r | 忽略快取,完全重新取得所有頁面 | false |
--resume | - | 繼續中斷的爬取 | false |
--verbose | -v | 詳細輸出 | false |
--debug | - | 除錯記錄 | false |
--trace | - | 啟用效能追蹤 | false |
--project-name <name> | -n <name> | 覆寫專案名稱 | 來自設定檔 |
覆蓋率模式
根據稽核需求選擇覆蓋率模式:
| 模式 | 預設頁數 | 行為 | 使用時機 |
|---|---|---|---|
quick | 25 | 僅種子 + Sitemap,不進行連結探索 | CI 檢查、快速健康檢查 |
surface | 100 | 每個網址模式取一個樣本 | 一般稽核(預設) |
full | 500 | 爬取所有內容,直到上限 | 深度分析 |
Surface 模式很聰明 – 它會偵測 URL 模式(例如 /blog/{slug} 或 /products/{id}),並僅爬取每個模式的一個樣本。這對於具有大量相似頁面的網站(部落格、電子商務)非常有效率。
# 快速健康檢查(25 頁,無連結探索)
squirrel audit https://example.com -C quick --format llm
# 預設表面稽核(100 頁,模式取樣)
squirrel audit https://example.com --format llm
# 完整全面稽核(500 頁)
squirrel audit https://example.com -C full --format llm
# 覆寫任何模式的頁面限制
squirrel audit https://example.com -C surface -m 200 --format llm
何時使用哪種模式:
quick:CI 管線、每日健康檢查、監控surface:大多數稽核 – 有效涵蓋獨特範本full:上線前、全面分析、深入探討
報告命令選項
| 選項 | 別名 | 說明 |
|---|---|---|
--list | -l | 列出最近的稽核 |
--severity <level> | - | 依嚴重性篩選:error, warning, all |
--category <cats> | - | 依類別篩選(逗號分隔) |
--format <fmt> | -f <fmt> | 輸出格式:console, text, json, html, markdown, xml, llm |
--output <path> | -o <path> | 輸出路徑 |
--input <path> | -i <path> | 從 JSON 檔案載入(備用模式) |
設定子命令
| 命令 | 說明 |
|---|---|
config show | 顯示目前設定 |
config set <key> <value> | 設定設定值 |
config path | 顯示設定檔路徑 |
config validate | 驗證設定檔 |
其他命令
| 命令 | 說明 |
|---|---|
squirrel feedback | 向 squirrelscan 團隊傳送意見回饋 |
squirrel skills install | 安裝 Claude Code 技能 |
squirrel skills update | 更新 Claude Code 技能 |
自身命令
self 下的自我管理命令:
| 命令 | 說明 |
|---|---|
self install | 引導本機安裝 |
self update | 檢查並套用更新 |
self completion | 產生 Shell 自動補全 |
self doctor | 執行健康檢查 |
self version | 顯示版本資訊 |
self settings | 管理 CLI 設定 |
self uninstall | 從系統中移除 squirrel |
輸出格式
主控台輸出(預設)
audit 命令預設顯示人類可讀的主控台輸出,包含彩色輸出和進度指示器。
LLM 格式
若要取得 LLM 最佳化的輸出,請使用 report 命令搭配 --format llm:
squirrel report <audit-id> --format llm
LLM 格式是精簡的 XML/文字混合格式,針對 Token 效率進行最佳化(比冗長的 XML 小 40%):
- 摘要:整體健康分數和關鍵指標
- 依類別分類的問題:按稽核規則類別分組(核心 SEO、技術、內容、安全性)
- 損毀連結:損毀連結清單