← 回技術文件 ｜ 晶鑫數位科技 3dgowl.com
SEO 工具

Claude SEO 操作手冊：
用 Claude Code 十五分鐘完成一份完整的網站 SEO 健檢

掛在 Claude Code 上的開源 SEO 稽核外掛：25 個子技能、18 個專家 agent 並行執行。含可行性評估、安裝、指令總覽、四層 Google API 憑證設定、報告解讀與疑難排解。

最後更新：2026 年 8 月・適用 Claude SEO v2.2.x
本文依 AgriciDaniel/claude-seo 的官方文件（v2.2.4）整理撰寫，並附採用前的可行性評估。

請 SEO 顧問做一次完整稽核，行情是數萬元起跳、一到三週交件；訂閱商用稽核工具，一個月也要幾十到幾百美元。Claude SEO 走的是第三條路：它是一個掛在 Claude Code 上的開源外掛，把 SEO 稽核拆成 25 個子技能和 18 個專家 agent 並行執行，十到十五分鐘產出一份帶優先順序的行動清單，涵蓋技術 SEO、內容品質（E-E-A-T）、Schema 結構化資料、AI 搜尋優化（GEO）、在地 SEO、電商與多語系。工具本身免費，你只需要原本就有的 Claude Code 訂閱。

可行性評估結論

結論：可行，值得採用 專案成熟度高、維護活躍、方法論嚴謹，對已在使用 Claude Code 的人幾乎沒有額外成本。前提是你必須有 Claude Code（含 Claude 訂閱或 API），這是它唯一的硬性依賴。
評估面向觀察結果
社群與採用GitHub 11.5k 星、1.7k fork，開放 issue 僅 10 個且維護者逐一回應處理
維護狀態更新頻繁：v2.2.4 於 2026 年 7 月發布，評估當週仍有提交，累計 20 個正式版本
品質工程410 個自動化測試，含 91 個 SSRF 安全繞過案例；CI 秘密掃描；有安全政策與隱私文件
授權與成本MIT 開源，無網域數限制、無追蹤；核心功能不需任何第三方 API
內容時效緊跟 Google 官方一手資料：2026 年 5 月核心更新、FAQ rich results 退場、INP 取代 FID、llms.txt 實證立場等都已反映
隱私預設完全在本機執行，稽核資料不上傳任何第三方（只抓取你指定的目標網址）

兩個要在採用前想清楚的點。第一，它是 Claude Code 的外掛，不是獨立軟體：沒有 Claude Code 就完全用不了，跑稽核也會消耗你的 Claude 用量額度。第二，主要維護者只有一人（Daniel Agrici，另有社群貢獻者），雖然目前活躍度很高，長期延續性仍取決於個人投入；好在 MIT 授權下即使停止維護，既有功能照常可用。另外，免費模式下 Core Web Vitals 是實驗室估計值，想要真實的用戶數據和 Search Console 整合，需要免費申請 Google API 憑證（第六節）；競爭對手與外鏈的深度數據則要另外接 Ahrefs、DataForSEO 這類付費服務，屬於選配。

一、Claude SEO 是什麼、怎麼運作

它遵循 Claude Code 的 Agent Skills 標準，本質是一組技能檔加上 Python 腳本。你在 Claude Code 裡輸入 /seo audit 網址，指揮中樞（orchestrator）會先判斷網站的產業型態（SaaS、在地商家、電商、媒體、代理商），然後同時派出最多 15 個專家 agent 分頭稽核，最後把所有發現彙整、評分，輸出成帶優先順序的報告。

/seo audit 網址 你下的一行指令 → 指揮中樞 判斷產業型態 分派稽核任務 → 並行專家 agent（≤15） 技術 SEO・CWV 內容品質 E-E-A-T Schema 結構化資料 AI 搜尋（GEO）… 共 25 個子技能 → 稽核報告 0-100 分＋優先行動清單 Markdown / PDF / JSON
圖 1：一次 /seo audit 的執行流程。並行分工是十五分鐘跑完全站稽核的關鍵（示意圖）

方法論是這個專案最特別的地方。每一條建議都附四個欄位：它依據的第一性觀察、與其他建議的相依關係、一個「怎麼知道這個建議失敗了」的檢驗條件，以及一個領先指標。換句話說，它給的不是「你應該加強內容」這種空話，而是可以被驗證、也可以被推翻的具體主張。對 AI 搜尋的立場也走實證路線：依 Google 官方的 AI 優化指南，把 GEO、AEO 視為 SEO 的重新包裝，並明確指出 llms.txt 目前不是引用來源的影響因素（附一手證據），不跟風炒作。

二、事前需求

項目需求
Claude Code必要。CLI 版本 1.0.33 以上可用外掛安裝；需有 Claude 訂閱或 API 金鑰
Python3.10 以上
作業系統macOS、Linux、Windows（PowerShell）
Playwright Chromium選配。SPA 網站渲染與截圖需要，安裝時會詢問是否一併裝
Google API 憑證選配。解鎖真實 CWV 數據、Search Console、GA4（見第六節）

三、安裝與初始設定

方式 A：外掛安裝（推薦）

在 Claude Code 裡輸入三行，一次搞定：

/plugin marketplace add AgriciDaniel/claude-seo
/plugin install claude-seo@agricidaniel-claude-seo
/seo setup

/seo setup 會在 Claude 的外掛資料目錄裡建立隔離的 Python 環境並安裝 Playwright Chromium，不會動到你系統的全域 Python。裝完隨時可以用 /seo doctor 檢查環境是否就緒。

方式 B：手動安裝

# macOS / Linux
git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
bash claude-seo/install.sh

# Windows（PowerShell）
git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
powershell -ExecutionPolicy Bypass -File claude-seo\install.ps1

官方刻意不提供 irm | iex 這種直接執行遠端腳本的一行安裝，理由是供應鏈安全：先 clone 下來，看過 install 腳本再執行。這個態度值得肯定，也建議你照做。

解除安裝

bash claude-seo/uninstall.sh    # Windows 用 uninstall.ps1

四、快速上手：第一份稽核報告

  1. 啟動 Claude Code：終端機輸入 claude。
  2. 跑一次全站稽核：
    /seo audit https://你的網站.com
    畫面上會看到多個 agent 同時展開工作，一般網站十到十五分鐘完成。
  3. 稽核結束後，報告以 Markdown 檔寫在你的工作目錄（FULL-AUDIT-REPORT.md 等），包含 0 到 100 的總分、依嚴重度排序的發現，以及每條建議的檢驗條件。
  4. 接著挑重點深入。常見的第二步是針對單一頁面：
    /seo page https://你的網站.com/重要頁面
/seo schema https://你的網站.com
/seo geo https://你的網站.com
建議的節奏 第一次先跑 /seo audit 建立全貌，把 critical 等級的項目處理完，隔週用 /seo drift baseline 建立基準快照，之後每週跑 /seo drift compare 看變化。這比每次都跑全站稽核省時間，也更容易在客戶或主管面前說清楚「這週改了什麼、什麼指標動了」。

五、指令總覽

共 32 個 /seo 指令。日常最常用的整理如下，完整清單見官方 COMMANDS.md：

指令用途
/seo setup・/seo doctor建立／檢查執行環境
/seo audit 網址全站稽核，並行 agent 產出優先行動清單
/seo page 網址單頁深度分析：on-page 元素、內容品質、schema
/seo technical 網址技術 SEO 稽核（九大類）
/seo content 網址E-E-A-T 與內容品質分析
/seo content-brief 主題產出內容企劃：目標關鍵字、大綱、內鏈建議
/seo schema 網址偵測、驗證、產生 Schema.org 標記
/seo geo 網址AI 搜尋（AI Overviews）就緒度：段落可引用性評分
/seo sitemap 網址 | generate分析或產生 XML sitemap
/seo images 網址圖片優化分析
/seo local 網址・/seo maps在地 SEO：GBP、NAP 一致性、評論、地圖排名格網
/seo hreflang 網址多語系 hreflang 稽核與產生
/seo ecommerce 網址電商 SEO 與商品 schema 驗證
/seo plan 型態策略規劃（saas、local、ecommerce、publisher、agency）
/seo cluster 關鍵字SERP 語意分群
/seo drift baseline | compare | historySEO 變化監測（SQLite 快照）
/seo google 子指令Google API 整合：GSC、PageSpeed、CrUX、GA4、PDF 報告
/seo backlinks 網址外鏈輪廓分析（Moz、Bing、Common Crawl 免費來源）

六、接上 Google API：四層憑證

不接任何憑證也能用，但 Core Web Vitals 只會是實驗室估計值。官方設計了四層憑證制度，每一層都免費申請（Tier 3 的 Ads token 除外，視帳戶而定），逐層解鎖更真實的數據：

Tier 0：API 金鑰 PageSpeed・CrUX・25 週趨勢 Tier 1：+ OAuth Search Console・Indexing API Tier 2：+ GA4 設定 自然流量・落地頁・裝置分佈 Tier 3：+ Ads token 關鍵字搜尋量與競爭度 每層往上疊加，不用一次到位；多數人做到 Tier 1 就很夠用
圖 2：四層憑證階梯。從零金鑰開始，需要多少數據就申請到哪一層（示意圖）

設定不用自己翻文件，跑內建的精靈即可：

/seo google setup

所有憑證存在本機的 ~/.config/claude-seo/，檔案權限 0600，不會被寫進任何程式碼或報告。接上 Tier 1 之後，/seo google 可以直接查 Search Console 的查詢數據、檢查單頁收錄狀態，還能產出含圖表的 A4 版 PDF 報告，拿去給客戶或主管都算體面。

七、看懂產出的報告

每種稽核都輸出對應的 Markdown 檔：全站是 FULL-AUDIT-REPORT.md，AI 搜尋是 GEO-ANALYSIS.md，schema 是 SCHEMA-REPORT.md，在地 SEO 是 LOCAL-SEO-ANALYSIS.md。讀報告時抓三個東西：

報告是本機檔案，格式是純 Markdown 加選配的 PDF 與 JSON，要進版本控制、貼進 Notion、餵給其他工具都沒有阻力。這也是它比商用 SaaS 工具好談的一點：資料不出你的電腦，也沒有匯出限制。

八、擴充套件（選配）

核心功能完全不需要第三方帳號。想要更深的競爭數據時，再依需求掛上 MCP 擴充，各自的安裝腳本在 extensions/ 目錄下：

擴充提供什麼費用
DataForSEO即時 SERP、關鍵字研究、外鏈、AI 提及追蹤（23 個指令）需帳號，按量計費
Ahrefs官方 MCP：外鏈與自然關鍵字數據需訂閱
SE RankingAI Share-of-Voice：品牌在 ChatGPT、Gemini、Perplexity、AI Overviews 的能見度需訂閱
ProfoundLLM 引用追蹤（時間序列）需訂閱
Firecrawl全站爬取與網址探索有免費額度
Bing WebmasterBing 站長工具＋IndexNow 快速提交收錄免費
Unlighthouse多頁 Lighthouse 跑分，本機執行免費
Banana（image-gen）SEO 素材圖片生成（OG 圖、部落格主圖）需 Gemini API

同作者另有兩個可以搭配的姊妹專案：Claude Blog（依稽核結果寫作優化內容）和 Codex 版的 Codex SEO（工作流程相同，給用 Codex 的人）。

九、疑難排解

狀況處理方式
裝完找不到 /seo 指令重啟 Claude Code；確認 CLI 版本 1.0.33 以上；再跑一次 /seo doctor
Python 相依套件錯誤確認 Python 3.10+；重跑 /seo setup 重建隔離環境
Windows 偵測不到 Python安裝 Python 時勾選加入 PATH，或用 py launcher；官方 TROUBLESHOOTING.md 有專節
截圖或 SPA 渲染失敗Playwright Chromium 沒裝好，重跑 /seo setup；公司網路擋下載時需設 proxy
SPA 網站的發現看起來不對捲動觸發載入、點擊後才出現的內容是已知限制；手動跑 seo-visual 子 agent 比對 Playwright 快照與原始 HTML 的差異
稽核跑很慢或逾時大型網站先用 /seo page 鎖定重點頁；檢查網站本身回應速度
schema 驗證疑似誤報用 Google Rich Results Test 交叉驗證；v2 內建雙驗證器已大幅減少誤報

更完整的清單見官方 TROUBLESHOOTING.md，回報問題到 GitHub Issues，維護者回應速度不錯。

十、重點整理