SEO Machine 是一個完整的 workspace，而非提示詞集。
編者手記
六段循環涵蓋 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 無縫走完。
核心 工作流
10 個 slash command 涵蓋完整長文內容流水線，包含主題優先順序、草稿生成、既有文章分析、SEO 品質評分、優化、發佈與事後復盤。
核心工作流
RESEARCH → WRITE → OPTIMIZE → PUBLISH
排名 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/ 輸出
- /
- 06
- Agents
- 4 Parallel
- Output
- drafts/
- Length
- 2.5k–4k
排名 02
TheCraigHewitt / seomachine — /researchSERP 偵察：讀 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-draftMarkdown 草稿直接發佈到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
研究與稽核
5 個 /research-* 專攻選題與缺口，5 個 /landing-* 把 CRO 思維接進落地頁優化。兩組搭配等於「上游選題 + 下游轉換」雙管齊下。
研究與稽核
SERP · GAPS · TRENDING · LANDING PAGE CRO
排名 01/05
TheCraigHewitt / seomachine — /research-serpSERP 逆向工程：擷取 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
- /
- 05
- Data
- DataForSEO
- Output
- Intent Map
- Inputs
- Keyword
排名 02
TheCraigHewitt / seomachine — /research-gapsContent 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-topics 從 context/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
五個配置步驟，讓 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
資料層與發佈
此層涵蓋 5 個 Python 分析模組、3 組搜尋資料 API，以及 WordPress REST 整合。三者共同構成從資料讀取到發佈的完整封閉循環，是 SEO Machine 與一般 AI 寫稿工具的主要差異。
資料與發佈
GA4 · GSC · DATAFORSEO · YOAST · PYTHON MODULES
排名 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 評分
- /
- 05
- Modules
- 5 Core
- Lang
- Python 99%
- Tests
- Scriptable
排名 02
Integration — Google Analytics 4 APIGA4 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
- Consumer
- /performance-review
排名 03
Integration — Google Search Console APIGSC API 提供曝光、點擊、平均排名資料
/priorities 的主要資料源，識別排名 4–15 名的改寫優先序
GSC Search Analytics API 回傳 query / page / country / device 維度的曝光量、CTR、平均排名。/priorities 依據「排名 4–15 名、曝光 > 1,000」等條件，輸出改寫優先序清單。改寫既有排名文章比新寫內容所需資源更少。
- 曝光 × CTR
- 4–15 名邏輯
- 不用寫新文
- Source
- Focus
- Rank 4–15
排名 04
Integration — DataForSEO APIDataForSEO 提供 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-pluginWordPress 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
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
四種團隊類型的導入建議
導入計畫
不需要一次用上全部 36 個指令。依目前流程中最需要改善的環節選擇路徑，兩週內可完成第一批 Claude 產出並發佈到 WordPress。
01 · 角色 · SOLO SAAS FOUNDER
兩週內完成首批 3 篇長文發佈
git clone 倉庫，填入 context/brand.md 與 examples/，申請 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.py 與 readability.py 作為 Pre-commit Hook 或 GitHub Action，所有 blog PR 先通過 0–100 分與 FK 指數檢核。Claude 提供建議，人工完成最終審查，審計記錄完整留存。