seo

`/seo $1 $2` として呼び出される、SEO/GEO 2026 の最上位オーケストレーターです（$1 = コマンド、$2 = URL またはローカルパス）。サイト全体の監査（seo-audit）、単一ページの分析（seo-page）、テクニカル SEO、スキーママークアップ、コンテンツ品質（E-E-A-T）、AI 検索／GEO 最適化（AI Overviews 対応）、ローカル SEO、サイトマップ／robots、内部リンク、セマンティッククラスタリング、コンテンツブリーフ、ビジネスタイプ別の戦略計画、検索エクスペリエンス（SXO）、強調スニペット、エンティティ／セマンティック SEO、e コマース、動画、hreflang／i18n、リダイレクト／移行を網羅する20のサブスキルに処理を振り分けます。コマンドとサブスキルの完全な対応表は、本文のクイックリファレンス表をご覧ください。ローカルファースト（サードパーティ API 不使用、Google API 不使用、Python 不使用 — TS/Bun スクリプトのみ）です。フレームワーク固有の実装は fuse-astro/fuse-nextjs/fuse-laravel に委任します。また、プロジェクトごとの初回実行時に `.fuse-seo` のオプトイン型有効化フックを管理し、分析後のレポートを `.fuse-seo/reports/` 以下に生成します。

SEO/GEO オーケストレーター

呼び出し方法： /seo $1 $2。$1 はコマンド、$2 は URL またはローカルパスです。

あらゆる業界（SaaS、ローカルサービス、e コマース、パブリッシャー、代理店）を対象に、SEO + GEO 2026 の包括的な分析を行います。20のサブスキルと8つの並列サブエージェントをオーケストレーションします。ローカルファーストで、サードパーティ API は使用しません。

クイックリファレンス

コマンド	機能	サブスキル
/seo audit <url>	サブエージェントに並列で委任する包括的な監査	seo-audit
/seo page <url|path>	単一ページの詳細分析	seo-page
/seo technical <url>	テクニカル SEO（robots、CWV、クロール可能性）	seo-technical
/seo schema <url|path>	JSON-LD の検出／検証／生成	seo-schema
/seo content <url>	E-E-A-T + カニバリゼーション対策	seo-content
/seo images <url>	画像 SEO：代替テキスト、形式、遅延読み込み	seo-images
/seo sitemap <url|generate>	XML サイトマップの分析または生成	seo-sitemap
/seo hreflang <url>	i18n／多言語監査と生成	seo-hreflang
/seo internal-linking <url>	ピラー／クラスター、アンカーテキストの最適化	seo-internal-linking
/seo cluster <keyword>	SERP に基づくセマンティッククラスタリング	seo-cluster
/seo brief <topic>	詳細なコンテンツブリーフの生成	seo-content-brief
/seo plan <type>	戦略計画（saas/local/ecommerce/publisher）	seo-plan
/seo sxo <url>	検索エクスペリエンス最適化	seo-sxo
/seo snippets <url>	ポジション0 + AI Overviews の入力	seo-featured-snippets
/seo local <url>	ローカル SEO（GBP、NAP、サイテーション、ローカルパック）	seo-local
/seo geo <url>	AI Overviews／ChatGPT／Perplexity／Claude への対応状況	seo-geo
/seo entity <url>	エンティティ／セマンティック SEO、ナレッジグラフ、顕著性	seo-entity
/seo ecommerce <url>	商品スキーマ、ファセットナビゲーション、マーケットプレイス	seo-ecommerce
/seo video <url>	VideoObject、YouTube、トランスクリプト	seo-video
/seo redirects <url>	301／302、移行、リダイレクトチェーン	seo-redirects
/seo drift <url>	前回の git HEAD との差分を SEO 観点で確認	（diff-seo.ts を使用）

オーケストレーションのロジック — /seo audit

ユーザーが /seo audit <url> を呼び出した場合：

1. ホームページからビジネスタイプを判定します（SaaS、ローカル、e コマース、パブリッシャー、代理店）。
2. サブエージェントを並列で起動します（1つのメッセージ内で複数の Agent 呼び出しを実行）：
   • seo-technical（robots、サイトマップ、CWV、hreflang）
   • seo-schema（JSON-LD の検出／検証）
   • seo-content（E-E-A-T、カニバリゼーション対策）
   • seo-geo（AI Overviews 対応状況）
   • seo-entity（ナレッジグラフ、顕著性、sameAs/knowsAbout）
   • seo-images（代替テキスト、形式、最適化）
   • seo-sitemap（sitemap.xml + robots.txt）
3. ローカルビジネスを検出した場合 → seo-local も起動します。
4. コンテンツ戦略の兆候がある場合（ブログ、ピラーページ） → seo-cluster も起動します。
5. 結果を収集し、**SEO ヘルススコア（0～100）**を含む統合レポートを生成します。
6. 優先順位を付けたアクションプランを作成します（重大 → 高 → 中 → 低）。

ワークフロー（コンテンツ作成フロー向けの7フェーズ）

PHASE 1: ANALYZE   → Extract content, detect intent
PHASE 2: RESEARCH  → SERP analysis, 2026 trends, AI platforms
PHASE 3: KEYWORDS  → Extract with anti-cannibalization
PHASE 4: STRUCTURE → Meta, OG, Twitter Cards, Hn, schema, alt
PHASE 5: CONTENT   → Write SEO+GEO optimized content
PHASE 6: VALIDATE  → SEO + GEO compliance checklists
PHASE 7: DRIFT     → Compare to git HEAD (diff-seo.ts)

リファレンスライブラリ（従来の10カテゴリ）

references/
├── 01-seo-foundations/   → research workflow, SEO vs GEO
├── 02-onpage-seo/        → meta tags, OG, Twitter, headers, alt
├── 03-schema-org/        → 9 schema types (templates ready)
├── 04-geo-2026/          → AI platforms, citations, zero-click
├── 05-technical-seo/     → CWV, mobile-first, crawlability
├── 06-content-strategy/  → E-E-A-T, anti-cannibalization, keywords
├── 07-sea-google-ads/    → Quality Score, landing pages (optional)
├── 08-measurement/       → GEO tracking, Share of Model
├── 09-checklists/        → pre-publication, technical audit
└── 10-local-seo/         → GBP, NAP, citations, Local Pack

利用可能なスクリプト（scripts/）

スクリプト	目的
parse-meta.ts	cheerio を使用してタイトル／説明／OG／canonical を抽出
validate-schema.ts	schema.org のダンプデータに対して JSON-LD をオフラインで検証
check-cwv.ts	Lighthouse CLI のローカルラッパー
parse-sitemap.ts	sitemap.xml の構造を検証
parse-robots.ts	robots.txt のディレクティブを検証
parse-hreflang.ts	hreflang タグを検証
diff-seo.ts	git diff による SEO の変化
geo-score.ts	LLM 対応度のスコアリング（0～100）
analyze-keywords.ts	コンテンツ分析：密度、n-gram、キーワード詰め込みスコア（0～100）、ローカル分布（ローカル優先）

差別化要素

• ローカル優先：Google API、DataForSEO/Moz、Python は一切不要です
• フレームワークネイティブ：実装を fuse-astro、fuse-nextjs、fuse-laravel に委任します
• GEO 優先：AI Overviews/ChatGPT/Perplexity を第一のターゲットとし、後回しにしません
• TS/Bun スタック：すべてのスクリプトは TypeScript で記述し、Bun で実行します

業界の検出

ホームページのシグナルから検出します：

• SaaS：/pricing、/features、/integrations、「無料トライアル」、「サインアップ」
• ローカルビジネス：住所、電話番号、営業時間、GBP リンク、NAP
• E コマース：/products、/cart、/checkout、商品スキーマ
• パブリッシャー：/articles、NewsArticle スキーマ、署名欄、日付
• エージェンシー：/services、/case-studies、/clients、推薦コメント

品質ゲート

• ロケーションページが30件以上 → 警告
• ロケーションページが50件以上 → 強制停止、手動監査が必要です
• プログラマティックページが100件以上 → 警告
• プログラマティックページが500件以上 → 強制停止
• ページタイプごとに薄いコンテンツを検出
• ドアウェイページを防止

初回呼び出し — フックを有効化

プロジェクトで初めてユーザーが /seo を呼び出したとき：

1. プロジェクトルート（またはリポジトリルートまでの親ディレクトリ）に .fuse-seo マーカーが存在するか確認します
2. 存在しない場合、ほかの作業を始める前にユーザーに確認します：

   「このプロジェクトで fuse-seo フックを有効にしますか？@fusengine/harness の seo スコープを使用し、HTML に類似したファイル（.html、.astro、.tsx、.vue、.blade.php）の Write/Edit ごとに meta/schema/OG を検証します。」

3. ユーザーが同意した場合 → touch .fuse-seo（または空の内容を指定した Write ツール）でプロジェクトルートに空の .fuse-seo ファイルを作成します
4. ユーザーが拒否した場合 → マーカーを作成せずに続行します（このプロジェクトではフックは休止状態のままです）
5. 同じセッション中に再度確認しないでください — マーカーの有無が永続的な回答となります

これはオプトイン方式です。ユーザーの明示的な同意なしに自動作成しないでください。

分析後の処理

1. .fuse-seo/reports/<date>-<command>.md に Markdown レポートを生成します
2. 以降の比較に備えた差分ベースラインの取得を提案します：/seo drift <url>
3. 委任によるフレームワーク固有の実装を提案します：
   • Astro プロジェクト → fuse-astro:astro-seo
   • Next.js → fuse-nextjs:nextjs-stack
   • Laravel → fuse-laravel:laravel-blade