Claude SEO 功能介紹:Claude Code 裡的免費開源 SEO 全面稽核外掛

7 分鐘閱讀時長

發布時間:

Claude SEO 功能介紹:Claude Code 裡的免費開源 SEO 全面稽核外掛

專案: AgriciDaniel/claude-seo 定位: 一組給 Claude Code 使用的「通用 SEO 技能」,直接以 /seo 指令對任何網站跑完整稽核,10–15 分鐘內輸出依影響力排序的行動計畫。 授權: MIT(免費、無使用上限、無追蹤)。主要語言: Python。


一、專案概況

項目內容
全名AgriciDaniel/claude-seo
一句話描述通用 SEO 技能:26 個子技能 + 19 個子代理,涵蓋技術 SEO、E-E-A-T、Schema、GEO/AEO、Agent Readiness、反向連結、本地/電商/國際 SEO、Google API、PDF/Excel 報告;另有 9 個可選擴充取得即時 SEO 資料
Stars / Forks約 23,000 / 3,125(API 讀取當日數據)
授權MIT License
語言Python
版本pyproject.toml 標示 2.5.0
建立 / 最近推送2026-02-07 / 2026-10-22
Open issues69
官方站claude-seo.md(作者自用站,自第一天起以此工具稽核)
主題標籤ai, ai-seo, claude-code, claude-code-skill, marketing-automation, open-source, seo

README 宣稱的測試規模:1077 個測試通過(badge),CI 走 .github/workflows/ci.yml。


二、它是什麼、不是什麼

它不是爬蟲工具,也不是排行追蹤 SaaS。它是一套「把 SEO 顧問的檢查清單代理化」的技能包:

  • 給它任意網址 → 自動偵測業務類型(SaaS/本地/電商/出版/代理商)→ 調度最多 17 個專職代理並行稽核 → 匯總成 SEO Health Score(0–100) 與依影響力排序的行動計畫。
  • 每條建議都說明「依據是什麼、依賴什麼、怎麼驗證它真的生效」。
  • 報告以 Markdown 落地在本地,/seo google report 可轉成 PDF(另有 Excel 匯出)。

與 Screaming Frog 類工具的分工:爬蟲更快更深、大廠有自有反向連結資料庫;Claude SEO 的強項是解釋與排序、AI 搜尋深度、可用自然語言追問。作者明講「很多人兩者並用」。


三、架構:26 技能 × 19 代理

依 docs/ARCHITECTURE.md:26 個子技能(22 核心 + 1 主控 orchestrator + 1 框架整合 + 2 擴充鏡像)與 19 個子代理(16 核心 + 1 框架整合 + 2 擴充鏡像)。

3.1 目錄結構

claude-seo/
├── skills/seo/                 # 主控 orchestrator(路由與調度)
│   └── references/             # 按需載入的參考檔(13 個)
├── skills/seo-audit/           # 全站稽核(平行子代理)
├── skills/seo-page/            # 單頁深挖
├── skills/seo-technical/       # 技術 SEO(9 類)
├── skills/seo-content/         # E-E-A-T 與內容品質
├── skills/seo-content-brief/   # 競品式內容 brief
├── skills/seo-schema/          # Schema.org 偵測/驗證/生成
├── skills/seo-sitemap/         # XML sitemap 分析與生成
├── skills/seo-images/          # 圖片優化
├── skills/seo-geo/             # AI 搜尋(GEO)
├── skills/seo-agentic/         # Agent readiness(Lighthouse Agentic、WebMCP)
├── skills/seo-local/           # 本地 SEO(GBP、citation、評論)
├── skills/seo-maps/            # 地圖情報(geo-grid、GBP 稽核)
├── skills/seo-backlinks/       # 反向連結輪廓
├── skills/seo-cluster/         # 以 SERP 為基礎的語意叢集
├── skills/seo-sxo/             # 搜尋體驗優化
├── skills/seo-drift/           # SEO 漂移監控(baseline)
├── skills/seo-ecommerce/       # 電商 SEO
├── skills/seo-hreflang/        # 國際 SEO / hreflang
├── skills/seo-plan/            # 策略規劃(產業模板)
├── skills/seo-programmatic/    # 程式化 SEO
├── skills/seo-competitor-pages/# 競品比較頁生成
├── skills/seo-google/          # Google API(GSC/PSI/CrUX/GA4)
├── skills/seo-flow/            # FLOW 框架(CC BY 4.0)
├── skills/seo-dataforseo/      # DataForSEO MCP 鏡像(擴充)
└── skills/seo-image-gen/       # Banana MCP 鏡像(擴充)

agents/                         # 19 個 *.md 代理定義
extensions/                     # ahrefs, banana, bing-webmaster, dataforseo,
                                # firecrawl, matomo, profound, seranking, unlighthouse
scripts/                        # 61 個 Python 腳本(fetch_page, render_page,
                                # lighthouse_agentic, gsc_query, google_report ...)
hooks/  data/  schema/  docs/  tests/

3.2 全站稽核的調度流程

使用者請求
   │
   ▼
seo(主控 orchestrator)
   │ 偵測業務類型與訊號
   │ 平行 spawn 子代理
   ├─ seo-technical ─ seo-content ─ seo-schema ─ seo-sitemap
   ├─ seo-performance ─ seo-visual ─ seo-geo
   └─ 條件式:seo-google(有 Google API 憑證)、seo-local(本地商家)、
               seo-maps(本地 + DataForSEO MCP)、seo-backlinks(Moz/Bing/CC)、
               seo-cluster(內容策略訊號)、seo-sxo(全站稽核必開)、
               seo-drift(該 URL 已有 baseline)、seo-ecommerce(電商偵測)
   ▼
彙整 → SEO Health Score + 行動計畫 → FULL-AUDIT-REPORT.md / ACTION-PLAN.md

依 docs/COMMANDS.md:全站稽核最多爬 500 頁,分派 9 個固定代理 + 8 個條件式代理(最多 17 個並行)。

3.3 四個設計原則

  1. Progressive disclosure:主 SKILL.md 控制在 500 行內,細節放子技能與按需載入的 reference 檔。
  2. 平行處理:代理彼此不阻塞,最後彙整。
  3. Quality gates:內建門檻避免爛建議,例如地區頁上限(30 個警告/50 個硬停)、Schema 棄用警示、強制以 INP 取代 FID。
  4. 產業感知:SaaS/本地/電商/出版/代理商各有模板,從首頁訊號自動判斷。

3.4 執行環境的巧思

所有內建腳本都經由 scripts/claude-seo + runtime.py 啟動器呼叫,不允許裸 python 直接跑:

  • 啟動器在 Python 3.11–3.14 範圍內解析可用解釋器(CLAUDE_SEO_PYTHON → 預設解釋器 → 最新版號)。
  • 技能與代理以 "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run <script.py> 的相對路徑呼叫,Claude Code 會展開該變數;刻意不放頂層 bin/,因為 claude.ai 託管的 marketplace 會以 marketplace_sync_bin_directory_not_allowed 拒絕。
  • 環境狀態(runtime 結構、requirements 的 SHA-256、Python 版本、外掛版本、瀏覽器狀態)寫入 marker;環境替換先暫存、驗證失敗即回滾。
  • run 只接受白名單腳本檔名、參數不經 shell、保留子程序 exit code、強制 UTF-8。

3.5 依賴(requirements.txt 有明確 CVE 下限)

beautifulsoup4、requests、lxml、lxml_html_clean、playwright、urllib3、trafilatura、htmldate、courlan、matplotlib、numpy、weasyprint、openpyxl、pillow,以及 Google API 系列(google-api-python-client、google-auth、google-ads、google-analytics-data)。版本以 >=X,<Y 綁定並在註解中標明修補的 CVE/GHSA。


四、19 個專職代理與對應指令

Agent角色模型指令
seo-technical技術 SEO 主責Sonnet/seo technical
seo-content內容編輯(E-E-A-T)Opus/seo content
seo-schema結構化資料工程Sonnet/seo schema
seo-sitemapSitemap 架構Sonnet/seo sitemap
seo-performanceCore Web VitalsSonnet/seo audit
seo-visual視覺/行動渲染 QASonnet/seo audit
seo-geoAI 搜尋分析(GEO)Opus/seo geo
seo-agenticAgent readinessSonnet/seo agentic
seo-local本地 SEOSonnet/seo local
seo-maps地圖情報Sonnet/seo maps
seo-googleGoogle 資料分析Sonnet/seo google
seo-backlinks連結分析Sonnet/seo backlinks
Live data(擴充)即時資料分析Sonnet/seo audit
seo-image-gen(擴充)圖片生產Sonnet/seo image-gen
seo-cluster主題策略Opus/seo cluster
seo-sxo搜尋體驗設計Opus/seo sxo
seo-drift變更監控Opus/seo drift
seo-ecommerce電商專責Sonnet/seo ecommerce
seo-flowFLOW 策略Sonnet/seo flow

成本提醒: 需要較多判斷力的代理跑 Opus,其餘跑 Sonnet,因此一次完整 /seo audit 會比單頁檢查吃掉更多額度;每個代理的模型可在 agents/*.md 內改。


五、30 個核心+擴充指令(六大群組)

4.1 稽核與規劃(5)

  • /seo setup — 建立/刷新隔離的 Python 執行環境與 Chromium
  • /seo doctor — 唯讀檢查環境就緒度,不動系統
  • /seo audit <url> — 全站稽核(平行代理)
  • /seo page <url> — 單頁深挖
  • /seo plan <type> — 策略規劃(saas / local / ecommerce / publisher / agency)

4.2 技術 SEO(7)

  • /seo technical <url> — 9 類別技術稽核:可爬取性、可索引性、安全性、URL 結構、行動優化、Core Web Vitals(LCP/INP/CLS)、結構化資料、JS 渲染、IndexNow
  • /seo sitemap <url|generate> — sitemap 分析或生成
  • /seo images <url> — 圖片優化分析
  • /seo hreflang <url> — hreflang / i18n 稽核與生成
  • /seo programmatic <url> — 程式化 SEO 分析與規劃
  • /seo google [command] — GSC、PageSpeed、CrUX、Indexing、GA4、PDF 報告
  • /seo drift baseline|compare|history <url> — 以 SQLite 快照做漂移監控

4.3 內容與 E-E-A-T(6)

  • /seo content <url> — 經驗/專業/權威/可信度 + AI 引用準備度 + 內容新鮮度
  • /seo content-brief <topic> — 關鍵字、意圖、章節大綱、內鏈、競品切入角度
  • /seo cluster <keyword> — 以 SERP 做語意叢集
  • /seo sxo <url> — 頁型、user stories、personas
  • /seo flow [stage] — FLOW 框架提示詞(CC BY 4.0,evidence-led)
  • /seo competitor-pages <url> — 競品比較頁生成

4.4 Schema 與 AI 搜尋(3)

  • /seo schema <url> — 偵測、驗證、生成 Schema.org
  • /seo geo <url> — AI Overviews / Generative Engine Optimization:可被引用的程度、AI 爬蟲可及性、品牌在 Wikipedia/Reddit/YouTube/LinkedIn 的存在感
  • /seo agentic <url> — Agent readiness:Lighthouse Agentic Browsing X/N 分數、accessibility tree、AI 代理存取、llms.txt、Markdown 版本、WebMCP

4.5 本地、連結、商務(4)

  • /seo local <url> — GBP、citation、評論、map pack
  • /seo maps [command] — geo-grid、GBP 稽核、評論、競品
  • /seo backlinks <url> — Moz、Bing、Common Crawl(免費);DataForSEO(付費)
  • /seo ecommerce <url> — 產品 schema 與 marketplace 情報

4.6 擴充指令(5)

  • /seo image-gen [use-case] — SEO 素材 AI 生圖
  • /seo seranking [command] — ChatGPT/Gemini/Perplexity/AI Overviews/AI Mode 的 Share-of-Voice
  • /seo profound [command] — LLM 引用追蹤(時間序列)
  • /seo bing [command] <url> — Bing Webmaster Tools + IndexNow 即時提交
  • /seo unlighthouse <url> — 本地跑全站 Lighthouse

六、安裝與第一次稽核

需求: Claude Code 1.0.33+、Python 3.11–3.14。

外掛方式(推薦)

/plugin marketplace add AgriciDaniel/claude-seo
/plugin install claude-seo@agricidaniel-claude-seo
/seo setup        # 準備獨立 Python 環境 + headless 瀏覽器
/seo doctor       # 隨時驗環境

手動安裝: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

作者特意說明用 git clone 而非 irm ... | iex:Claude Code 會把「下載並直接執行遠端程式」視為供應鏈風險,先 clone 才能檢查 install.ps1。

第一次跑

claude
/seo audit https://example.com         # 全站 + 排序後行動計畫
/seo page  https://example.com/pricing # 單頁深挖
/seo geo   https://example.com         # AI 搜尋準備度
/seo schema https://example.com        # 結構化資料檢查與生成
/seo local https://example.com         # 本地 SEO / GBP

移除: 外掛安裝者用 /plugin uninstall claude-seo@agricidaniel-claude-seo;手動安裝者跑 claude-seo/uninstall.sh。


七、兩條版本線

版本授權/取得方式差異
公開版MIT,任何人可用全部功能、無使用限制
私享版AI Marketing Hub Pro 會員新功能早期存取

私享版安裝:

/plugin marketplace add AI-Marketing-Hub/claude-seo
/plugin install claude-seo@ai-marketing-hub-claude-seo
/seo setup

八、9 個可選擴充(不裝也能完整運作)

擴充提供什麼
BananaClaude Banana 的 AI 生圖(社群預覽圖、部落格主圖)
SE Ranking在 ChatGPT、Gemini、Perplexity、Google AI 回答中的 Share of Voice
ProfoundAI 模型引用你網站的追蹤
Bing WebmasterBing 資料 + IndexNow 即時提交
Unlighthouse全站每頁 Lighthouse 分數(本地執行)
DataForSEO付費 SERP/關鍵字/商家資料(MCP)
Firecrawl抓取/渲染替代管線
MatomoGA4 的替代或補充(Reporting API)
Ahrefs反向連結與關鍵字資料(MCP)

擴充各自帶 install.sh / install.ps1 / uninstall.* 與 setup 文件,放在 extensions/<name>/。


九、價格/替代方案比較(作者自述,僅示意)

 人工執行找代理商SEO 軟體Claude SEO
單次稽核時間4–8 小時1–3 週10–45 分鐘10–15 分鐘
成本計費工時每案 $2k–$15k+$99–$999/月免費(只需 Claude Code 方案)
檢查一致性依執行者依團隊有每次同一份清單
產出物表格/PDF簡報儀表板 + CSVMarkdown / PDF / JSON,留在你手上
資料歸屬有無無在本機執行
AI 搜尋覆蓋不一定不一定常落後數月有,跟隨 Google 最新指引
每項修正是否附驗證方法有時有時罕見有

十、限制與注意事項(README 明列)

  1. 資料仍會送到 Anthropic 模型:Claude SEO 在 Claude Code 內執行,被分析的頁面與資料如同你在 Claude Code 做的任何工作一樣會送給 Claude;報告只是落在本機檔案。除你自行接的擴充/API 外,沒有第三方 SEO 服務看到你的資料(另有 Wikipedia、Reddit、Common Crawl 等公開來源讀取,詳見 PRIVACY.md)。
  2. 沒有 Google API key 時,Core Web Vitals 是實驗室估計、索引狀態是推斷。
  3. 需要滾動/點擊才出現內容的頁,結果可能偏噪。
  4. 成本:完整稽核以 Opus 代理為主,較吃方案額度。
  5. 不是爬蟲替代品:深度與速度不如 Screaming Frog;反向連結資料庫不如商業套件。
  6. JS 站(Next.js / React / Vue)可行:內容需 JS 呈現時會自動用 headless 瀏覽器開啟,以訪客所見狀態稽核。

十一、同家族專案

專案用途
Claude Blog依 SEO 發現撰寫並優化部落格文章
Claude BananaSEO 素材與貼文的 AI 生圖
ChatGPT SEO在 ChatGPT 內把頁面/草稿/匯出檔變成有出處的修正計畫
FLOW證據導向 SEO 框架,42 個 AI 提示詞
AI Marketing Claude文案、Email、廣告、漏斗的社群套件

十二、適合誰

  • SEO 代理商:把「每季稽核」變成「每週每客戶稽核」,用 drift 監控抓變化。
  • 企業內部 SEO 團隊(SaaS、出版、電商):每次上線/審稿前的第二雙眼睛,含 AI 搜尋。
  • 自由接案顧問:第一通電話就能給出真實分數與前幾項修正,再談提案。

反過來說:若你要的是大規模爬取與自有連結資料庫,請搭配 Screaming Frog / Ahrefs 等;Claude SEO 的價值在「解釋、排序、驗證方法、AI 搜尋準備度」。


參考

本文依 2026-10-28 讀取的 GitHub API、README、ARCHITECTURE.md、COMMANDS.md 與 requirements.txt 整理;Stars/Forks 為當日數值,會持續變動。