programmatic-seo

programmatic-seoスキルの概要

programmatic-seoスキルでできること

programmatic-seoスキルは、テンプレート、構造化データ、再利用可能なページパターンを使って、大量のSEOページ設計を進めるためのスキルです。対象になるのは、ロケーションページ、比較ページ、連携ページ、業界別ページ、ディレクトリ、用語集など、いわゆる「多数ページ型」のSEO施策です。こうした領域では、一般的なプロンプトだと薄いコンテンツになるリスクを見落としがちですが、このprogrammatic-seoスキルはその見極めに向いています。

programmatic-seoスキルを使うべき人

このprogrammatic-seoスキルが特に向いているのは、次のような人たちです。

• 数十〜数千規模のランディングページを企画しているマーケター
• pSEOを本当に作る価値があるか検証したい創業者・事業責任者
• ページタイプやURLパターンを検討しているSEO／コンテンツチーム
• 構造化データ、連携機能、活用例、独自アセットを持つプロダクト主導のチーム

一方で、数本の編集記事だけが必要な場合や、一般的なコンテンツカレンダー作成が目的なら、あまり向いていません。

本当に解くべきジョブ

多くのユーザーが欲しいのは、単なる「SEOページを100本作る案」ではありません。先に答えるべきなのは、むしろ次のような難しい問いです。

• どのページパターンなら実際に成立するのか
• 各ページが十分にユニークだと言える根拠は何か
• 実装前にどんなデータやアセットが必要か
• 薄いコンテンツを大量公開する事態をどう避けるか
• ページテンプレートを事業目標や内部リンク設計にどうつなげるか

こうした判断において、programmatic-seoは普通のブレスト用プロンプトより強みがあります。

このprogrammatic-seoスキルが他と違う点

このリポジトリでは、導入の早い段階で意思決定に重要な2つの前提を強く押さえています。1つは、各ページに本物の固有価値が必要だということ。もう1つは、単純なキーワード差し替えテンプレートより、独自データや実用的な機能を伴うページのほうが成果につながりやすいということです。さらに、references/playbooks.mdには具体的なpSEOのプレイブックがまとまっており、「スケーラブルなページを作ろう」といった曖昧な枠組みより、実務判断に使いやすくなっています。

programmatic-seoを使わないほうがいい場面

次のような場合は、programmatic-seoを使わないほうが適切です。

• 主な目的が既存SEO課題の監査である
• テンプレート型ページではなく、ブログ中心の上流コンテンツ戦略が必要
• 差別化要素が都市名・業界名・競合名の差し替えしかなく、実質的な内容差がない
• 構造化された入力データも、プロダクトの実用性も、ページごとの差別化手段もない

programmatic-seoスキルの使い方

programmatic-seoスキルをインストールする

リポジトリから次のコマンドでインストールできます。

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

その後、AIワークフロー内で、単発の記事作成ではなく、再利用可能なSEOページシステムを組み立てるタスクだと明確なときに呼び出してください。

最初に読むべきファイル

このprogrammatic-seoガイドとして読むなら、価値が高い順番は次のとおりです。

1. skills/programmatic-seo/SKILL.md
2. skills/programmatic-seo/references/playbooks.md
3. skills/programmatic-seo/evals/evals.json

この順番がよい理由は以下のとおりです。

• SKILL.mdで、実際の判断原則と評価フローを把握できる
• references/playbooks.mdで、自社アセットに合うページタイプを見つけやすい
• evals/evals.jsonで、良いアウトプットに何が含まれるべきかを確認できる

プロンプトの前にプロダクト文脈を確認する

このスキルでは、まず .agents/product-marketing-context.md または .claude/product-marketing-context.md を確認するよう明示されています。これは重要です。強いpSEOプランは、プロダクト、対象読者、CV目標、既存ポジショニングに大きく依存するからです。これらのファイルがあるなら、戦略を尋ねる前に必ずモデルに読ませてください。

programmatic-seoスキルに必要な入力を把握する

programmatic-seo usageの質は、与える入力に大きく左右されます。最低限、次の情報は渡しましょう。

• プロダクトまたはサービスの説明
• ターゲット顧客と検索意図
• ページのCV目標
• 想定しているキーワードパターン
• 見込みページ数
• すでに持っている構造化データ
• ページを有用にできる独自データ、事例、プロダクト機能
• 現在上位表示している競合と、その強さの理由

これらがないと、出力はどうしても抽象的なままになります。

ラフな発想を強いプロンプトに変える

弱いプロンプト:

• “Help us do programmatic SEO for our SaaS.”

より良いプロンプト:

• “We sell CRM software for SMBs. We are considering CRM for [industry] pages for 40 industries. Our goal is demo bookings. We have customer examples, industry workflow templates, and benchmark data for 12 industries. Competitors rank mostly with generic copy. Help us assess whether this programmatic-seo idea is viable, which playbook it fits, what makes each page genuinely unique, what template sections we need, and what pages should not be published until we have stronger data.”

この後者のプロンプトなら、単に前向きな案を出すだけでなく、そのprogrammatic-seo案が本当に成立するかまで評価できます。

アイデアをプレイブックに当てはめる

このprogrammatic-seoスキルの実務的な利点のひとつが、プレイブックで整理できることです。references/playbooks.mdでは、よくあるパターンとして次のようなものが挙げられています。

• templates
• curation
• comparisons
• examples
• locations
• personas
• integrations
• glossary
• translations
• directory
• profiles

ここが重要です。というのも、「programmatic SEO」という言い方だけでは範囲が広すぎるからです。CRM for healthcareの構築要件は、Notion vs Asanaとも、/integrations/[tool]/ページともまったく異なります。どのプレイブックに属するかで、必要データ、テンプレート構造、求められる品質水準が変わります。

各ページの固有価値をprogrammatic-seoで厳しく検証する

もっとも重要な使い方は、「なぜ各ページが個別に存在する価値があるのか」をスキルに説明させることです。良いプロンプトでは、次のような観点を求めます。

• ページタイプごとのユニークなセクション案
• 独自データを活かせる余地
• プロダクト固有の実用性
• バリエーションごとに実質的に変わるページ要素
• noindexにすべき組み合わせ、統合すべき組み合わせ、避けるべき低価値パターンの理由

答えが見出しへの変数差し替えだけに依存しているなら、その時点で立ち止まるべきです。まさにそこが、このスキルが可視化してくれる導入リスクの核心です。

ページ案だけでなく実装計画まで出してもらう

強いprogrammatic-seo guideプロンプトでは、次の項目まで求めるべきです。

• 機会評価
• テンプレートとデータモデル
• URL構造
• 内部リンク方針
• インデックス可否の基準
• CV要素の配置
• 展開順序
• 品質管理チェック

こうすることで、単なるキーワード一覧ではなく、実行可能な設計案に近づきます。

evalsを読んで期待値を合わせる

evalの例を見ると、このスキルが「十分な出力」と見なす基準がわかります。たとえば比較ページやペルソナ系ページでは、次の要素が含まれているべきです。

• どのプレイブックに当たるかの特定
• ユニークな価値の要件
• 独自の示唆やデータを入れられる余地
• テンプレート設計のガイダンス
• 内部リンク戦略
• 薄いコンテンツへの警告

出力にこれらがないなら、プロンプトの具体性が不足している可能性が高いです。

SEOコンテンツ向けprogrammatic-seoの実践ワークフロー

次の順番で進めるのがおすすめです。

1. 事業目標とCVイベントを確認する
2. 該当しそうなプレイブックを特定する
3. ページ在庫と検索パターンを見積もる
4. ページごとの差を生むデータを定義する
5. キーワードではなく実用性を軸にテンプレートを設計する
6. どのページをインデックス対象にするか決める
7. 主要ページから、またバリエーション同士で内部リンクを設計する
8. いきなり全面展開せず、まず高品質な小規模セットを公開する

この流れは、とくに一気に全部公開したくなりがちなprogrammatic-seo for SEO Contentチームに有効です。

programmatic-seoスキルFAQ

このprogrammatic-seoスキルは初心者向け？

はい。ただし、検索意図、テンプレート、内部リンクといった基本的なSEO概念をすでに理解していることが前提です。このスキルが実践的なのは、pSEOを抽象的なグロース施策としてではなく、プレイブックと制約条件の集合として扱っているからです。完全な初心者の場合は、キーワード調査やテクニカルSEOの基礎を別途補う必要があります。

programmatic-seoは普通のSEOプロンプトと何が違う？

通常のプロンプトは、汎用的なページ案を並べがちです。一方、このprogrammatic-seoスキルが真価を発揮するのは、次のような判断が必要なときです。

• 作る前に適合性を確認したい
• 薄いコンテンツのリスクを警告してほしい
• 大量展開しても成立するユニークさを設計したい
• 自社のビジネスモデルに合うプレイブックを選びたい
• 再現性のある展開構造を作りたい

その結果、導入判断の確度が上がり、失敗しやすいページ公開を減らせます。

どんなビジネスが特に向いている？

相性が良いのは次のタイプです。

• 連携、比較、テンプレート、業界別ユースケースを持つSaaS
• マーケットプレイスやディレクトリ
• 構造化された在庫やプロフィールを持つプロダクト
• 独自データセット、ベンチマーク、事例、UGCを持つ企業

相性が弱いのは次のようなケースです。

• データが乏しく、ページ単位の差別化が難しいビジネス
• pSEOだけでプロダクトと市場の弱い適合を補おうとしているチーム

このスキルはページ生成そのものにも使える？

主な役割は、大量の完成ページをそのまま作ることではなく、戦略、構造、意思決定の支援です。出力を使ってテンプレート設計を行い、別の生成ワークフローにつなげることはできますが、本質的な価値は「何を作るべきか」「各ページがどの品質基準を満たすべきか」を判断できる点にあります。

どんなときにprogrammatic-seoを使うべきでない？

次のような場合は見送るべきです。

• ブログ記事向けのコンテンツマーケティング戦略が必要
• テクニカルSEO監査をしたい
• サイトに必要なのが手書きのランディングページ数本だけ
• ページごとの意味ある入力が、変数トークン以外に用意できない

リポジトリには補助資料もある？

はい。特に役立つのはreferences/playbooks.mdで、12種類のpSEOパターンについて、価値要件やURL構造まで対応づけています。evals/evals.jsonも読む価値があり、実際のプロンプトに対してどの程度の思考品質が期待されているかが見えてきます。

programmatic-seoスキルを改善する方法

programmatic-seoスキルには強い事業入力を渡す

programmatic-seoの結果を最も手早く改善する方法は、最初に十分な事業文脈を渡すことです。

• 収益モデル
• オーディエンスセグメント
• 目標アクション
• 現在の権威性や評価
• 利用可能な構造化データ
• ページごとに内容を個別化できるプロダクト機能

このスキルは、ページ案をCVや差別化と結びつけられるほど、精度が大きく上がります。

悪い案を却下させる

「どう進めるべきか」だけを聞かないでください。あわせて次のような質問も投げましょう。

• “Which page variants should we avoid?”
• “What pages would be thin?”
• “What data gaps block launch?”
• “What would make this strategy non-viable?”

こうすることで、programmatic-seoスキルは意思決定により役立つものになり、根拠の薄い自信を防げます。

データセットのサンプル行を渡す

すでにスプレッドシート、ディレクトリ、在庫一覧、競合リストがあるなら、5〜10行程度のサンプルを渡してください。そうすると、このスキルは次のことを判断しやすくなります。

• 弱いフィールドの発見
• テンプレート化に向く属性の特定
• より適切なページセクションの提案
• ページ同士が本当に意味のある差を持てるかの見積もり

抽象的な説明より、具体的な行データのほうがほとんどの場合うまく機能します。

目的にひもづいたテンプレートセクションを依頼する

「ページテンプレートを書いて」ではなく、ユーザーニーズに対応づけたセクションを求めてください。たとえば次のような観点です。

• このページでユーザーは何ができるのか
• このバリエーションでは何が変わるのか
• 証拠となる実績やベンチマークデータ
• プロダクトが適している理由
• 比較や意思決定の支援要素
• ページ意図に合ったCTA

こうした聞き方をすると、ページの有用性が上がり、定型文だらけになるのを防げます。

programmatic-seoの主な失敗パターンを見逃さない

このスキルが検出しようとしている代表的なpSEOの失敗は次のとおりです。

• 変数差し替えだけで新しい価値がないページ
• シグナルの弱い組み合わせを出しすぎること
• 内部リンク設計を軽視すること
• 自社アセットに合わないプレイブックを選ぶこと
• 検索ボリュームだけで構築を正当化してしまうこと
• ページからプロダクトへのCV導線が明確でないこと

出力がこれらに触れていないなら、プロンプトを改善する余地があります。

最初の戦略案のあとに掘り下げる

最初の回答のあとで、次のような追加質問をすると精度が上がります。

• “Score these 30 page ideas by value and uniqueness.”
• “Which 10 should launch first?”
• “What data fields are mandatory before publishing?”
• “Show a high-quality template for one example page.”
• “What internal links should connect these pages to core commercial pages?”

多くの場合、programmatic-seoスキルが単発プロンプトより明確に良くなるのはこの段階です。

隣接スキルとは役割を分けて使う

リポジトリ自体も、別の仕事には別の手段を使うよう案内しています。programmatic-seoはスケーラブルなページシステム設計に使い、その後は必要に応じて別のツールやスキルに切り替えてください。たとえば次の用途です。

• SEO監査
• より広いコンテンツ戦略
• ページコピーの磨き込み
• 技術実装

この切り分けをすると、programmatic-seoスキルは本来の得意領域、つまり「そのpSEOシステムは作るべきか」「どう設計すれば成立するか」に集中できます。