programmatic-seo について
ページ群を大規模に構築する SEO チーム向けのフレームワークです。キーワードパターンの発見、データパイプライン、テンプレート、品質確認、公開後の最適化を扱い、検索意図が一貫し、ページ用の構造化データがある案件を対象とします。
主な機能
- 01機会の評価とページ施策の選定
- 02キーワードパターンと検索意図の分析
- 03データパイプラインと品質基準の設計
- 04テンプレート作成と独自性の確認
- 05インデックス登録とクロール予算の計画
- 06公開後のパフォーマンス監視
活用シーン
- 01反復キーワードのページ施策を評価
- 02構造化データからページ群を作成
- 03テンプレートの薄いコンテンツを確認
- 04大規模ページ群のインデックス登録を計画
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ borghei/ claude-skills --skill programmatic-seoインストール後、Claude Code で/programmatic-seoを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/keyword-and-data.mdlaunch-and-optimization.mdstrategy-and-playbooks.mdtemplates-and-quality.mdscripts/data_validator.pykeyword_pattern_miner.pytemplate_scorer.py詳細
プログラマティック SEO
大規模な SEO ページ群を構築するための、本番環境対応フレームワークです。キーワードパターンの発見から、テンプレート設計、データパイプラインの構築、品質保証、ローンチ後の最適化まで、ライフサイクル全体を網羅します。50 ページから 100,000 ページ超までの規模のデプロイを想定して設計されています。
主な機能
- 機会の評価とプレイブックの選定 — 需要を検証し、データソースを評価し(Tier S-F)、競争上の優位性を採点したうえで、選定マトリックスと重み付けされた実施・見送り判断マトリックスを使って、14 種類のページ群プレイブックから選択します。
- キーワードパターンのマイニング — 繰り返し現れる
[variable]構造を抽出し、ヘッド/トルソー/ロングテール/検索ボリュームゼロの分布をマッピングして、検索意図を分類します。 - データパイプラインの設計 — ソース → 抽出 → 変換 → エンリッチメント → 検証 → 公開という流れを設計し、レコード単位の品質ゲートとデータ種別ごとの更新頻度を設定します。
- テンプレートのアーキテクチャと品質管理 — 6 ゾーンのページ構成、3-of-5 の独自性ルール、URL 規約、公開前の QA、薄いコンテンツの検出、ハブ・アンド・スポーク型の内部リンクを扱います。
- インデックス登録と最適化 — クロールバジェット戦略、段階的なインデックス登録の優先順位、IndexNow、段階的なローンチ手順、ローンチ後の指標ダッシュボード、アンチパターンとペナルティの回避を扱います。
使用する場合
次の場合にこのスキルを使用してください:
- 50 種類以上のバリエーションがある、繰り返しパターンのキーワードがある
- ページにデータを入力するための構造化データがある(または取得できる)
- バリエーション全体で検索意図が一貫している
- 競争に必要な十分なドメイン権威性がある
次の場合は使用しないでください:
- 各ページに独自の編集コンテンツが必要(代わりに content-creator を使用してください)
- 対象となるページが合計 30 未満(手動でのコンテンツ作成のほうが効果的です)
- データソースがなく、内容の薄いプレースホルダーコンテンツを生成することになる
- ドメイン権威性が DR 20 未満で、競合が DR 60 以上
まず確認すること
構築範囲を決める前に、次の入力情報を確認してください。不明または曖昧な項目があれば、推測せずに質問してください。
- キーワードパターン — 50 種類以上のバリエーションがある、繰り返し構造
[variable](キーワードのマイニングとテンプレート変数を左右します) - 構造化データソース — ページにデータを入力するデータセットと、その品質ティア(データパイプラインと 3-of-5 の独自性ルールを左右します。内容が薄くなるリスクにも関わります)
- 検索意図 — すべてのバリエーションで検索意図が一貫しているかどうか(プレイブックの選定とテンプレートのアーキテクチャを左右します)
- ドメイン権威性と規模 — 競合と比較した自サイトの DR と、目標とするページ数(実施・見送りの判断とインデックス登録戦略を左右します)
停止ルール:出力に最も大きく影響する 2~3 項目だけを質問してください。ユーザーが「とにかく下書きを作って」と言った場合は、作業を進め、成果物の冒頭に前提条件を記載してください。
クイックスタート
# Analyze keyword patterns for pSEO opportunities
python scripts/keyword_pattern_miner.py --keywords keywords.csv --json
# Score page templates for content quality and uniqueness
python scripts/template_scorer.py --template template.html --data sample_data.json
# Validate data quality for pSEO data pipeline
python scripts/data_validator.py --file data.csv --rules rules.json --json
参考資料
作業中のフェーズに合った参考資料を読み込みます。このファイルは簡潔に保ち、詳細は必要に応じて確認してください。
- references/strategy-and-playbooks.md — 初期評価(機会の検証、データソースの階層、競争優位性)、14 のプレイブック、プレイブック選択マトリックス、構築するか見送るかの判断マトリックスを扱います。機会の範囲を定め、何を構築するかを選ぶ際に読んでください。
- references/keyword-and-data.md — キーワードパターンの特定、検索ボリューム分布の分析、検索意図の分類、データパイプライン全体(品質ゲート、更新頻度)を扱います。キーワードを調査する際や、データフィードを設計する際に読んでください。
- references/templates-and-quality.md — 6 ゾーンのページ構成、独自性の要件、URL 構造、公開前の QA チェックリスト、低品質コンテンツの検出、ハブ&スポーク型のリンク、アンチパターンを扱います。テンプレートと QA ゲートを設計する際に読んでください。
- references/launch-and-optimization.md — クロールバジェットの管理、インデックス登録の優先順位、IndexNow、段階的なローンチ手順、ローンチ後の指標ダッシュボード、トラブルシューティング表、成果物、成功基準を扱います。ページ群を公開し、モニタリングする際に読んでください。
対象範囲と制限事項
対象範囲:
- キーワードパターンの調査と検索ボリューム分布の分析
- データパイプラインの設計(ソース > 抽出 > 変換 > 検証 > 公開)
- 独自性の要件を含むテンプレートアーキテクチャ
- 低品質コンテンツの検出を含む品質管理フレームワーク
- pSEO ページ群向けのハブ&スポーク型内部リンク
- 段階的なインデックス登録戦略とクロールバジェットの管理
- ローンチ後の最適化とモニタリングダッシュボード
対象範囲外:
- 個々の編集コンテンツの作成(Content Production を使用してください)
- データ収集またはウェブスクレイピングの実装
- CMS または静的サイトジェネレーターのセットアップと設定
- 大規模なデプロイ向けのサーバーインフラストラクチャ
- pSEO ページ向けの有料集客
- データ利用権に関する法令遵守
既知の制限事項:
- Google の 2026 年の有用なコンテンツに関するシステムでは、品質が基準を下回ると、大量のページ群が遡及的にインデックスから削除される可能性があります
- Tier F データ(公開データ/スクレイピングデータ)を使ったプログラマティック SEO は、テンプレートの品質にかかわらず、ペナルティを受けるリスクが高くなります
- エンゲージメント指標(直帰率、ページ滞在時間)は現在、pSEO ページのインデックス登録の判断にも影響します
- AI 生成コンテンツの検出精度が向上しており、人間による監督なしに完全自動でコンテンツを生成することは、ますますリスクが高くなっています
- 旅行サイトの事例:都市名を入れ替えた 50,000 ページの 98% が、3 か月以内にインデックスから削除されました(2025 年の業界データによる)
関連スキル
- seo-audit -- pSEO ページの公開後に実行し、ページ群全体のインデックス登録の問題、低品質コンテンツに関する警告、ランキングの問題を診断します。
- schema-markup -- pSEO テンプレートに構造化データ(Product、FAQ、LocalBusiness)を追加し、大規模にリッチスニペットの対象となる可能性を高めます。
- site-architecture -- 大規模な pSEO デプロイ(500 ページ以上)に向けて、ハブ&スポーク構造とクロールバジェットの管理を計画します。
- competitor-alternatives -- 「[X] vs [Y]」ページを作成する際に Comparisons プレイブックを使用します。competitor-alternatives には、比較ページ専用のフレームワークがあります。
- content-creator -- ページ群の個々のページに、テンプレート生成を超える編集品質の独自コンテンツが必要な場合に使用します。
コメント
Markdown 対応