SEO Machine · Claude Code SEO 工作流指南
Skill Manual · TheCraigHewitt / seomachine · 2026

SEO Machine — 使用說明書 Claude Code 的長文 SEO工作流。
36 個指令、10 個代理、GA4 + Search Console + WordPress 串接。

Castos 創辦人 Craig Hewitt 將自家 SaaS 多年使用的 SEO 內容工作流完整開源。涵蓋選題、搜尋意圖分析、競品對比、長文草稿、Yoast 發佈到事後成效復盤,包含 20 個 slash command + 26 個行銷 Skill + 5 個 Python 分析模組。MIT 授權,可直接 fork 為內容團隊的作業系統。

Stars
6,688
2025-10-29 建倉,6 個月內累積 919 次 fork,語言佔比 Python 99%。
Commands + Skills
20 + 26
10 核心工作流、5 研究、5 落地頁指令,再疊 26 個行銷 Skill。
資料來源
GA4 · GSC · DataForSEO
三組 API 接入,Claude 依據 GA4、GSC、DataForSEO 的真實搜尋資料撰稿。
授權
MIT · Active
2026-04-10 最新 push,持續更新,附官方 Mintlify 說明書與 Castos 範例。
01 / 編者手記 FROM THE EDITOR · APRIL 2026

SEO Machine 是一個完整的 workspace,而非提示詞集。

編者手記 EDITOR'S NOTE

Craig Hewitt 將 Castos 內部多年使用的長文 SEO 內容流程完整移植到 Claude Code。除 /write 外,還包含 /research/analyze-existing/performance-review,以及 Python 搜尋意圖分類與 0–100 SEO 品質評分。倉庫中保留有作者自家實際使用的範例與設定。

01

六段循環涵蓋 SERP 研究到 60 天後復盤。

SEO Machine 的流程分六段:SERP 研究 → 競品落差分析 → 內文優化 → 發佈 → 60 天後復盤,每一段都有對應的 slash command 與 Python 分析模組。多數 AI 寫作工具僅涵蓋「產出草稿」這一段。

02

三組 API 提供真實的曝光、點擊與排名資料。

串接 Google Analytics 4Google Search ConsoleDataForSEO 三組 API 後,/priorities 讀取曝光、點擊、排名、退出率,依此排序哪幾篇文章需要改寫、哪幾篇應刪除、哪些關鍵字值得新寫。所有建議均依據你的帳號資料,而非通用模板。

03

從草稿到 WordPress 發佈形成封閉循環。

/publish-draft 透過 WordPress REST API 把 Claude 產出的 Markdown 直接發佈,同時寫入 Yoast SEO 的 metadata(meta title / description / focus keyword / Schema)。少掉「把草稿貼進 CMS」這段人工工,小團隊可以從 0 到 1 無縫走完。

02 / 核心工作流 RESEARCH → WRITE → OPTIMIZE → PUBLISH
01

核心 工作流

10 個 slash command 涵蓋完整長文內容流水線,包含主題優先順序、草稿生成、既有文章分析、SEO 品質評分、優化、發佈與事後復盤。

6 Entries
Write · Optimize · Publish
Python + Markdown
01/06
TheCraigHewitt / seomachine — /write

單一指令觸發四個代理並行的 pipeline

multi-agent 編排:Content Analyzer、SEO Optimizer、Internal Linker、Editor 同時執行

/write <topic> 啟動 Content Analyzer(搜尋意圖 + 競品缺口)、SEO Optimizer(keyword mapping + Schema)、Internal Linker(自動掛內連)、Editor(readability 與品牌語氣)四個代理並行執行,輸出 2,500–4,000 字草稿到 drafts/。此為單一指令觸發跨代理編排的標準用法。

✓ 招牌指令 4 Agents 並行 2,500–4,000 字 drafts/ 輸出
Agents 4 Parallel Output drafts/ Length 2.5k–4k
02
TheCraigHewitt / seomachine — /research

SERP 偵察:讀 TOP 10、分類意圖、輸出 H2 結構

DataForSEO 抓取十個競品頁,產出搜尋意圖分類與 H2 樹狀圖

/research <topic> 先用 DataForSEO 抓 TOP 10 SERP,再對每一篇做大綱摘要、抓 H2 結構、標註 informational / commercial / transactional 意圖。最後輸出一份 outline 到 research/,成為 /write 的輸入。

TOP 10 SERP 意圖分類 H2 樹
API DataForSEO Output research/
03
TheCraigHewitt / seomachine — /analyze-existing + /rewrite

診斷舊文章後依 SEO 分數決定是否改寫

analyze-existing 輸出 0–100 品質分,rewrite 在原 URL 與內連結約束下改寫

/analyze-existing <url> 輸出 0–100 的 SEO 品質分、找出落後競品的 H2、讀取 GSC 現有排名;/rewrite 接著以原有 URL + 內連結為約束條件改寫。特別適合有 300 篇舊文、不知道哪篇該先動的網站。

0–100 品質分 GSC 讀取 內連結保留
Input URL Output rewrites/
04
TheCraigHewitt / seomachine — /optimize + /scrub

發佈前的兩道處理

/optimize 補強 meta 與 keyword density,/scrub 移除過度通用的 AI 語氣

/optimize <file> 依據 SEO Quality Rating 模組補強 meta、內連、keyword density、readability。/scrub 掃除過度通用的 AI 語氣(如「In today's fast-paced world…」、冗詞、假設性副詞)。兩道處理分別針對 SEO 結構與語氣品質。

SEO 補強 去 AI 味 readability 優化
Module SEO Quality Target Readability
05
TheCraigHewitt / seomachine — /publish-draft

Markdown 草稿直接發佈到WordPress

透過 REST API 寫入 Yoast focus keyword、meta description、Schema,以 draft 或 scheduled 狀態發佈

透過 WordPress REST API + 倉庫內的 wordpress/ MU-plugin,/publish-draft <file> 會把 Markdown 草稿轉 Gutenberg block、帶入 Yoast focus keyword / meta description / Schema,並以 draft 或 scheduled 狀態發佈。少掉人工複製貼上的一小時。

REST API Yoast metadata MU-plugin
CMS WordPress SEO Plugin Yoast
06
TheCraigHewitt / seomachine — /performance-review + /priorities

發佈後 60 天讀 GA4/GSC,排出下一批改稿清單

/performance-review 輸出曝光、點擊、排名、跳出率;/priorities 依規則給出 /rewrite 清單

/performance-review 讀 Google Analytics 4 與 Search Console,產出每篇的曝光、點擊、平均排名、跳出率。/priorities 根據「排名在 4–15 名且曝光 > X」這類規則,輸出下一批 /rewrite 清單。將 SEO 流程設計為持續的月循環,而非一次性專案。

GA4 讀取 GSC 讀取 改稿排程
Window 60 days Triggers /rewrite
03 / 研究與稽核 SERP · GAPS · TRENDING · LANDING PAGE CRO
02

研究與稽核

5 個 /research-* 專攻選題與缺口,5 個 /landing-* 把 CRO 思維接進落地頁優化。兩組搭配等於「上游選題 + 下游轉換」雙管齊下。

5 Entries
Research · SERP · Landing
Data-Driven
01/05
TheCraigHewitt / seomachine — /research-serp

SERP 逆向工程:擷取 TOP 10、Featured Snippet 與 PAA

同時抓 featured snippet、People Also Ask、image pack、video pack、knowledge panel

/research-serp <keyword> 讀取 featured snippetPeople Also Askimage packvideo packknowledge panel,輸出結構化的搜尋意圖摘要。多數工具僅擷取 TOP 10 標題,此指令額外還原 SERP 各版位的內容需求。

✓ 深度 SERP 拆解 PAA 樹 Feature Snippet Intent Map
Data DataForSEO Output Intent Map Inputs Keyword
02
TheCraigHewitt / seomachine — /research-gaps

Content Gap Analysis:對手排名而你尚未涵蓋的題目

讀 config/competitors.yml,比對 GSC 現有關鍵字,輸出依難度與商業價值排序的題目清單

讀取 config/competitors.yml 中列出的 3–5 個競品網域,與 GSC 現有關鍵字比對,輸出「競品有排名、你零流量」的題目清單,按難度與商業價值排序。此流程取代 Ahrefs Content Gap 的手動操作步驟。

Gap Analysis 難度排序 商業價值
Config competitors.yml Pairs With /write
03
TheCraigHewitt / seomachine — /research-trending + /research-topics

選題工具:短期趨勢關鍵字與長期 topic cluster

/research-trending 監測 72 小時爆量關鍵字,/research-topics 建立 pillar + supporting 結構

/research-trending 追蹤產業 72 小時內流量上升的關鍵字。/research-topicscontext/brand.md 推導可涵蓋的 topic cluster,輸出 pillar + supporting 結構。兩個指令分別對應短線話題與長期架構的選題需求。

72h 流量浪 Topic Cluster Pillar + Support
Window 72h / 季度 Structure Cluster
04
TheCraigHewitt / seomachine — /landing-audit + /landing-competitor

落地頁CRO 稽核:ATF、CTA 位置、Friction 分析

CRO Analyst 代理執行,輸出可執行 ticket;/landing-competitor 對照競品落地頁

/landing-audit <url> 讀首屏 above-the-fold、CTA 顏色與位置、social proof、friction points、loading hierarchy,輸出可執行 ticket;/landing-competitor 則把競品落地頁拉來對照。對 SaaS 落地頁連結 Blog 文章的轉換漏斗尤其有用。

CRO Analyst ATF 檢查 Friction 分析
Agent CRO Analyst Output audits/
05
TheCraigHewitt / seomachine — /landing-write + /landing-research + /landing-publish

落地頁三段流程:Research → Write → Publish

/landing-research 蒐集 pain point,/landing-write 輸出標準結構,/landing-publish 發佈到 WordPress

/landing-research 蒐集受眾 pain point 與競品差異;/landing-write 輸出 Hero + Benefits + Social Proof + FAQ + CTA 結構;/landing-publish 發佈到 WordPress(支援 page / custom post type)。整合頁面級 SEO 與 CRO,無需另行使用 Unbounce 或 Webflow。

Page Full Flow WP Publish CRO Structure
Stage 3-Step Target WordPress
04 / 進階用法 CONTEXT FILES · COMPETITOR CONFIG · AGENT OVERRIDE · PIPELINE

五個配置步驟,讓 SEO Machine 輸出符合品牌語氣

git clone 之後需要完成以下設定,Claude 的輸出才能符合你的品牌語氣,而非通用 AI 稿。以下五個步驟來自對 README 與 .claude/ 目錄的實際解讀。

01

執行任何指令前,先填入 context/ 目錄的三個設定檔

brand.md 定義語氣與禁用詞,examples/ 提供範文,keywords.md 列出長尾關鍵字池

context/brand.md 定義品牌語氣、禁用詞、CTA 模板;context/examples/ 存放 3–5 篇內部高品質文章供 Claude 參考;context/keywords.md 列出長尾關鍵字池。未填入這三個檔案時,/write 輸出的是通用 AI 稿,填入後輸出才具備品牌一致性。

brand.md examples/ keywords.md
Priority Step 0 Affects 所有輸出
02

config/competitors.yml 設定 3–5 個競品網域

/research-gaps 與 /landing-competitor 均依賴此檔

/research-gaps/landing-competitor 均讀取此設定。建議填入 2 個直接競爭者2 個間接 thought leader1 個 alternative 比較站。超過 5 個網域時,輸出的題目方向會趨於分散,難以找到差異化切入點。

competitors.yml 2 + 2 + 1 聚焦
File config/ Sweet Spot 3–5
03

data_sources/ 中的 5 個 Python 分析模組

search intent classifier、keyword density analyzer、SEO quality rating、content length comparison、readability scoring

data_sources/ 包含:search intent classifier(scikit-learn)、keyword density analyzerSEO quality rating(0–100 分)、content length comparisonreadability scoring(textstat)。Claude 在流程中會主動呼叫這些模組;也可直接執行 python data_sources/seo_quality.py <file> 作為 CI hook。

sklearn Intent textstat CI Hook
Path data_sources/ Mode Python + Claude
04

建立月循環:/priorities → /rewrite → /optimize → /publish-draft

月初讀 GSC 60 天資料,挑出排名 4–15 的舊文,依序改寫、補強、覆蓋發佈

月初執行 /priorities 讀取 GSC 60 天資料,挑出排名 4–15 名的舊文;依序執行 /rewrite/optimize/publish-draft 完成覆蓋發佈。依官方文件說明,此流程以既有文章存量為改善對象,不需另外新寫內容。

4 步 Loop 月循環 不寫新文章
Cadence Monthly Target Rank 4–15 → 1–3
05

.claude/skills/ 中的 26 個行銷 Skill

copywriting、CRO、pricing 等 Skill 可針對 /write 草稿進行細項調整

除 20 個 slash command 外,.claude/skills/ 包含 26 個行銷 Skill。草稿語氣過硬時呼叫 copywriting-skill;撰寫定價頁時呼叫 pricing-strategy-skill;規劃 A/B 測試時呼叫 ab-testing-skill。這些 Skill 作為各步驟的細項調整工具,與 slash command 搭配使用。

26 Skills Fine-Tune Marketing SDK
Path .claude/skills/ Count 26
05 / 資料與發佈 GA4 · GSC · DATAFORSEO · YOAST · PYTHON MODULES
03

資料層與發佈

此層涵蓋 5 個 Python 分析模組、3 組搜尋資料 API,以及 WordPress REST 整合。三者共同構成從資料讀取到發佈的完整封閉循環,是 SEO Machine 與一般 AI 寫稿工具的主要差異。

5 Entries
Data · Publish · Analysis
Python 99%
01/05
TheCraigHewitt / seomachine — data_sources/

5 個 Python 模組:Search Intent、Keyword Density、SEO Quality、Length、Readability

可程式驗證的 0–100 評分取代 prompt 感覺

Search Intent Classifier(scikit-learn)、Keyword Density AnalyzerSEO Quality Rating(0–100 分)、Content Length Comparison(對標 TOP 10 平均)、Readability Scoring(textstat)。各模組輸出可量化分數,均可作為 CI hook 直接執行。

✓ 可程式驗證 sklearn textstat 0–100 評分
Modules 5 Core Lang Python 99% Tests Scriptable
02
Integration — Google Analytics 4 API

GA4 Data API 提供 pageview、session duration、bounce rate

/performance-review 依據你帳號的真實流量資料,而非通用建議

透過 GA4 Data API,/performance-review 讀取 pageview、unique user、avg session duration、bounce rate。依此資料可區分「排名第 3 但跳出率 80%」需要重寫內文,與「排名第 12 但停留 5 分鐘」需要補充內部連結兩種情況。

GA4 Data API Session Quality Bounce Analysis
Source Google Consumer /performance-review
03
Integration — Google Search Console API

GSC API 提供曝光、點擊、平均排名資料

/priorities 的主要資料源,識別排名 4–15 名的改寫優先序

GSC Search Analytics API 回傳 query / page / country / device 維度的曝光量、CTR、平均排名。/priorities 依據「排名 4–15 名、曝光 > 1,000」等條件,輸出改寫優先序清單。改寫既有排名文章比新寫內容所需資源更少。

曝光 × CTR 4–15 名邏輯 不用寫新文
Source Google Focus Rank 4–15
04
Integration — DataForSEO API

DataForSEO 提供 SERP、關鍵字搜尋量與 Backlink 資料

/research-serp、/research-trending、/research-gaps 均依賴此 API

DataForSEO 提供 TOP 100 SERP 結構化資料、關鍵字搜尋量、相關關鍵字、backlink profile。/research-serp/research-trending/research-gaps 均使用此 API。每次呼叫成本約 $0.002–$0.01,依倉庫說明比 Ahrefs 企業版低 2 個量級。

TOP 100 SERP Keyword Volume 低成本
Source DataForSEO Cost $0.002+/call
05
TheCraigHewitt / seomachine — wordpress/ MU-plugin

WordPress MU-plugin 整合 REST API 與 Yoast SEO

將 Markdown 轉換為 Gutenberg block,並開放 Yoast focus keyword / meta / Schema 欄位供 /publish-draft 寫入

倉庫附帶的 MU-plugin 解決兩個問題:將 Markdown 轉換為 Gutenberg block(含 heading、list、image),以及將 Yoast SEO 的 focus keyword / meta / Schema 欄位暴露到 REST API 供 /publish-draft 寫入。此插件是從草稿到自動發佈流程的必要環節。

MU-plugin Gutenberg Yoast REST
Type MU-plugin Output Gutenberg
06 / 社群觀察 SEARCH ENGINE LAND · SEOMACHINE.IO · FORKS · CASTOS

SEO 社群對 TheCraigHewitt / seomachine 的反應

6,688 顆星、919 次 fork、Python 99%。2025 年 10 月上線後半年內,TheCraigHewitt / seomachine 被 Search Engine Land 引用為參考實作。以下是四條可驗證的社群訊號。

01

Search Engine Land 將此倉庫作為參考實作引用

"How to turn Claude Code into your SEO command center"(searchengineland.com/claude-code-seo-work-470668)

Search Engine LandHow to turn Claude Code into your SEO command center(searchengineland.com/claude-code-seo-work-470668)中,引用 SEO Machine 作為「Claude Code 用於 SEO 工作流」的具體實作案例。該文章為社論報導,非贊助內容。

Search Engine Land 業界社論 Article 470668
Outlet SEL Stance 參考實作
02

官方網站 seomachine.io 與 Mintlify 說明書

seomachine.io 為 landing page;thecraighewitt-seomachine-70.mintlify.app 為完整文件站

seomachine.io 作為官方 landing page;Mintlify 文件站(thecraighewitt-seomachine-70.mintlify.app)包含 Quick Start、Commands Reference、Data Source 設定說明。設有獨立說明書代表作者持續維護此倉庫,而非一次性釋出。

seomachine.io Mintlify 說明書 持續維運
Landing .io Docs Mintlify
03

919 次 fork,fork:star 比 13.7%

多數 awesome 清單的 fork:star 比約 3–4%,此倉庫達 13.7%

6,688 顆星、919 次 fork,換算 13.7% 的 fork:star 比。一般 awesome 清單的同比約為 3–4%。較高的 fork 比例顯示使用者不僅收藏,而是實際 clone 下來做客製化。GitHubGPT 在倉庫累積 3,766 顆星時就已公開介紹此倉庫。

★ 6,688 919 forks 13.7% ratio
Fork Ratio 13.7% Signal 實際使用
04

作者為 Castos 創辦人 Craig Hewitt

服務 40,000+ 品牌的 SaaS CEO 將內部 SOP 開源

Craig Hewitt 是 Castos(podcast 寄存 SaaS,服務超過 40,000 個品牌)的創辦人兼 CEO,也曾創立 PodcastMotor,製作逾 500 集 podcast。倉庫內 examples/castos/ 目錄保留 Castos 自家的實際使用範例。此 SOP 在 Castos 內部使用數年後才開源。

Castos CEO 40k+ 客戶 examples/castos
Author Craig Hewitt Track Real SaaS
07 / 導入計畫 FROM THE TENTEN CMO OFFICE — PICK A LANE

四種團隊類型的導入建議

不需要一次用上全部 36 個指令。依目前流程中最需要改善的環節選擇路徑,兩週內可完成第一批 Claude 產出並發佈到 WordPress。

01 · 角色 · SOLO SAAS FOUNDER

兩週內完成首批 3 篇長文發佈

git clone 倉庫,填入 context/brand.mdexamples/,申請 DataForSEO 免費額度,依序執行 /research/write/optimize/publish-draft 完成第一輪。此為作者 Craig Hewitt 在 Castos 初期採用的流程。

02 · 角色 · SAAS CONTENT TEAM

將月度改稿循環標準化

月初執行 /priorities 讀取 GSC 60 天資料,挑出 5 篇排名 4–15 的舊文;後續兩週依序執行 /analyze-existing/rewrite/optimize/publish-draft。此路徑以既有文章存量為改善對象,適合不需增加新題目預算的 SaaS 內容團隊。

03 · 角色 · SEO AGENCY

每個客戶獨立一個 workspace

git submodule 將 seomachine 接入每個客戶的 repo,context/config/competitors.yml 各自存放該客戶的品牌設定與競品清單。Tenten 使用此架構同時為多個 Shopify Plus 與 Webflow 客戶執行 content sprint,資料隔離,SOP 一致。

04 · 角色 · ENTERPRISE MARKETING

將 Python 模組整合為 CI 檢核

企業環境通常不允許 Claude 直接發佈。改以 data_sources/seo_quality.pyreadability.py 作為 Pre-commit HookGitHub Action,所有 blog PR 先通過 0–100 分與 FK 指數檢核。Claude 提供建議,人工完成最終審查,審計記錄完整留存。

想把 SEO Machine 接上你的 GA4 與 WordPress?

Craig 把流程開源了。
接上 你的品牌與數據
是 Tenten 在做的事。

Tenten 協助 SaaS 與代理商完成 SEO Machine 的正式環境部署,涵蓋 context/brand.md 品牌語氣校調、DataForSEO / GA4 / GSC 憑證設定、WordPress MU-plugin 部署與 Yoast REST 權限調整,確保 /write/optimize/publish-draft 在正式環境穩定運行。交付目標為可持續運作的內容作業系統

Tenten 如何把 SEO Machine 變成生產力
Content OS 導入
兩週部署:品牌 context 校調 + DataForSEO/GA4/GSC 串接 + WordPress MU-plugin 上線。
SEO Rescue Sprint
30 天專案:用 /priorities + /rewrite 針對排名 4–15 名的舊文批次改寫上線。
Agency Multi-Client 部署
每客戶一個 workspace,submodule 管理,Tenten 協助建立 SOP 與交付模板。