Communitygithub.com

AndresOrozcoDev/website

使用 SEOmator CLI 對網站進行 SEO、技術、內容、安全性、JS 渲染以及 AI 就緒度審計。回傳經 LLM 優化的報告,包含 251 條規則與 20 個類別的健康評分。適用於分析網站、除錯 SEO 問題或檢查網站健康狀態。

website 是什麼?

這個 SEO 審計技能可讓 AI 代理使用 SEOmator CLI 對網站進行全面分析。它能針對 20 個類別的 251 條規則進行審計,包含核心 SEO、效能、安全性、JavaScript 渲染、無障礙性、結構化資料以及 AI/GEO 就緒度等。支援 llm、json、html、markdown 與 console 等多種輸出格式,其中 `--format llm` 專為 AI 代理設計,能產生節省 50-70% token 的 XML 輸出。審計結果會提供整體健康分數(0-100 分,附帶 A-F 等級)、各類別的通過/警告/失敗統計,以及包含受影響 URL 的具體問題清單與可行的修復建議。此技能適合在 Claude Code、Cursor 等 AI 編碼工具中使用,並可透過 `--crawl` 參數進行多頁面爬取,或使用 `-c` 參數指定特定類別進行聚焦審計。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AndresOrozcoDev/website/tree/HEAD/.agents/skills/seo-audit

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

SEO 審計技能

使用 SEOmator CLI 對網站進行 SEO、技術、內容、效能、安全性、JavaScript 渲染以及 AI 就緒度審計。

SEOmator 透過分析網站結構和內容,依據 251 條規則 在 20 個類別 中進行全面網站審計。

它會提供一份含嚴重性等級、受影響 URL 以及可行修復建議的問題清單。

連結

此技能的功能

此技能讓 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%)。

審計時:

  1. 偏好即時網站而非本地開發伺服器,以獲得準確的效能與渲染資料
  2. 使用 --no-cwv 加速審計,當不需要 Core Web Vitals 與 JS 渲染檢查時
  3. 將修復範圍規劃為並行任務,當實施多個修復時
  4. 在實施修復後執行型別檢查/格式化(tsc、eslint、prettier 等)

網站發現

如果使用者未提供要審計的網站:

  1. 檢查本地開發伺服器設定(package.json scripts、.env 檔案)
  2. 尋找 Vercel/Netlify 專案連結
  3. 檢查環境變數中的部署 URL
  4. 詢問使用者要審計哪個 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、llmconsole
--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儲存至 ~/.seomatorfalse

其他命令

seomator init              # 建立設定檔
seomator self doctor       # 檢查系統設定
seomator config --list     # 顯示所有設定值
seomator report --list     # 列出先前的報告
seomator db stats          # 顯示資料庫統計

輸出格式

格式標誌最佳用途
console--format console人類終端機輸出(預設)
json--format jsonCI/CD、程式化處理
html--format html獨立報告、分享
markdown--format markdown文件、GitHub
llm--format llmAI 代理(建議)

--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-100A優異 — 僅需微調最佳化
80-89B良好 — 處理警告
70-79C需要改進 — 需優先修復
50-69D差 — 多個關鍵問題
0-49F嚴重 — 需要解決重大問題

優先順序(依類別權重)

為了獲得最大影響,請依此順序修復問題:

  1. 核心(12%)— Meta 標籤、標準網址、H1、索引
  2. 效能(12%)— Core Web Vitals + 最佳化
  3. 連結(8%)— 內部連結結構
  4. 圖片(8%)— 效能 + 無障礙性
  5. 安全性(8%)— 信任訊號、SSL
  6. 技術 SEO(7%)— 爬取基礎
  7. 可爬取性(5%)— 可索引性、分頁
  8. 結構化資料(5%)— 豐富摘要
  9. JavaScript 渲染(5%)— 渲染 DOM、SSR
  10. 內容(5%)— 文字品質 + 重複
  11. 無障礙性(4%)— WCAG 合規
  12. 社交(3%)— 社交分享
  13. E-E-A-T(3%)— 信任、專業
  14. URL 結構(3%)— URL 衛生
  15. 重新導向(3%)— 重新導向鏈
  16. 行動裝置(2%)— 視口、字型
  17. 國際化(2%)— Hreflang
  18. HTML 驗證(2%)— 文件結構
  19. AI/GEO 就緒度(2%)— 語意 HTML、AI 機器人
  20. 法律遵循(1%)— Cookie 同意

依嚴重性修復

  1. 失敗(狀態:「fail」)— 必須立即修復
  2. 警告(狀態:「warn」)— 應盡快修復
  3. 通過(狀態:「pass」)— 無需處理

輸出摘要

實施修復後,向使用者總結所有進行的變更。

規劃範圍時,請組織任務使其能夠以子代理並行執行,以加速實作。

疑難排解

seomator 命令找不到

如果看到此錯誤,表示 seomator 未安裝或不在 PATH 中。

解決方法:

npm install -g @seomator/seo-audit

Core Web Vitals 未測量

如果缺少 CWV 指標,可能是 Chrome/Chromium 不可用。

解決方法:

  1. 安裝 Chrome、Chromium 或 Edge
  2. 執行 seomator self doctor 以驗證瀏覽器偵測
  3. 如果不需要 CWV,請使用 --no-cwv 跳過

爬取超時或效能緩慢

對於大型網站,審計可能需要幾分鐘。

解決方法:

  • 使用 --verbose 查看進度
  • 使用 -m 20 限制頁面數量以加快結果
  • 使用 --no-cwv 跳過基於瀏覽器的測量

無效的 URL

確保 URL 包含通訊協定:

# 錯誤
seomator audit example.com

# 正確
seomator audit https://example.com

運作方式

  1. 擷取:下載頁面 HTML 並測量回應時間
  2. 解析:提取 DOM、meta 標籤、連結、圖片、結構化資料
  3. 豐富化:每次審計擷取一次 robots.txt 和 sitemap
  4. 渲染(如果啟用 CWV):透過 Playwright 擷取渲染 DOM 以進行 JS 渲染分析
  5. 爬取(如果啟用):發現並擷取連結的頁面
  6. 分析:對每個頁面執行 251 條審計規則
  7. 評分:計算類別與整體加權分數
  8. 報告:以要求的格式產生輸出

結果儲存在 ~/.seomator/ 中,可透過 seomator report 稍後擷取。

資源

  • 完整規則參考:請參閱 docs/SEO-AUDIT-RULES.md 了解所有 251 條規則
  • 儲存架構:請參閱 docs/STORAGE-ARCHITECTURE.md 了解資料庫詳細資訊
  • CLI 幫助:seomator --help 與 seomator <command> --help

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

AndresOrozcoDev/website

Frontend design skill that generates, restyles, and guides UI development in mager's signature aesthetic — hot, sleek, sexy, usable, fun, and addictive interfaces with dark-first themes, terminal-inspired typography, neon accents, and visual discovery patterns. Use this skill when building or reviewing any frontend UI.

AndresOrozcoDev/website

Generate beautiful, production-ready, animated single-file HTML landing pages. Use this skill whenever the user asks to create a landing page, marketing page, product page, startup homepage, SaaS landing, app launch page, waitlist page, or any promotional single-page site. Also trigger when user says "make a landing for...", "generate landing page", "build me a homepage", "create a product page", "landing page for my startup", or asks to improve/redesign an existing landing page. Covers both "from scratch" generation and "improve/convert" workflows. Outputs one self-contained HTML file with Tailwind CSS, vanilla JS animations, responsive design, dark/light mode, and curated visual style presets. Always use this skill even for simple landing requests — it ensures premium, non-generic output.

AndresOrozcoDev/website

This skill should be used when the user asks to "write SEO content", "create a blog post", "write an article", "content writing for SEO", "draft optimized content", "write a how-to guide", "create a product description", "write a landing page", "SEO copywriting", "draft content targeting [keyword]", or "write 2000-word article about [topic]". Creates keyword-optimized content using a 12-step workflow: CORE-EEAT pre-write checklist, keyword integration, title optimization (5 formula options), meta description, H1/H2/H3 hierarchy, featured snippet targeting, internal/external linking, and readability enhancement. Produces full drafts with embedded SEO elements, title variants, meta description, FAQ section with schema, and a self-scored CORE-EEAT checklist. For AI-citation optimization, see geo-content-optimizer. For updating existing content, see content-refresher.

相關技能