programmatic-seo

概觀

programmatic-seo 技能的作用

programmatic-seo 技能可協助你運用模板與結構化資料，在大規模下設計 SEO 最佳化頁面。你不必逐頁手寫，而是透過這個技能規劃可重複的頁面類型——像是「[keyword] + [city]」頁、以產業為主題的登陸頁、比較頁、整合頁、目錄頁與個人/公司資料頁——同時確保每一頁都能提供獨特價值。

這個技能專注在 策略與結構，而非撰寫文案或部署程式碼。它會引導你：

• 找出可行的 programmatic SEO 機會
• 選擇正確的策略模板（templates、locations、comparisons、integrations、directories 等）
• 定義資料需求，確保每一頁都有實質且不薄弱的內容價值
• 規劃 URL 結構、站內連結與索引策略
• 避免重複或近似重複內容導致搜尋表現不佳

適合使用這個技能的人

如果你符合以下情況，可以使用 programmatic-seo 技能：

• SEO 專家與成長行銷人員：計畫為產品或交易平台建立數百甚至上千個登陸頁
• 內容與產品行銷人員：想規劃可擴充、導向轉換的內容（例如「CRM for [industry]」頁、「best [category]」主題站，或整合目錄）
• 創辦人與產品團隊：想透過 programmatic SEO 拓展潛在客戶，而不需要大規模的內容團隊

如果你只是需要高層級的 SEO 策略或一般內容規劃，可以先從 seo-audit 或 content-strategy 開始。當你明確需要大規模、模板化、以資料驅動的登陸頁時，再使用 programmatic-seo。

programmatic-seo 技能要解決的問題

這個技能專為解決 programmatic SEO 常見難題而設計：

• 薄內容風險 – 它會推動你為每一頁定義獨特價值，而不是只在模板中替換城市或產業名稱。
• 「我們到底該做什麼樣的頁面？」 – 它運用 references/playbooks.md 中驗證過的 programmatic SEO 策略模板（templates、locations、comparisons、personas、integrations、directories、profiles 等），將模式對應到你的資產與受眾。
• 「這麼多 URL 和連結要怎麼規劃結構？」 – 它鼓勵使用乾淨的 URL 模式（像是 /templates/[type]/、/best/[category]/ 或 /locations/[city]/），並規劃站內連結策略。
• 「我們實際需要哪些資料？」 – 它會幫你釐清需要哪些專有或精選資料，才能讓每一頁都真正好用。

如果你的主要目標只是「自動大量產文」而沒有策略或獨特資料，這個技能就不太適合；它的設計重點是內容品質與實用性，而不是單純追求頁數。

核心概念與 Repo 結構

在 programmatic-seo 技能目錄中，你會看到：

• SKILL.md – 核心策略文件，內容包含：
  • 初步評估問題（商業模式、受眾、轉換目標）
  • 機會與競爭分析提示
  • 核心原則，如每頁要有獨特價值與善用專有資料
• references/playbooks.md – 「The 12 Programmatic SEO Playbooks」，收錄實務上的模式，例如：
  • Templates（如 resume templates、invoice templates）
  • Curation（如「best [category]」）
  • Comparisons（如「Notion vs Asana」）
  • Locations、Personas、Integrations、Directory、Profiles 等
• evals/evals.json – 範例提示與預期行為，展示這個技能在常見情境下應如何回應（例如 CRM for [industry] 頁面、針對多個競品的比較頁）。

理解這些檔案，可以幫助你快速判斷這個技能是否符合你的 programmatic SEO 目標。

使用方式

安裝與設定

1. 安裝 programmatic-seo 技能

在你的 agent 環境中加入此技能，執行：

npx skills add https://github.com/coreyhaines31/marketingskills --skill programmatic-seo

這會從 coreyhaines31/marketingskills 把 programmatic-seo 的設定與相關參考檔拉進你的 skills 設定中。

2. 檢視核心說明檔案

安裝完成後，先開啟以下檔案，了解技能的運作方式：

• SKILL.md – 從頭到尾讀一遍。它會定義 agent 在 programmatic SEO 上的角色，並說明：
  • 如何檢查產品行銷脈絡
  • 如何評估商業與搜尋機會
  • 避免薄內容的原則
• references/playbooks.md – 瀏覽 12 個 programmatic SEO playbook，並記下哪些模式適合你的業務（templates、curation、locations、personas、comparisons、integrations、glossary、directory、profiles 等）。
• evals/evals.json – 檢視範例提示（例如「CRM for [industry]」頁面、多競品比較頁），了解技能預期的思考與回應方式。

如果你的 repo 已包含 .agents/product-marketing-context.md（或舊版設定中的 .claude/product-marketing-context.md），請確認內容正確且為最新；這個技能會優先讀取該檔案，作為建議的基礎脈絡。

為新專案執行 programmatic-seo

1. 蒐集產品與受眾脈絡

在請 agent 設計 programmatic SEO 策略之前，先準備好：

• 你的產品／服務的簡短描述
• 主要目標受眾或分眾
• 核心轉換目標（試用註冊、Demo 預約、購買、訂閱電子報等）

技能會根據這些輸入（如 SKILL.md 所示）來避免產出制式化的泛用模板，而是針對你的實際漏斗情境客製化構想。

2. 定義 programmatic SEO 機會

當你有明確且可擴充的模式時，就可以啟用這個技能，例如：

• 「我們想為 20 個產業做『CRM for [industry]』頁面。」
• 「我們想為 15 個競品做『[Our product] vs [Competitor]』比較頁。」
• 「我們想做一個『[service] providers in [city]』的服務提供者目錄頁。」
• 「我們想做像『invoice template』『quote template』這類模板頁。」

技能會：

• 判斷這屬於哪種 playbook（例如 Personas、Comparisons、Locations、Templates、Directory）
• 詢問任何缺少的關鍵脈絡
• 提出一份結構化計畫：關鍵字模式、資料需求、模板區塊、站內連結與索引策略

3. 選擇並優化你的 playbook

利用 references/playbooks.md，技能可以：

• 選出一種或多種符合你構想的 playbook
• 說明為什麼特定模式適合你的利基市場
• 梳理價值要求（例如 Templates：要有實際可下載的檔案、多種變化、良好品質；Curation：需要清楚的評選標準與定期更新）

接著你可以微調方向，例如：

• 從單純的「Locations」擴展為 Locations + Directory（例如每個城市都有一個服務提供者目錄）
• 結合 Comparisons + Conversions（例如比較頁同時強化 CTA，導向試用或註冊）

4. 規劃資料與內容結構

programmatic-seo 的核心目標是 每頁都有獨特價值。實務上，技能會幫助你：

• 列出每頁需要蒐集或產生的資料點（例如各產業痛點、城市層級統計數據、不同垂直市場的功能使用情況）
• 將這些資料對應到模板中的各個區塊（Hero 區、社會證據、比較表、FAQ、本地或分眾細節）
• 決定專有資料、真實案例或精選觀點該放在哪些區塊，避免頁面只是把關鍵字或城市名稱換一換的空泛文案

這一步對於是否要安裝此技能特別關鍵：它能幫你看清楚，你是否擁有足夠的結構化資料，讓 programmatic SEO 值得投入。

5. 規劃 URL 與站內連結策略

根據 references/playbooks.md 裡的範例，技能可以建議：

• URL 結構，例如：
  • /templates/[type]/ 或 /templates/[category]/[type]/
  • /best/[category]/
  • /locations/[city]/
  • /integrations/[tool]/
• 站內連結模式，例如：
  • 從每個產業頁連回核心的「Industries」樞紐頁
  • 從比較頁連回主要產品頁與價格頁
  • 從目錄項目連回城市頁，並從城市頁連回目錄項目

在正式建置前先完成這一步非常重要，因為日後若要重構大量 URL，成本會非常高。

6. 依照評測情境檢查計畫

使用 evals/evals.json 中的範例作為檢查清單：

• 你是否有檢查既有的產品行銷脈絡？
• 你是否確實套用核心原則（獨特價值、專有資料、乾淨 URL）？
• 你是否針對每一種變化規劃關鍵字研究與資料蒐集？
• 你是否納入站內連結策略，並對薄內容提出警示？

如果你的計畫無法通過這些檢查，請重新檢視資料模型或縮小範圍，直到每一頁都能真正「站得住腳」。

什麼情況適合（或不適合）使用這個技能

適合使用 programmatic-seo 技能的情況：

• 你有可重複的頁面類型，可擴展成大量變化（locations、industries、integrations、use cases、templates、profiles 等）
• 你能取得或建立結構化資料，讓每個變化都有實質差異
• 你想要一套用於高意圖、以轉換為中心的登陸頁策略藍圖

可能不太適合的情況：

• 你只需要少數幾個單次性的登陸頁（可以用一般 landing page 技能或手動內容即可）
• 你缺乏任何可創造獨特價值的資料或切角，只是想讓「AI 幫你生 1,000 個頁面」——這個技能就是為了避免這種情況而設計
• 你的主要需求是技術性 SEO 稽核或全站問題排查（此時請改用 seo-audit）

常見問題（FAQ）

programmatic-seo 技能的主要目的是什麼？

programmatic-seo 技能的設計目標，是幫助你規劃與架構 programmatic SEO 專案——也就是一大組模板化、以資料驅動的登陸頁，既能取得排名又能帶來轉換，同時盡量降低薄內容與低價值內容的風險。它聚焦在策略、資料設計與頁面結構，而不是自動發布頁面。

我要如何安裝 programmatic-seo 技能？

透過 Skills CLI 安裝：

npx skills add https://github.com/coreyhaines31/marketingskills --skill programmatic-seo

接著到 skills/programmatic-seo 目錄中，閱讀 SKILL.md、references/playbooks.md 以及 evals/evals.json，了解這個技能將如何影響你的 agent 行為。

我可以用 programmatic-seo 設計哪些類型的頁面？

透過 references/playbooks.md 中的 playbook，這個技能特別適合用在以下模式：

• Templates（例如「invoice template」、「resume template」）
• 精選列表／策展內容（例如「best [category]」、「top [number] [tools]」）
• Comparisons（例如「[Product] vs [Competitor]」）
• Locations（例如「[service] in [city]」）
• Personas 或產業（例如「CRM for [industry]」）
• Integrations（例如「[Product] + [Tool]」頁面）
• Directories 與 profiles（例如交易平台、專家目錄）

這個技能會協助你選擇並組合上述模式，與你的產品定位與資料條件對齊。

這個技能如何幫助在 programmatic SEO 中避免薄內容？

SKILL.md 強調 每一頁都必須有獨特價值，尤其要善用專有資料、真實案例或有意義的策展內容。藉由 evals/evals.json 的設計，技能會檢查自己是否：

• 先釐清可用來區隔每一頁的資料需求
• 對於只是在模板中替換關鍵字或城市名稱的做法提出警示
• 鼓勵使用乾淨、有目的的 URL 與站內連結結構

若你的計畫無法達到這些標準，技能會引導你縮小範圍或強化資料規劃，再考慮擴大規模。

我可以把 programmatic-seo 用在已有大量表現不佳頁面的網站上嗎？

可以，但這個技能主要著重在設計或重新設計結構化的頁面類型，而非處理技術性問題。你可以：

• 用它重新思考現有的頁面模式（例如地區頁或產業頁），並對照 playbook 調整
• 重新定義模板與資料需求，讓每一頁變得更有價值

若是爬蟲、索引或整體網站健康檢查等問題，建議搭配 seo-audit 技能一起使用。

programmatic-seo 與一般內容策略技能有什麼不同？

content-strategy 著重在整體編輯規劃：主題、內容形式與內容行事曆。
programmatic-seo 則專注在可重複、以資料為後盾的模板（像目錄、比較頁與地區頁），以及讓這些模板可以規模化的系統。當你的問題是「我們要怎麼設計數百個既有 SEO 效益又真的有用的登陸頁？」時，請用 programmatic-seo；當你想的是「這一季我們部落格要寫什麼主題？」時，則使用 content-strategy 更合適。

在使用 programmatic-seo 前，我需要先具備什麼？

如果你已經具備以下條件，會更容易發揮這個技能的價值：

• 清楚的產品定位與目標受眾
• 至少一種可重複的頁面模式（例如產業、城市、競品、模板等）
• 某種形式的結構化資料，或有能力蒐集資料（例如內部指標、市集列表、策展清單或研究資料）

若這些條件尚未完全備齊，你仍然可以先安裝技能，用來找出目前的缺口，但在真正展開完整的 programmatic SEO 專案前，可能還需要進一步準備與補強。