seo-plan

出力例：examples/seo-plan-wix-com-20260514/PLAN.md

SEO 計画

ドメインの段階的な SEO ロードマップを作成します。出力は単一の PLAN.md とフェーズごとの成果物フォルダーです。各フェーズは四半期（または 90 日間のスプリント）を対象とし、明確な目標、作業項目、担当者、指標を設定します。計画は一般的なチェックリストではなく、サイトの実際の競争上の立ち位置に基づきます。

これは「次の四半期に何に取り組むべきか」を決めるスキルです。専門スキルの代わりになるものではなく、それらを組み合わせて、出力を実行順に並べます。

前提条件

• SE Ranking MCP サーバーに接続済みであること。
• サイトマッピングとヘッドメタデータの取得に seo-firecrawl を利用できること（任意ですが推奨）。
• ユーザーから以下の情報が提供されること：
  • 対象ドメイン。
  • 任意：対象国（デフォルトは us）、ビジネスタイプ（saas / ecommerce / local / publisher / agency / b2b — 指定がない場合はドメインから自動検出）、計画期間（デフォルトは 90 日、選択肢：30 / 90 / 180 / 365）。
  • 任意：既知の制約（エンジニアリングの対応能力、コンテンツ予算、JS レンダリングの変更禁止など）。

プロセス

0. Google データの利用可否を確認（参考情報であり、処理はブロックしません）

   • python3 scripts/google_auth.py --check --json を実行します。tier >= 0 の場合、後続の専門スキル（technical-audit、page、content-audit、drift）は実際の Google フィールドデータを使って出力を拡充します。また、seo-plan はステップ 4 でそれらのより充実した出力を取り込みます。計画自体が seo-google を直接実行することはありません。ユーザーに選択肢があることを知らせるため、1 行の通知を出力します。

   > Google APIs detected (tier {n}, available: {comma-list}). Downstream specialist
   > skills (seo-technical-audit, seo-page, seo-content-audit, seo-drift) will enrich
   > their outputs with real CrUX / GSC / GA4 / URL Inspection data automatically.
   

   • 認証情報が不足している場合、計画は SE Ranking のデータだけを使って続行し、次の内容を出力します。

   > Google APIs not configured. To enrich downstream phases with real CWV / GSC /
   > GA4 / indexation data, run `bash extensions/google/install.sh`. Plan continues
   > with SE Ranking data only.
   

   • これは可能な限り軽量な自動起動です。seo-plan 自体は seo-google を実行しません（摩擦を単一のコマンドに移すことは彼らのアンチパターンであり、EVAL_RESULT_v2.md で批判しました）。専門スキルの実行前に、ユーザーが利用するかどうかを選べるよう、選択肢を提示します。詳しい理由については、skills/seo-google/references/cross-skill-integration.md § 「seo-plan」を参照してください。

1. ビジネスタイプを検出 DATA_getDomainOverviewWorldwide と、利用可能な場合は Firecrawl によるホームページの scrape

   • タイトル、H1、JSON-LD のタイプ、主なナビゲーションのパターンを確認します。
   • saas、ecommerce、local、publisher、agency、b2b-services、marketplace のいずれかに分類します。判断が難しい場合は、ユーザーに一度だけ確認します。
   • ビジネスタイプによってテンプレートが決まります（ステップ 6 を参照）。

2. ドメインのベースライン DATA_getDomainOverviewWorldwide、DATA_getDomainOverviewHistory、DATA_getDomainAuthority、DATA_getBacklinksSummary

   • オーガニックキーワード、オーガニックトラフィックの推定値、DA、バックリンクプロファイルの健全性、主要な国、過去 12 か月間のトラフィック傾向を記録します。
   • これにより、「現状」の基準点を設定します。

3. 競合状況の把握 DATA_getDomainCompetitors

   • オーガニック検索の競合上位 5～10 社を取得します。
   • それぞれについて、オーガニックキーワード、トラフィックシェア、DA、競合が優位性を持つ主要なトピッククラスターを確認します。
   • SERP でユーザーが実際に競合している相手を特定します（ユーザーが考えている相手とは異なることがよくあります）。

4. 専門ツールの入力を取得 — 確認してからディスパッチするパターン

   • 4a. 既存の出力を検出します。 現在の作業ディレクトリで、以下のパターンに一致し、過去30日以内の日付が付いたフォルダーを探します（30日より古いフォルダーは古いものとして扱い、不足リストに再度追加します）。
     • seo-technical-audit-*
     • seo-content-audit-*
     • seo-competitor-gap-analysis-*
     • seo-ai-search-share-of-voice-*
     • seo-backlinks-profile-*
   • 存在する各フォルダーから、主要な成果物（それぞれ TECH-AUDIT.md、VERDICT.md の集約版、GAPS.md、REPORT.md、PROFILE.md）を取り込みます。
   • 4b. 不足リストを作成します。 新しい出力がない前提条件について、それぞれのクレジット費用を専門ツールの SKILL.md で確認します（プロンプトの作成時に読み込んでください。数値は変わる場合があります）。
     • seo-technical-audit → 新しい監査ではページ数によって異なります。最新の監査がキャッシュされていない場合は「変動します。ページ数を確認してください」と記載します。
     • seo-content-audit → SE Ranking クレジット約10～15、監査対象 URL 1件につき Firecrawl クレジット1（デフォルト上限50件。seo-plan のトップ10ページを対象とする場合は、SE Ranking クレジット約10～15＋Firecrawl クレジット約10を見込みます）。
     • seo-competitor-gap-analysis → シード10件でクレジット約30～80。
     • seo-ai-search-share-of-voice → クレジット約10～20（リーダーボード＋ドメイン数 N に対して約20個のプロンプト）。
     • seo-backlinks-profile → SE Ranking クレジット約25～40。
   • 4c. 確認プロンプトを出力します（1つのブロックで、不足リストは実際に不足している項目だけに絞り、必ず次の形式にします）。

   To produce a defensible plan, seo-plan needs outputs from N specialists not yet
   run for {domain}:
   - seo-technical-audit (~{N} credits)
   - seo-content-audit (~{N} credits)
   - seo-competitor-gap-analysis (~{N} credits)
   - seo-ai-search-share-of-voice (~{N} credits)
   - seo-backlinks-profile (~{N} credits)
   Total estimated cost: ~{N} credits.
   Run them now in this session? (y/N — default N preserves the existing v2.6 behavior of asking the user to run them manually first)
   

   • 4d. ユーザーが y と回答した場合： 不足している専門ツールを次の順序でディスパッチし、各ツールの実行が完了したら主要な成果物を取り込みます。
     • 並列バッチ（独立して実行）： seo-technical-audit、seo-competitor-gap-analysis、seo-ai-search-share-of-voice、seo-backlinks-profile。
     • バッチ完了後に順次実行： seo-content-audit — トップ10ページを対象とするには、seo-competitor-gap-analysis／DATA_getDomainKeywords からトラフィック上位ページを把握する必要があるため、ギャップ分析バッチの完了後に実行する必要があります。
     • 各専門ツールは、実行前に独自の DATA_getCreditBalance チェックを行い、処理を進める前に費用を提示します（既存の動作であり、seo-plan がこれを省略することはありません）。クレジット残高の確認で専門ツールが中断した場合は、その中断をユーザーに伝え、クレジットを追加するかスキップするかをユーザーに判断してもらいます。
     • ディスパッチのたびに、ステップ4aと同じ方法で新しいフォルダーを取り込みます。
   • 4e. ユーザーが N（またはそれ以外の回答。デフォルトは N）と回答した場合： 既存の v2.6 の動作に進みます。プランは フェーズ0：ディスカバリー から始まり、不足している各専門ツールの実行が最初のスプリントの作業になります。これにより、専門ツールを別々にスケジュールまたはバッチ実行する環境でも、クレジット使用に関するユーザーの決定権を維持できます。

5. 4つの柱を評価します

   • 技術的な健全性（0～100）：seo-technical-audit の重大度で重み付けした問題数に基づきます。
   • コンテンツの品質（0～100）：監査対象ページ全体の E-E-A-T+CITE スコアの平均です。
   • トピックに関する権威性（0～100）：競合上位3社と比較したクラスターの網羅率です。
   • AI 検索への対応度（0～100）：SoV 競合他社に対する引用シェアです。
   • 最もスコアの低い柱を、第1フェーズの主要テーマにします。

6. ビジネスタイプ別テンプレートを適用する（テンプレートは異なるため、1つ選んでパラメーターを設定します）

   • saas → プロダクト主導の柱＋連携ページ＋比較／代替案＋JTBD コンテンツ。
   • ecommerce → カテゴリーページの整備＋商品スキーマ＋ファセットナビゲーションのインデックス登録ルール＋レビューの集約。
   • local → GBP の最適化＋地域ページ＋サイテーションの整理（注：まだ seo-local スキルはないため、手動のサブステップまたは外部対応として明記します）。
   • publisher → トピッククラスター＋著者の E-E-A-T＋鮮度を保つ更新頻度＋AI 検索の引用。
   • agency → サービスページ＋導入事例＋比較コンテンツ＋リード獲得用 LP（seo-agency-landing-page を使用します）。
   • b2b-services → 業界特化型ランディングページ＋ソートリーダーシップのクラスター＋意思決定段階のコンテンツ。
   • テンプレートがデフォルトの作業項目カテゴリーを提示します。ステップ 5 でスコアが最も低かった柱を基準に、各カテゴリーの重みを設定します。

7. 計画をフェーズに分ける — 計画期間を3つのフェーズに分け、それぞれに目標、作業項目、担当者、指標を設定します。

   • フェーズ 1（計画期間の第1〜4週）：基盤。 そのほかの作業を可能にする技術的な修正、ベースラインのドリフトスナップショット、seo-page の評価結果に基づく、すぐに効果が見込めるコンテンツの更新を1〜2件行います。
   • フェーズ 2（第5〜8週）：構築。 seo-keyword-cluster に基づくコンテンツの階層（ピラー1件＋スポーク3〜7件）、seo-schema に基づくスキーマの修正、競合状況を踏まえて有効な場合は seo-competitor-pages に基づく比較ページを作成します。
   • フェーズ 3（第9〜12週）：効果の積み上げと測定。 主要ページを対象に seo-geo で AI 検索対応状況を確認し、seo-backlink-gap に基づくバックリンクギャップへのアプローチを開始し、2回目のドリフト比較を seo-drift compare で行い、振り返りと調整を実施します。
   • より長い計画期間（180日／365日）では、入力情報を更新したうえでフェーズ 2 と 3 を繰り返し、四半期ごとに振り返りを行います。
   • 各作業項目には、それを作成するスキルをタグ付けします。例：seo-content-brief、seo-schema、seo-page など。

8. 指標を選ぶ

   • 遅行指標（四半期ごと）： オーガニックトラフィック、上位10位以内にランクインするオーガニックキーワード、オーガニックコンバージョン。
   • 先行指標（週次／月次）： 技術的な問題の件数、E-E-A-T 評価が 70 以上のページ数、AI 検索の引用件数、参照ドメイン数。
   • 各フェーズに先行指標を1つ、遅行指標を1つ設定します。各指標を現在値（ステップ 2 から取得）とフェーズ終了時の目標値に結び付けます。目標値には妥当な根拠が必要です。ベースレートを明記してください。

9. 順序付けと依存関係

   • 依存関係マップを作成します。例：「クラスター A のピラーページを書き直す」は「/blog テンプレートの noindex を修正する」に依存し、「/blog テンプレートの noindex を修正する」は「seo-technical-audit を実施する」に依存します。
   • クリティカルパスを明らかにします。クリティカルパス上にない作業は移動できますが、クリティカルパス上の作業はフェーズの進行を妨げます。

10. PLAN.md を作成する

出力形式

フォルダー seo-plan-{domain-slug}-{YYYYMMDD}/：

seo-plan-{domain-slug}-{YYYYMMDD}/
├── PLAN.md                              (synthesis — primary deliverable; inlines 01-baseline, 02-competitive-frame, 07-dependencies, 08-metrics as sections)
├── 04-phase-1-foundations.md            (load-bearing — owners share single phase files in standups)
├── 05-phase-2-build.md                  (load-bearing — owners share single phase files)
├── 06-phase-3-compound.md               (load-bearing — owners share single phase files)
└── evidence/
    ├── 01-baseline.md                   (where you are now — raw data inlined into PLAN.md)
    ├── 02-competitive-frame.md          (who you're actually competing with — raw data inlined into PLAN.md)
    ├── 03-pillar-scores.md              (technical / content / topical / AI Search — scoring math)
    ├── 07-dependencies-and-critical-path.md  (dependency map — inlined as PLAN.md section)
    └── 08-metrics.md                    (metric tables — inlined as PLAN.md section)

最上位には、PLAN.md と3つのフェーズファイル（04／05／06）を配置します。担当者はスタンドアップでフェーズファイルを個別に共有するため、フェーズファイルは PLAN.md にまとめず、最上位に置きます。ベースライン、競合状況、依存関係、指標の重複するセクションは PLAN.md に含めますが、柱のスコア計算とともに、ステップごとの元ファイルを evidence/ に保持します。

PLAN.md は次の構成に従います。

# SEO Plan: {domain}

> Plan dated {YYYY-MM-DD} · Horizon: {n} days · Business type: {type} · Country: {country}

## Where you are
- Organic keywords: {n} (trend: {↑↓→ over 12mo})
- Organic traffic estimate: {n}/mo
- Domain authority: {n}
- Referring domains: {n}
- Pillar scores: Technical {n}/100 · Content {n}/100 · Topical {n}/100 · AI Search {n}/100

## Lead theme
{The lowest pillar from step 5, plus a one-line "why this is the constraint."}

## Top 5 competitors
| Domain | DA | Organic kw | Top cluster they own |
|---|---|---|---|
| {comp} | {n} | {n} | {cluster} |

## Phase 1 — Foundations (weeks 1–4)

**Goal:** {1-line outcome, e.g. "remove technical debt blocking content investment"}

| # | Work item | Skill / source | Owner | Effort | Phase-end metric |
|---|---|---|---|---|---|
| 1.1 | {item} | `seo-technical-audit` follow-up | {role} | {S/M/L} | {metric} |
| 1.2 | ... | | | | |

**Phase exit criteria:** {what must be true to declare Phase 1 done}

## Phase 2 — Build (weeks 5–8)
{same shape}

## Phase 3 — Compound + measure (weeks 9–12)
{same shape}

## Critical path
{Ordered list of work items that block subsequent phases. Anything not on this list is moveable.}

## Metrics

| Metric | Type | Current | Phase 1 target | Phase 2 target | Phase 3 target |
|---|---|---|---|---|---|
| Organic traffic | Lagging | {n} | {n} | {n} | {n} |
| Pages with E-E-A-T ≥ 70 | Leading | {n} | {n} | {n} | {n} |
| Technical issue count | Leading | {n} | {n} | {n} | {n} |
| AI Search citation count | Leading | {n} | {n} | {n} | {n} |
| Referring domains | Leading | {n} | {n} | {n} | {n} |

## Constraints / caveats
{User-supplied constraints, plus anything the data flags — e.g., "DA gap to top competitor is 25 points; expect 6+ months for keyword parity."}

## Recommended next step
Run Phase 1 work items. After week 4, run `seo-drift compare` against the baseline captured today, then adjust Phase 2 scope.

ヒント

• デフォルトでは「自動ディスパッチなし」です。 手順4cの確認プロンプトのデフォルトはNです。ユーザーがそのままEnterキーを押すか、明示的なy以外で回答すると、seo-planはv2.6のPhase-0の動作に戻り、不足している専門家を最初のスプリントの作業として一覧表示します。これにより、クレジットの使用をユーザーが管理できます。SE Rankingの予算が限られている場合や、専門家への依頼を別々にスケジュールしたい場合に重要です。
• 自動ディスパッチ（yの経路）は利便性を優先する選択肢です。 ユーザーが1回のセッションで完成した計画を作成したく、表示されたクレジット見積もりに納得している場合、yの経路では手順4dで説明されている最適な並列実行後に順次実行する順序で、不足している専門家を実行し、その出力を取り込んで、ピラーのスコアリング（手順5）に進みます。無言で再実行することはありません。すべてのディスパッチは手順4cの確認1回を経て実行されます。
• 自動ディスパッチは各専門家独自のクレジット残高の事前確認を尊重します。 各専門家は最初の手順でDATA_getCreditBalanceを呼び出し、クレジットを消費する前に費用を提示します。seo-planがこの確認を迂回することはありません。専門家が事前確認で中止した場合（クレジット不足、または内部の費用確認プロンプトでユーザーが辞退した場合）、seo-planは中止を通知し、ユーザーがクレジットを追加する、その専門家をスキップする（Phase-0の作業項目として残す）、または残りのディスパッチをキャンセルする、のいずれかを選べるようにします。
• ビジネスの種類は、手軽に自動検出します。 ホームページの<title>、スキーマの@type、トップナビゲーションのアンカーがあれば、通常は十分です。本当に曖昧な場合にのみ、ユーザーに尋ねてください。
• 主要テーマは、ピラーのスコアが最も低いものです。 ユーザーが最も期待しているピラーを選ぶのではなく、データがボトルネックとして示すものを選んでください。ユーザーの期待と異なる場合は、このギャップを明確に示してください。
• 30日の期間でも、3つのフェーズを設けます。 省略するのではなく、圧縮してください。30日の計画では、基盤整備（第1～2週）、構築（第2～3週）、測定（第4週）とします。この構成により、順序を守る姿勢が保たれます。
• 目標は根拠を示せるものでなければなりません。 「第1四半期にオーガニックトラフィックを2倍にする」とは書かないでください。各目標を、競合データやカテゴリのベンチマークに基づく基準値と結び付けてください。計算上その目標を裏付けられない場合は、その旨を伝えて目標を引き下げてください。
• 重要な成果物はクリティカルパスです。 ほとんどのチームは何らかの作業を進められますが、何が何を妨げているかを把握しているチームは多くありません。依存関係の連鎖を明らかにしてください。そこにこのスキルの価値があります。
• ローカルSEOには既知のギャップがあります。 ビジネスの種類がlocalの場合、まだseo-localスキルがないことを伝え、Phase 0の項目としてGBPの手動監査を推奨してください。対応していない範囲まで対応しているように装わないでください。
• チームが実行できない作業項目は生成しないでください。 ユーザーが「JSレンダリングの変更は禁止」と伝えている場合、効果が大きくても該当する項目は除外してください。実行に移せない計画より、規模が小さくても実行できる計画のほうが優れています。
• 更新の頻度。 90日計画は、90日目にseo-drift compareを元のベースラインと照合する入力として再実行してください。ドリフトの出力に基づいて「現在の状況」セクションを書き換え、以降のすべての内容を更新します。

併用すると効果的なスキル

• 先行スキル：
  • seo-technical-audit、seo-content-audit、seo-competitor-gap-analysis、seo-ai-search-share-of-voice、seo-backlinks-profile — 入力データを生成します。
  • seo-drift baseline — 計画の進捗測定に使うスナップショットを取得します。
• 後続スキル：
  • seo-keyword-cluster — Phase 2でコンテンツ階層が必要になった場合に使用します。
  • seo-content-brief — Phase 2の各スポーク記事に使用します。
  • seo-schema — 構造化データの作業項目に使用します。
  • seo-competitor-pages — 比較コンテンツが計画に含まれている場合に使用します。
  • seo-drift compare — フェーズ終了時に進捗を測定します。
  • seo-page — Phase 1で個別URLを維持、更新、統合、削除する判断に使用します。