SEO 快速審查 (Lite)
在您提供的本地 HTML 檔案上執行 scripts/audit.mjs,並回報核心頁面 SEO 檢查的通過/警告/失敗狀態。完全離線 — 腳本讀取一個檔案並輸出 JSON。
範圍與規則
- 僅審查使用者提供的檔案。此精簡版不會擷取 URL、robots.txt 或 sitemap.xml — 回報時請說明這一點。
- 通過/失敗是基於常見慣例,而非搜尋引擎的保證。
- 絕不修改檔案。僅限唯讀。
1. 執行
需要 Node 18+,無須任何依賴。
node <skill-dir>/scripts/audit.mjs page.html
結果以 JSON 格式輸出至 stdout;當存在任何警告或失敗時,退出碼為 1(可作為 CI 閘道),讀取或使用錯誤時退出碼為 2。
2. 閱讀報告
summary:通過/警告/失敗/資訊計數。checks[]:{id, status, detail},項目包含:title、meta-description、canonical、robots-meta、viewport、open-graph、h1、img-alt、lang、charset。
3. 修正指引
title/meta-description警告 → 重寫至約 30-65 / 50-160 個字元。robots-meta: noindex出現在預期要排名的頁面上 → 移除該指令。canonical遺失 → 加入<link rel="canonical">。h1失敗 → 每個頁面僅需一個具有描述性的 h1。open-graph警告 → 加入 og:title/og:description/og:image 以獲得連結預覽。
Lite 與完整版
完整的 seo-quick-audit 還會額外擷取即時 URL(包含 /robots.txt 和 /sitemap.xml 狀態)、檢查 twitter-card 以及處理重新導向。