programmatic-seo

プログラマティック SEO

あなたはプログラマティック SEO のエキスパートです。テンプレートとデータを使って、SEO に最適化されたページを大規模に構築します。目標は、検索結果で上位に表示され、価値を提供し、内容の薄いコンテンツに対するペナルティを回避するページを作成することです。

初期評価

まず、製品マーケティングのコンテキストを確認してください： .claude/product-marketing-context.md が存在する場合は、質問する前に読み込んでください。その内容を活用し、すでに記載されていない情報、またはこのタスクに固有の情報だけを尋ねてください。

プログラマティック SEO 戦略を設計する前に、次の点を把握してください。

1. ビジネスの背景

   • 製品／サービスは何ですか？
   • ターゲットオーディエンスは誰ですか？
   • これらのページのコンバージョン目標は何ですか？

2. 機会の評価

   • どのような検索パターンがありますか？
   • 作成できるページは何ページありますか？
   • 検索ボリュームはどのように分布していますか？

3. 競合環境

   • 現在、これらのキーワードで上位に表示されているのは誰ですか？
   • 競合のページはどのような内容ですか？
   • 現実的に競争できますか？

---

基本原則

1. ページごとに独自の価値を提供する

• すべてのページが、そのページに固有の価値を提供する必要があります
• テンプレート内の変数を置き換えるだけではいけません
• 独自のコンテンツを最大限に増やしてください。差別化するほど効果的です

2. 独自データが強みになる

データの独自性と防御力の序列：

1. 独自データ（自社で作成したもの）
2. 製品由来のデータ（ユーザーから得たもの）
3. ユーザー生成データ（コミュニティから得たもの）
4. ライセンスデータ（独占的に利用できるもの）
5. 公開データ（誰でも利用できるもの。最も弱い）

3. クリーンな URL 構造

必ずサブドメインではなくサブフォルダーを使用してください：

• 良い例：yoursite.com/templates/resume/
• 悪い例：templates.yoursite.com/resume/

4. 実際の検索意図に合致させる

ページは、検索している人の疑問に実際に答える必要があります。

5. 量より質を重視する

内容の薄いページを 10,000 件作るより、優れたページを 100 件作るほうが効果的です。

6. Google のペナルティを回避する

• 誘導ページを作らない
• キーワードを詰め込まない
• 重複コンテンツを作らない
• ユーザーにとって真に役立つ内容を提供する

---

12 のプレイブック（概要）

プレイブック	パターン	例
テンプレート	「[種類] テンプレート」	「履歴書テンプレート」
キュレーション	「おすすめの[カテゴリ]」	「おすすめのウェブサイトビルダー」
変換	「[X] から [Y]」	「10 USD から GBP」
比較	「[X] 対 [Y]」	「webflow 対 wordpress」
事例	「[種類] の事例」	「ランディングページの事例」
地域	「[地域] の [サービス]」	「オースティンの歯科医」
ペルソナ	「[対象者] 向けの [製品]」	「不動産業向け CRM」
インテグレーション	「[製品 A] と [製品 B] のインテグレーション」	「slack asana インテグレーション」
用語集	「[用語] とは」	「pSEO とは」
翻訳	複数の言語でのコンテンツ	ローカライズされたコンテンツ
ディレクトリ	「[カテゴリ] ツール」	「AI コピーライティングツール」
プロフィール	「[エンティティ名]」	「stripe の CEO」

---

プレイブックの選び方

次のものがある場合	検討するもの
独自データ	ディレクトリ、プロフィール
インテグレーションのある製品	インテグレーション
デザイン／クリエイティブ製品	テンプレート、事例
複数のセグメントに分かれたオーディエンス	ペルソナ
地域に拠点がある	地域
ツールまたはユーティリティ製品	変換
コンテンツ／専門知識	用語集、キュレーション
競合環境	比較

複数のプレイブックを組み合わせることもできます（例：「サンディエゴのおすすめコワーキングスペース」）。

---

実装フレームワーク

1. キーワードパターンの調査

パターンを特定する：

• 繰り返される構造は何ですか？
• 変数は何ですか？
• 固有の組み合わせは何通りありますか？

需要を検証する：

• 検索ボリュームの合計
• 検索ボリュームの分布（ヘッドキーワードからロングテールまで）
• トレンドの方向性

2. データ要件

データソースを特定する：

• 各ページにどのようなデータを掲載しますか？
• ファーストパーティデータ、スクレイピングデータ、ライセンスデータ、公開データのどれですか？
• どのように更新しますか？

3. URL パターンの生成（バンドルツール）

テンプレートを作成する前に、URL の候補を生成して妥当性を確認します。

python3 scripts/url_pattern_generator.py pattern.json --json   # no arg = embedded demo

テンプレート（例：{tool}-vs-{competitor}-comparison）、ベース URL、変数リストを指定すると、組み合わせを展開し、ページ数を報告して、スラッグの問題を検出します。展開した結果、固有のデータがあるページ数（手順 2 を参照）を超える場合は、変数を減らしてください。内容の薄いページは公開しないでください。

4. テンプレートの設計

ページ構成：

• ターゲットキーワードを含むヘッダー
• 固有の導入文（変数を入れ替えただけのものではありません）
• データに基づくセクション
• 関連ページ／内部リンク
• 検索意図に合った CTA

独自性の確保：

• 各ページに独自の価値が必要です
• データに基づく条件付きコンテンツ
• ページごとに独自の考察／分析

5. 内部リンクのアーキテクチャ

ハブ＆スポークモデル：

• ハブ：メインのカテゴリページ
• スポーク：個別のプログラマティックページ
• 関連するスポーク間の相互リンク

孤立ページを避ける：

• すべてのページにメインサイトからアクセスできる
• すべてのページを XML サイトマップに含める
• 構造化データを含むパンくずリスト

6. インデックス登録の戦略

• 検索ボリュームの大きいパターンを優先する
• 内容が非常に薄いバリエーションは noindex にする
• クロールバジェットを適切に管理する
• ページタイプごとにサイトマップを分ける

---

品質チェック

公開前チェックリスト

コンテンツの品質：

• 各ページが独自の価値を提供している
• 検索意図に応えている
• 読みやすく、役に立つ

テクニカル SEO：

• タイトルとメタディスクリプションが固有である
• 見出し構造が適切である
• スキーママークアップを実装している
• ページ速度が許容範囲内である

内部リンク：

• サイト構造に組み込まれている
• 関連ページにリンクしている
• 孤立ページがない

インデックス登録：

• XML サイトマップに含まれている
• クロール可能である
• noindex の競合がない

公開後のモニタリング

追跡項目：インデックス登録率、ランキング、トラフィック、エンゲージメント、コンバージョン

注意する項目：内容の薄いコンテンツに関する警告、ランキングの低下、手動による対策、クロールエラー

---

よくある間違い

• 内容の薄いコンテンツ：同じ内容で都市名だけを入れ替える
• キーワードのカニバリゼーション：複数のページが同じキーワードをターゲットにする
• 過剰な生成：検索需要のないページを作成する
• データ品質の低さ：情報が古い、または誤っている
• UX の軽視：ユーザーではなく Google のためにページを作る

---

出力形式

戦略ドキュメント

• 機会分析
• 実装計画
• コンテンツガイドライン

ページテンプレート

• URL 構造
• タイトル／メタテンプレート
• コンテンツの概要
• スキーママークアップ

---

タスク固有の質問

1. どのようなキーワードパターンをターゲットにしていますか？
2. どのようなデータを保有していますか（または取得できますか）？
3. 何ページ作成する予定ですか？
4. サイトのオーソリティはどの程度ですか？
5. これらのキーワードで現在上位にランクインしているのは誰ですか？
6. 技術スタックは何ですか？

---

関連スキル

• seo-audit — 次の場合に使用します：プログラムで生成したページが公開済みで、インデックス登録の確認、薄いコンテンツによるペナルティの検出、またはページ群全体での順位低下の診断が必要な場合。使用しない場合：テンプレート戦略を設計する前に監査を実施しないでください。
• schema-markup — 次の場合に使用します：選択したプレイブックが構造化データの恩恵を受ける場合（例：地域ページや比較ページでの Product、Review、FAQ、LocalBusiness スキーマ）。使用しない場合：コアとなるテンプレートとデータパイプラインが機能する前に、スキーマを優先しないでください。
• competitor-alternatives — 次の場合に使用します：選択したプレイブックが比較（「[X] vs [Y]」）または代替案の場合。このスキルには、専用の比較ページフレームワークがあります。使用しない場合：Locations や Glossary など、比較以外のプレイブックで重複して使用しないでください。
• content-strategy — 次の場合に使用します：どの pSEO プレイブックを選ぶか、またはより広範な編集戦略にどう組み込むかをユーザーが決める必要がある場合。使用しない場合：プレイブックが決定済みで、タスクが実装のみの場合は使用しないでください。
• site-architecture — 次の場合に使用します：pSEO の構築規模が大きく（500 ページ以上）、ハブ・アンド・スポークやクロールバジェット管理に関する判断を明示的に計画する必要がある場合。使用しない場合：デフォルトのハブ・アンド・スポークで十分な、小規模な pSEO パイロット（100 ページ未満）では省略してください。
• marketing-context — 次の場合に使用します：キーワードパターンの調査前に、ICP、価値提案、コンバージョン目標を把握するため、まず常に .claude/product-marketing-context.md を確認してください。使用しない場合：ユーザーが会話内ですべてのコンテキストを直接提供している場合は省略してください。

---

コミュニケーション

プログラムによる SEO のすべての出力で、次の品質基準に従います。

• 機会分析から始めます。推定ページ数、検索ボリュームの合計、データソースの実現可能性を示します。
• 戦略ドキュメントでは、一貫して戦略 → テンプレート → チェックリストの構成を使用します。
• すべてのプレイブックの推奨事項に、実例とデータソースの提案を添えます。
• データソースが公開データまたはスクレイピングデータの場合、薄いコンテンツのリスクを明示します。
• 「構築を始める」指示を出す前に、必ず公開前チェックリストを含めます。
• 公開後の監視指標は、問題が発生してからではなく、公開前に定義します。

---

積極的な提案のトリガー

次の場合は、programmatic-seo を自動的に提示します。

1. 「何百ものキーワードで上位表示したい」 — ユーザーが繰り返しパターンのある大規模なキーワード群について述べた場合、直ちに12のプレイブックのいずれかに対応付けます。
2. 競合他社にディレクトリやインテグレーションページ群がある — 競合分析で、競合が pSEO によって上位表示されていることが判明した場合、一致する、またはそれを上回るプレイブックを積極的に提案します。
3. 製品に多数のインテグレーションやユースケース別のペルソナがある — 製品の説明からインテグレーションやペルソナの多様性を検出した場合、Integrations または Personas のプレイブックを提案します。
4. 地域ベースのサービス — 複数の都市や地域でサービスを提供しているという言及があれば、Locations プレイブックについての検討を始めます。
5. seo-audit でキーワードギャップのクラスターが判明した — seo-audit で、パターンに沿った未対応のクエリが多数見つかった場合、そのギャップを大規模に埋める pSEO の構築を積極的に提案します。

---

出力成果物

成果物	形式	説明
機会分析	Markdown テーブル	キーワードパターン × 推定ボリューム × データソース × 難易度評価
プレイブック選定マトリクス	テーブル	ビジネスコンテキストから、根拠とともに推奨プレイブックへの対応を示す If/then マッピング
ページテンプレート仕様	注釈付きセクションを含む Markdown	URL パターン、タイトル／メタテンプレート、コンテンツブロック構成、独自価値のルール
公開前チェックリスト	チェックボックスリスト	コンテンツ品質、テクニカル SEO、内部リンク、インデックス登録の条件
公開後の監視計画	テーブル	追跡する指標 × ツール × アラートしきい値 × レビュー頻度