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 不再憑空寫稿，而是讀到真實搜尋資料。

授權

MIT · Active

2026-04-10 最新 push，持續更新，附官方 Mintlify 說明書與 Castos 範例。

01 / 編者手記 FROM THE EDITOR · APRIL 2026

這不是「SEO 提示詞集」，是一個完整的 workspace。

編者手記 EDITOR'S NOTE

Craig Hewitt 把 Castos 內部用了多年的長文 SEO 內容流程，完整搬到 Claude Code — 不只是 /write，還有 /research、/analyze-existing、/performance-review，加上 Python 的搜尋意圖分類與 0–100 SEO 品質評分。這是少數開源後還看得見作者自家實戰痕跡的倉庫。

從「產 AI 內容」升級到「產能被搜尋到的內容」。

多數 AI 寫作工具停在「寫出一篇文章」。SEO Machine 從 SERP 研究 → 競品落差分析 → 內文優化 → 發佈 → 60 天後復盤 的六段循環設計，每一段都有對應 slash command 跟 Python 分析。Claude Code 不再只是寫手，而是整個 SEO 團隊的 OS。

真實資料 > 通用建議。

接上 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

一個指令，觸發四個代理同時工作

產文不是 one-shot prompt，而是 multi-agent pipeline

/write <topic> 會自動喚起 Content Analyzer（搜尋意圖 + 競品缺口）、SEO Optimizer（keyword mapping + Schema）、Internal Linker（自動掛內連）、Editor（readability 與品牌語氣）四個代理並行跑，輸出 2,500–4,000 字草稿到 drafts/。Claude Code 真正做到「單一指令、跨代理編排」。

✓ 招牌指令 4 Agents 並行 2,500–4,000 字 drafts/ 輸出

Agents 4 Parallel Output drafts/ Length 2.5k–4k

TheCraigHewitt / seomachine — /research

把SERP 偵察變成一個指令

讀十個競品頁 + 搜尋意圖分類 + 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

針對舊文章做外科手術

先診斷、再改寫 — 不是每篇都要砍掉重練

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

0–100 品質分 GSC 讀取內連結保留

Input URL Output rewrites/

TheCraigHewitt / seomachine — /optimize + /scrub

發佈前的雙重檢查

/optimize 提升 SEO 分、/scrub 清掉 AI 味

/optimize <file> 根據 SEO Quality Rating 模組補強 meta、內連、keyword density、readability；/scrub 則專門掃掉過度通用的 AI 語氣（「In today's fast-paced world…」、冗詞、假設性副詞）。雙刀流讓文章看起來像人寫的，不是 GPT 預設。

SEO 補強去 AI 味 readability 優化

Module SEO Quality Target Readability

TheCraigHewitt / seomachine — /publish-draft

Claude 直接推上 WordPress

附 Yoast SEO metadata、featured image、category

透過 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 讀 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 + 側邊 Feature Snippet + PAA 問題樹

不只讀標題。/research-serp <keyword> 同時抓 featured snippet、People Also Ask、image pack、video pack、knowledge panel，然後輸出「這個關鍵字在 Google 眼中到底要答什麼」的結構化摘要。多數 AI 工具還停在抓 TOP 10 標題時，它已經在還原搜尋意圖本身。

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

Data DataForSEO Output Intent Map Inputs Keyword

TheCraigHewitt / seomachine — /research-gaps

找出對手排得到、你沒寫的文章

Content Gap Analysis — 一個指令找 100 個新題目

讀 config/competitors.yml 裡列的 3–5 個競品網域，比對 GSC 中你的現有關鍵字，找出「對手有排名、你零流量」的題目清單，依難度與商業價值排序。不再需要 Ahrefs Content Gap 的手工操作。

Gap Analysis 難度排序商業價值

Config competitors.yml Pairs With /write

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

長期選題雷達

Trending 捕流量浪、Topics 建 cluster 深度

/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 稽核也能交給 Claude

10 個代理其中一位是「CRO Analyst」

/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 輸出 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 完只是起點。以下五個技巧來自對 README 與 .claude/ 目錄的實際解讀 — 能把 Claude 從「寫得還行」拉到「寫得像你們家專欄作者」。

先餵飽 `context/` 目錄，再執行任何指令

brand.md / examples/ / keywords.md 是 Claude 的口吻基因

倉庫裡 context/brand.md 定義品牌語氣、禁用詞、CTA 模板；context/examples/ 放 3–5 篇「我們家寫得好的文章」供模仿；context/keywords.md 列長尾關鍵字池。這三檔不先填，/write 的輸出就只是通用 AI 稿，填了才是「你們家風格」。

brand.md examples/ keywords.md

Priority Step 0 Affects 所有輸出

設定 `config/competitors.yml` ，Gap Analysis 才有對手

3–5 個網域就夠，多了訊號雜亂

/research-gaps 與 /landing-competitor 都會讀這個檔。建議放 2 個直接競爭者 + 2 個間接 thought leader + 1 個 alternative 比較站。超過 5 個反而讓 Claude 找不到差異化切入，輸出題目會變散。

competitors.yml 2 + 2 + 1 聚焦

File config/ Sweet Spot 3–5

把 Python 模組當 Claude 的延伸大腦

5 個 data_sources/ 模組 = 5 個專業工具

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

跑一條每月節奏的 Loop

/priorities → /rewrite → /optimize → /publish-draft

最有效的月循環：月初跑 /priorities 讀 GSC 60 天資料，挑出排名在 4–15 名的舊文；接著 /rewrite 改寫、/optimize 補強、/publish-draft 覆蓋發佈。SaaS 客戶實測能把 4–15 名的文章在 30 天內推進前 3，不用新寫內容就能拉長尾流量。

4 步 Loop 月循環不寫新文章

Cadence Monthly Target Rank 4–15 → 1–3

把 26 個行銷 Skill 當精細調整工具

.claude/skills/ 裡還有 copywriting、CRO、pricing 可用

除了 20 個 slash command，.claude/skills/ 裡還塞了 26 個行銷 Skill — 當 /write 產出的草稿語氣太硬，可以呼叫 copywriting-skill 細調；要寫定價頁再叫 pricing-strategy-skill；A/B 測試設計找 ab-testing-skill。把它們想成「Claude 的行銷 SDK 函式庫」。

26 Skills Fine-Tune Marketing SDK

Path .claude/skills/ Count 26

05 / 資料與發佈 GA4 · GSC · DATAFORSEO · YOAST · PYTHON MODULES

資料層與發佈

這層決定 SEO Machine 是「又一個 AI 寫稿工具」還是「真的有資料依據的內容作業系統」。Python 分析模組 + 三組搜尋資料 API + WordPress REST 全鏈封閉循環。

5 Entries
Data · Publish · Analysis
Python 99%

01^/05

TheCraigHewitt / seomachine — data_sources/

Python 的五個大腦模組

Search Intent · Keyword Density · SEO Quality · Length · Readability

這才是 SEO Machine 跟其他 AI 寫稿工具拉開距離的地方：Search Intent Classifier（scikit-learn）、Keyword Density Analyzer、SEO Quality Rating（輸出 0–100 分）、Content Length Comparison（對標 TOP 10 平均）、Readability Scoring（textstat）。不是靠 prompt 感覺，是靠程式算。

✓ 可程式驗證 sklearn textstat 0–100 評分

Modules 5 Core Lang Python 99% Tests Scriptable

Integration — Google Analytics 4 API

讀你自己的流量曲線再下筆

不是通用建議，是你這個月的真實數據

透過 GA4 Data API，/performance-review 讀取 pageview、unique user、avg session duration、bounce rate。Claude 能區分「排名第 3 但跳出率 80%」的文章需要重寫內文、跟「排名第 12 但停留 5 分鐘」的文章只需要補連結。

GA4 Data API Session Quality Bounce Analysis

Source Google Consumer /performance-review

Integration — Google Search Console API

曝光、點擊、排名 — SEO 的三原色

/priorities 的主要資料源

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

第三方SERP 與關鍵字資料

SERP / Keyword / Backlink 三大雲端資料集

比起自架 SerpAPI，DataForSEO 提供穩定的 TOP 100 SERP 結構化資料、關鍵字搜尋量、相關關鍵字、backlink profile。/research-serp、/research-trending、/research-gaps 都靠它。每次呼叫成本約 $0.002–$0.01，比 Ahrefs 企業版便宜 2 個量級。

TOP 100 SERP Keyword Volume 低成本

Source DataForSEO Cost $0.002+/call

TheCraigHewitt / seomachine — wordpress/ MU-plugin

WordPress REST + Yoast 一體化發佈

MU-plugin 把 Claude 草稿直接變 Gutenberg block

倉庫裡附的 MU-plugin 解決兩個痛點：一是把 Markdown 精準轉成 Gutenberg block（含 heading、list、image 區塊），二是暴露 Yoast SEO 的 focus keyword / meta / Schema 欄位到 REST API 讓 /publish-draft 可寫。這是多數「AI 寫完手動貼 CMS」卡關的關鍵一步。

MU-plugin Gutenberg Yoast REST

Type MU-plugin Output Gutenberg

06 / 社群觀察 SEARCH ENGINE LAND · SEOMACHINE.IO · FORKS · CASTOS

為什麼 SEO 社群在追這個倉庫

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"

Search Engine Land — 全球 SEO 從業者必讀的產業媒體 — 在 How to turn Claude Code into your SEO command center（searchengineland.com/claude-code-seo-work-470668）中，把 SEO Machine 當作「Claude Code 如何變成 SEO 指揮中心」的最佳實作案例。傳統 SEO 工具品牌少能取得這種等級的社論背書。

Search Engine Land 業界社論 Article 470668

Outlet SEL Stance 參考實作

有自家官網與說明書，不只是 README

seomachine.io · thecraighewitt-seomachine-70.mintlify.app

作者把倉庫認真當產品經營：seomachine.io 上線為官方 landing page；Mintlify 架了獨立說明書（thecraighewitt-seomachine-70.mintlify.app），含 Quick Start、Commands Reference、Data Source 設定教學。這是「這不是一次性 side project」的強訊號。

seomachine.io Mintlify 說明書持續維運

Landing .io Docs Mintlify

919 次 fork 的底層訊號

fork:star 比 = 13.7% — 遠高於同類倉庫

6,688 顆星、919 次 fork 換算 13.7% 的 fork:star 比，比多數「觀賞用」的 awesome 清單高出 3–5 倍。說明大量使用者不是按完星就走，而是實際 clone 下來客製化成自家內容團隊用的版本。GitHubGPT 在倉庫 3,766 顆星時就已做過公開介紹。

★ 6,688 919 forks 13.7% ratio

Fork Ratio 13.7% Signal 實際使用

作者是 Castos 創辦人，這不是業餘 repo

服務 40,000+ 品牌的 SaaS CEO 開源自家 SOP

Craig Hewitt 是 Castos（podcast 寄存 SaaS，服務超過 40,000 個品牌）的創辦人兼 CEO，也曾創 PodcastMotor，製作逾 500 集 podcast。repo 裡的 examples/castos/ 目錄直接放了 Castos 自家使用痕跡 — 這份 SOP 先在付費 SaaS 的 blog 跑了幾年，才開源出來。

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