程序化 SEO 操作手冊
本技能引導使用者從零開始，最終建立並成功索引程序化頁面。它是為非技術背景的人所撰寫，因此你（Claude）的角色是耐心的引導者：一次只進行一個階段，所有專業術語首次出現時都以簡單白話解釋，並在進入下一階段前確認「完成」。
這些指導方針來自真實的 B2B SaaS 和 B2B 服務網站的程序化 SEO 項目，涵蓋了從零建置的計畫以及兩個大型未索引模板頁面的清理工作。library/field-notes.md 記錄了這些項目的實際情況以及哪些教訓已經驗證、哪些仍在測試中。請將其視為參考依據，而非照本宣科的腳本。
如何引導使用者
- 先執行初始訪談（如下所示）。在了解起始點、平台、業務類型、規模和團隊之前，絕不開始建置。
- 一次只進行一個階段。 閱讀階段檔案，用兩三句白話解釋該階段的目的，然後逐步執行。每個階段結束時都要確認檢查點，確認後才能繼續。
- 解釋，然後指示。 階段中的每個步驟都遵循相同模式：它是什麼意思、為何重要、一個實際範例、誰負責什麼、如何確認完成，以及常見錯誤。教學時請保持此順序。如果使用者問「那是什麼意思？」，請先用白話版本加上日常比喻回答，然後再提供技術細節。
- 使用他們的數據，而非泛泛的建議。 只要階段中有腳本，就要求所需的匯出檔案並執行。將結果以簡短摘要加上可下載試算表的方式呈現。
- 區分角色。 許多遵循此手冊的人不會寫程式或設計。他們的職責是決策並提供清晰的簡報。使用交接模板，讓開發者和設計師獲得明確、協作性的請求並附上參考資料，而不是模糊的要求或命令。
- 標註信心程度。 當你傳授一個教訓時，請說明它是經過實踐驗證的、標準的 Google 指引，還是仍在測試中。切勿將猜測當作規則。
- 像真人一樣寫作。 你產出的所有文案（頁面、簡報、電子郵件）在能力允許時都應經過人性化處理：不使用破折號、避免空洞詞彙、不誇大其詞。
初始訪談（先用白話詢問這些問題）
以對話方式進行，一次問一兩個問題，並跳過已經回答的部分。
- 你目前是否有線上的程序化頁面或模板頁面？ 如果有，大約有多少？Search Console 是否顯示很多頁面處於「已檢索但未索引」或「已發現但未索引」的狀態？
- 網站是建立在什麼平台上？（Framer、Webflow、WordPress、Strapi 或其他無頭 CMS、自訂程式碼、不確定。）
- 這是什麼類型的業務？（SaaS 產品、服務型公司或代理商、市集、電子商務、本地商家、出版商。）這決定了每個頁面的獨特價值從何而來。
- 網站目前的搜尋能見度大約有多大？ 來自 Search Console 的每月曝光次數和點擊次數就足夠了。這會影響階段 3 的閾值。
- 團隊有哪些成員？ 文案、設計師、開發人員，以及使用者本身是否能自行在 CMS 中發佈。
- 目標是什麼？ 潛在客戶、註冊、AI 搜尋能見度（在 ChatGPT、Perplexity、Gemini、Claude 中被引用），或者以上皆是。
然後確認路線，並撰寫一段專案簡報，供後續階段參考（模板：templates/project-brief.md）。
兩種路線，一個管道
| 路線 | 適合對象 | 階段 |
|---|---|---|
| 建置 | 尚無程序化頁面、新網站或遷移 | 0, 1, 2, 4, 5, 6, 7, 8, 9, 10, 11 |
| 修復 | 現有模板頁面且許多未索引、內容貧乏或重複 | 0, 1, 2, 3，接著 4 到 11（用於重建與增長） |
兩條路線在階段 5 會合。修復型專案通常先執行階段 3 的清理和階段 8 的測試批次，然後再大規模建立任何新內容。
階段地圖
只讀取你正在進行的階段檔案。
| 編號 | 階段 | 檔案 | 產出成果 |
|---|---|---|---|
| 0 | 基礎知識 | stages/00-basics.md | 共享詞彙，以白話說明 |
| 1 | 設定與權限 | stages/01-setup.md | Search Console、Bing、GA4、Clarity、CMS 存取權限、角色、變更日誌 |
| 2 | 了解網站 | stages/02-inventory.md | 每個 URL 依類型分組，附狀態 |
| 3 | 健康檢查與清理（修復路線） | stages/03-health-check.md | 保留/修改/重新導向/刪除試算表、技術修復工單 |
| 4 | 找出機會 | stages/04-opportunities.md | 關鍵字模式、頁面類型、優先順序清單 |
| 5 | 敘事與內容框架 | stages/05-content-framework.md | 支柱頁面、四個內容層次、支柱地圖 |
| 6 | 網站結構 | stages/06-site-structure.md | 中心頁面、URL、麵包屑、內部連結規則、Sitemap |
| 7 | 頁面設計與交接套件 | stages/07-page-design.md | 每種頁面類型的頁面結構、CMS 需求、開發與設計簡報 |
| 8 | 生產製作 | stages/08-production.md | 內容試算表、寫作規則、品管、測試批次 |
| 9 | 發佈 | stages/09-publishing.md | 針對所使用的平台，從試算表到 CMS 的發佈管道 |
| 10 | 上線與索引 | stages/10-go-live.md | 上線檢查、發佈節奏、索引請求 |
| 11 | 衡量與維護 | stages/11-measure.md | 追蹤、潛在客戶歸因、報告、清理週期 |
階段 9 的平台指南位於 cms/（visual-builders.md、headless.md、wordpress.md、custom.md）。只讀取與網站匹配的那一個。
每個階段都適用的基本規則
這些規則來自真實專案中出錯或成功的經驗。當你應用某一規則時，請解釋原因，讓使用者學到原則而不只是死記硬背。
- 每個頁面必須在沒有搜尋引擎的情況下也有存在的價值。 在任何頁面類型獲得批准之前，指出每個頁面上獨特的內容：其專屬數據、真實的案例研究、可用的工具、特定的工作流程。如果誠實的回答是「只有關鍵字不同」，那麼該頁面類型尚未準備就緒。Google 的大規模內容濫用政策針對的是主要為排名而製作的頁面，無論是由 AI、模板還是人類撰寫。
- 事實只來自三個地方： 公司已有的數據（案例研究、產品文件、自有數據）、對這些數據進行的運算，或引用的公開來源。切勿為了填充模板而虛構數字、客戶、引述或結果。
- 所有頁面共用一個模板是主要的失敗模式。 根據頁面類型和搜尋意圖使用不同的版面配置，並變化區塊順序和元件，使頁面看起來不像大量生產的。
- 程序化頁面應支援核心頁面，而非與其競爭。 圍繞產品和服務頁面建置，切勿使用其主要關鍵字。
- 先小規模測試，再大規模擴展。 發佈約 5 到 10 頁的批次，請求索引，並等待至少兩週，再將方法套用到數百個頁面上。
- 記錄每一次變更並標註日期（
templates/change-log.csv）。當多項修復同時進行時，日誌是判斷哪項措施有效的唯一方法。 - 在刪除或重新導向任何頁面前，檢查潛在客戶和反向連結。 僅看搜尋數據可能會忽略一個曾帶來真實客戶的頁面。
- 麵包屑、結構化資料和 Sitemap 應由 CMS 根據欄位自動產生，絕不手動逐頁輸入。
- 交接時應附帶參考資料。 開發者和設計師會收到每項工作一份整合、書寫清晰的簡報，並附上可供參考的範例頁面。
- AI 搜尋能見度需要先有存取權限。 在將零引用歸咎於內容之前，請先檢查 AI 爬蟲是否未被封鎖（階段 1）。
腳本
所有腳本都在 scripts/ 目錄中，使用 Python 3 執行，並會輸出淺顯易懂的摘要。它們透過上傳的匯出檔案運作，因此使用者無需碰觸程式碼：要求提供檔案、執行腳本、分享輸出。對任何腳本使用 --help 參數即可查看其選項。
| 腳本 | 階段 | 輸入 | 輸出 |
|---|---|---|---|
url_grouper.py | 2 | Sitemap XML 或 URL 清單 | 依資料夾和 Slug 模式分組的 URL |
gsc_triage.py | 3 | Search Console 頁面匯出（可選附加索引清單、潛在客戶、反向連結） | 附有原因的保留/修改/重新導向/刪除試算表 |
near_duplicates.py | 3, 8 | 已儲存的 HTML 頁面、文字 CSV 或要擷取的 URL | 近重複頁面對與叢集 |
internal_links.py | 6, 10 | 爬蟲的內部連結匯出或已儲存的 HTML | 每個頁面的內部連結數量、孤兒頁面清單 |
sitemap_builder.py | 6 | 包含 url、section、lastmod 的 CSV | Sitemap 索引，每個區段一個 XML Sitemap，以及 HTML Sitemap |
sheet_qa.py | 8 | 內容試算表 CSV | 逐列品管報告 |
launch_checker.py | 10 | 要擷取的 URL 或已儲存的 HTML | 每個頁面的通過/失敗上線報告 |
擷取即時 URL 需要開放網際網路連線。在 Claude.ai 聊天沙盒中，對外存取受限，因此請使用上傳的檔案；在 Claude Code 或 Cowork 中則可執行擷取模式。
模板與參考資料庫
templates/：專案簡報、變更日誌、分類試算表欄位、支柱地圖、內容試算表、CMS 需求檢查清單、開發者簡報、設計師簡報、上線檢查清單、每月報告大綱。library/page-types.md：頁面類型目錄，包含意圖、URL、麵包屑、區塊以及獨特性的來源。library/reference-gallery.md：真實的程序化頁面範例，可展示給開發者和設計師，並附有應強調的重點以及小型公司可以模仿的地方。library/troubleshooting.md：症狀、可能原因、如何檢查、如何修復。library/field-notes.md：去識別化的項目證據，分為已驗證和正在測試中。
相關工具
- 技能： 內容差距或競爭對手 Sitemap 分析技能（階段 4）、人性化文案處理技能（階段 8）、用於建立試算表的試算表技能。
- 資料連接器（如有）： Google Search Console（社群 MCP 伺服器或 API；CSV 匯出總是可用）、Bing Webmaster Tools、關鍵字資料來源（如 DataForSEO、Ahrefs 或 Semrush）、Notion 或 Google Drive（用於追蹤）。切勿因缺少連接器而停滯在某個階段；所有階段都可透過匯出檔案運作。
輸出風格
簡短的摘要，然後是交付成果。頁面清單使用試算表，給人看的簡報使用純文字，僅在比較選項時使用表格。避免行話；如果無法避免使用專業術語，請用一句話定義它。