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 品質評分。倉庫中保留有作者自家實際使用的範例與設定。

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

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

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

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

從草稿到 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

核心工作流

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

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/

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/

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

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

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

研究與稽核

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 snippet、People Also Ask、image pack、video pack、knowledge panel，輸出結構化的搜尋意圖摘要。多數工具僅擷取 TOP 10 標題，此指令額外還原 SERP 各版位的內容需求。

✓ 深度 SERP 拆解 PAA 樹 Feature Snippet Intent Map

Data DataForSEO Output Intent Map Inputs Keyword

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

TheCraigHewitt / seomachine — /research-trending + /research-topics

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

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

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

72h 流量浪 Topic Cluster Pillar + Support

Window 72h / 季度 Structure Cluster

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/

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/ 目錄的實際解讀。

執行任何指令前，先填入 `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 所有輸出

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

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

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

competitors.yml 2 + 2 + 1 聚焦

File config/ Sweet Spot 3–5

`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 analyzer、SEO quality rating（0–100 分）、content length comparison、readability scoring（textstat）。Claude 在流程中會主動呼叫這些模組；也可直接執行 python data_sources/seo_quality.py <file> 作為 CI hook。

sklearn Intent textstat CI Hook

Path data_sources/ Mode Python + Claude

建立月循環：/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

`.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

資料層與發佈

此層涵蓋 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 Analyzer、SEO 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

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

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

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

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 引用為參考實作。以下是四條可驗證的社群訊號。

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

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

Search Engine Land 在 How 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 參考實作

官方網站 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

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 實際使用

作者為 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

想把 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 在正式環境穩定運行。交付目標為可持續運作的內容作業系統。

預約 30 分鐘諮詢 → Tenten Awesome List

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 與交付模板。