audit-website

網站稽核技能

使用 squirrelscan CLI 稽核網站的 SEO、技術、內容、效能及安全性問題。

squirrelscan 提供 CLI 工具 squirrel，適用於 macOS、Windows 及 Linux。它透過模擬瀏覽器、搜尋爬蟲，並根據 240 多條規則分析網站的結構與內容，進行全面的網站稽核。

它會提供問題清單以及修復建議。

連結

• 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 代理能夠根據 22 個類別共 240 多條規則稽核網站，包括：

• SEO 問題：中繼標籤、標題、描述、標準網址、Open Graph 標籤
• 技術問題：失效連結、重新導向鏈、頁面速度、行動裝置友善性
• 效能：頁面載入時間、資源使用、快取
• 內容品質：標題結構、圖片替代文字、內容分析
• 安全性：外洩機密、HTTPS 使用、安全性標頭、混合內容
• 無障礙性：替代文字、色彩對比、鍵盤導航
• 可用性：表單驗證、錯誤處理、使用者流程
• 連結：檢查內部與外部失效連結
• E-E-A-T：專業度、經驗、權威性、可信度
• 使用者體驗：使用者流程、錯誤處理、表單驗證
• 行動裝置：檢查行動裝置友善性、響應式設計、觸控友善元素
• 可爬性：檢查可爬性、robots.txt、sitemap.xml 等
• 結構化資料：Schema.org 標記、結構化資料、豐富摘要
• 法律：法律要求合規性、隱私政策、服務條款
• 社交：Open Graph、Twitter Cards 及驗證結構、摘要等
• 網址結構：長度、連字號、關鍵字
• 關鍵字：關鍵字堆砌
• 內容：內容結構、標題
• 圖片：替代文字、色彩對比、圖片大小、圖片格式
• 在地 SEO：NAP 一致性、地理中繼資料
• 影片：VideoObject 結構、無障礙性

以及其他更多

稽核會爬取網站，根據稽核規則分析每個頁面，並回傳一份全面的報告，包含：

• 整體健康分數（0-100）
• 類別細項（核心 SEO、技術 SEO、內容、安全性）
• 特定問題及受影響的網址
• 失效連結偵測
• 可行的建議
• 規則分為錯誤、警告及通知等級，並有 1 到 10 的排名

使用時機

當您需要以下情況時使用此技能：

• 分析網站健康狀態
• 除錯技術 SEO 問題
• 修復上述所有問題
• 檢查失效連結
• 驗證中繼標籤與結構化資料
• 產生網站稽核報告
• 比較變更前後的網站健康狀態
• 改善網站效能、無障礙性、SEO、安全性等

您應盡可能頻繁地重新稽核，以確保網站保持健康且效能良好。

先決條件

此技能需要安裝 squirrel CLI 並在 PATH 中。

安裝： squirrelscan.com/download

驗證：

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. 執行稽核（儲存至資料庫，顯示主控台輸出）
2. 以所需格式匯出報告

# 步驟 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。

執行稽核

執行稽核時：

1. 呈現報告 - 向使用者顯示稽核結果與分數
2. 提出修復建議 - 列出您可以修復的問題，並在使用者確認後進行修改
3. 平行處理已批准的修復 - 使用子代理進行大量內容編輯（替代文字、標題、描述）
4. 迭代 - 修復一批 → 重新稽核 → 呈現結果 → 提出下一批
5. 暫停以待判斷 - 失效連結、結構性變更及任何模糊問題應標記為需要使用者審查
6. 顯示前後對比 - 每次修復批次後呈現分數比較

• 迭代迴圈：修復一批問題後，重新稽核並繼續修復，直到：

  • 分數達到目標（通常 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）時，網站才算完成且已修復。

問題類別

類別	修復方式	可平行處理
中繼標籤/標題	編輯頁面元件或中繼資料	否
結構化資料	在頁面範本中新增 JSON-LD	否
缺少 H1/標題	編輯頁面元件 + 內容檔案	是（內容）
圖片替代文字	編輯內容檔案	是
標題層級	編輯內容檔案	是
描述過短	編輯內容 frontmatter	是
HTTP→HTTPS 連結	在內容中尋找並取代	是
失效連結	人工審查（標記給使用者）	否

對於可平行處理的修復：產生子代理並指定特定檔案。

內容檔案修復

許多問題需要編輯內容檔案。這些與程式碼修復同等重要：

• 圖片替代文字：為圖片加入描述性替代文字
• 標題層級：修正跳過的標題層級
• 中繼描述：在 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	僅種子頁面 + 網站地圖，不探索連結	CI 檢查、快速健康檢查
surface	100	每個網址模式取一個樣本	一般稽核（預設）
full	500	爬取所有內容直到上限	深度分析

表面模式很聰明 - 它會偵測網址模式，例如 /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 技能

自我管理命令

squirrel 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、技術、內容、安全性）
• 失效連結：外部與內部失效連結清單
• 建議：優先處理的項目與修復建議

詳細格式說明請參閱 OUTPUT-FORMAT.md。

範例

範例 1：快速網站稽核（LLM 輸出）

# 使用者詢問：「檢查 squirrelscan.com 的 SEO 問題」
squirrel audit https://squirrelscan.com --format llm

範例 2：大型網站的深度稽核

# 使用者詢問：「對我的部落格進行徹底稽核，最多 500 頁」
squirrel audit https://myblog.com --max-pages 500 --format llm

範例 3：變更後重新稽核

# 使用者詢問：「重新稽核網站，忽略快取結果」
squirrel audit https://example.com --refresh --format llm

範例 4：兩步驟工作流程（重複使用先前的稽核）

# 先執行稽核
squirrel audit https://example.com
# 記下輸出中的稽核 ID（例如 "a1b2c3d4"）

# 稍後以不同格式匯出
squirrel report a1b2c3d4 --format llm

輸出

完成時，向使用者提供您所做所有變更的摘要。

疑難排解

squirrel 命令找不到

如果您看到此錯誤，表示 squirrel 未安裝或不在 PATH 中。

解決方法：

1. 安裝 squirrel：squirrelscan.com/download
2. 確保 ~/.local/bin 在 PATH 中
3. 驗證：squirrel --version

權限不足

如果 squirrel 無法執行，請確保二進位檔具有執行權限。從 squirrelscan.com/download 重新安裝即可解決。

爬取逾時或效能緩慢

對於非常大的網站，稽核可能需要幾分鐘。使用 --verbose 查看進度：

squirrel audit https://example.com --format llm --verbose

無效的網址

確保網址包含通訊協定（http:// 或 https://）：

# ✗ 錯誤
squirrel audit example.com

# ✓ 正確
squirrel audit https://example.com

運作原理

1. 爬取：從基礎網址開始探索並取得頁面
2. 分析：對每個頁面執行稽核規則
3. 外部連結：檢查外部連結是否可用
4. 報告：產生針對 LLM 最佳化的報告，包含發現結果

稽核結果儲存在本機資料庫中，之後可使用 squirrel report 命令擷取。

其他資源

• 輸出格式參考：OUTPUT-FORMAT.md
• squirrelscan 文件：https://docs.squirrelscan.com
• CLI 說明：squirrel audit --help