自然成長 (Organic Growth)
請依照 PLAYBOOK.md 中的系統對目前專案進行操作。一開始先讀取 PLAYBOOK.md 一次，然後只在進入使用相關模組的階段時才讀取該模組。將所有發現寫入專案中的 docs/seo/ 目錄（從 templates/ 複製範本），並在每個階段完成後進行提交。
地圖
| # | 階段 | 讀取 | 專案中的輸出 |
|---|---|---|---|
| 0 | 偵察 + 基線 | PLAYBOOK.md §0 | docs/seo/00-baseline.md |
| 1 | 技術 SEO | checklists/technical-seo.md | 程式碼 + seo.config.mjs |
| 2 | Search Console + Bing | checklists/search-console.md | 基線數據 |
| 3 | 研究：趨勢、支付意願、自動完成、Ahrefs/Semrush、Search Console、來源 | modules/research.md | docs/seo/research/*.md、09-sources-log.md |
| 4 | 成長計劃 | modules/pseo-2.md、modules/tool-led-seo.md、modules/money-pages.md、modules/linkable-assets.md | docs/seo/03-seo-plan.md |
| 5 | 清理 + 建構 | PLAYBOOK.md §5、簡報 04/07/08 | 頁面、重新導向、05-consolidation-map.md |
| 6 | GEO + 轉換 | modules/geo-ai-search.md、modules/seo-to-revenue.md | robots.txt、頁面形狀、CTA、事件 |
| 7 | 上線 + 衡量 | PLAYBOOK.md §7 | docs/seo/06-launch-log.md |
使用者可以只要求其中一部分（例如「只要工具 SEO」、「稽核我的網站」、「pSEO 計劃」）。此時只需執行該階段，但建議還是先快速執行階段 0。
先詢問（僅限程式碼無法判斷的事項）
- 正式網域與偏好的主機名稱（apex 或 www）。
- **目標國家與語言。**切勿根據創辦人的所在地來假設。
- Search Console / 分析工具的存取權限。
- 付費關鍵字工具（Ahrefs、Semrush）。螢幕截圖或匯出資料即可。
- 網站上的任何評分、評論數量或「已被使用」的宣稱是否屬實？
腳本（Node 18+，無外部依賴；位於 scripts/）
| 腳本 | 用途 |
|---|---|
check-live.sh <url> | 爬蟲從即時網站取得的內容：重新導向、404、robots.txt、Sitemap、每個頁面的標題/標準網址/H1（不執行 JS） |
prerender.mjs --config seo.config.mjs | SPA → 每個路由的靜態 HTML + 404.html + spa.html + sitemap.xml |
audit.mjs <dist> --base <url> | 檢查建構後的 HTML：標題、描述、標準網址、H1、薄內容頁面、JSON-LD、Sitemap 一致性、評分 schema |
overlap.mjs <dist> --prefix /<cluster>/ | 重複內容品質門檻：5 詞 shingle Jaccard 相似度，需 <40% 且 ≥800 詞 |
autocomplete.mjs "<seed>" --gl us,gb,au --expand | 各國的即時 Google 自動完成查詢（需求證據） |
學到的硬道理
- **使用目標市場的語言進行研究。**錯誤國家的自動完成曾導致產生一整批錯誤市場的頁面。
- 將每次研究結果儲存為
docs/seo/research/中帶有日期的檔案，並將每個頁面上的事實記錄在09-sources-log.md中（法律事實的官方來源；競爭對手的事實需標註日期並每 90 天重新檢查；無法驗證的宣稱則不予採納）。 - Ahrefs 的免費工具需要通過人機驗證，使用者必須自行通過。請要求提供螢幕截圖，切勿嘗試繞過。
- **頁面之所以存在，是因為有需求存在。**每個計劃中的頁面都必須註明其需求證據。
- **品質門檻非選擇性。**與同類頁面的重疊度 <40%、字數 ≥800 字、擁有自己的數據/工具/輸出。範本化的
{city}替換會獲得noindex標記並從 Sitemap 中移除。大規模內容懲罰會影響整個網域。 - **工具是頁面，不是小工具。**每個工具都需要獨特的編輯指南、FAQ 和結構化資料，並以靜態 HTML 呈現，否則就是薄內容頁面。
- **頁面要少，深度要深。**將薄內容文章合併成深度指南，並將所有舊網址以 301 重新導向。
- **不得使用捏造的數字或虛假的社群證明。**價格必須有來源或在頁面上計算；競爭對手的事實需標註日期；僅在所有者確認屬實時才使用評分 schema。
- 爬蟲（以及 AI 爬蟲）必須能在不執行 JavaScript 的情況下看到內容。
- 一個主機、一個網址、真實的 404 頁面、一份與頁面資料來源一致的 Sitemap。
- 以 10–20 頁為一批次上線；僅擴展能獲得流量的部分。
- 每個頁面都應以相關的 CTA 結尾；並按頁面群組追蹤轉換。
工作風格
- 會影響正式環境的變更（重新導向、robots.txt、noindex、刪除頁面）必須先獲得使用者的一行確認，並附上清單。
- Search Console、DNS 和分析點擊行為屬於使用者；請提供確切的步驟。
- 每次建構後執行
audit.mjs，每次部署後執行check-live.sh，並貼上摘要。 - 將帶有日期的數據記錄在
06-launch-log.md中，以便下次會話時進行比較。
框架支援
prerender.mjs 適用於客戶端渲染的 SPA（Vite、CRA、React Router）。Next.js、Astro、Nuxt、SvelteKit、Remix：請使用它們的 metadata API 和 Sitemap 外掛，並仍然在 build 輸出上執行 audit.mjs。WordPress/Webflow/Shopify：跳過階段 1 的程式碼，使用 check-live.sh 針對即時網站執行檢查清單。