Web Blueprint Generator (ウェブ設計書生成ツール)

📚 YinyangSEO Academy カリキュラム · クラス 1 — エージェンティックなウェブサイトと効率的なSEO。 このスキルはクラス 1 のリポジトリの一部です。リポジトリ全体をクローンまたはダウンロードし、実行前にエージェントにコンテキストとして与えてください。リポジトリはコースの進行に応じて更新されます。

Web Blueprint Generator (ウェブ設計書生成ツール) は何をしますか？

検出されたパターン から ウェブサイトの設計図 へ。ページを生成する前に、どのようなページが必要か、その構造、スキーマ、内部リンクを定義します。この層がないと、エージェントはランディングページをその場しのぎで生成し、結果に一貫性がなくなります。

入力

• data/patterns/{kw}/{date}/hypotheses.md — local-seo-pattern-aggregator からの出力。
• ターゲットビジネス · 名称、NAP、USP、実際のサービス一覧、カバーするエリア一覧。
• スタック · デフォルトは Astro (他に Next.js、MDX プレーンも可)。
• 制約条件 · 言語、最大ページ数、Lighthouse 予算。

プロセス

1. URL マップ をパターンとエリアから作成:
   • ホーム (/)
   • サービスのピラーページ (/servicios/{slug}/)
   • サービス × エリア (/{servicio}/{barrio}/) — ローカルSEOの核心
   • 会社概要、お問い合わせ、法令情報
   • ブログ (オプション)
2. 各ページタイプについて定義:
   • タイトルパターン と メタディスクリプションパターン ({servicio}、{barrio}、{ciudad}、{telefono} などの変数を使用)。
   • H1、H2、H3 パターン。
   • 必須セクション (アグリゲーターの HIGH 仮説から抽出)。
   • タイプ別の JSON-LD スキーマ:
     • ホーム → LocalBusiness + Organization。
     • サービスのピラーページ → Service + BreadcrumbList。
     • サービス × エリア → Service (areaServed: PostalAddress) + BreadcrumbList + FAQPage。
   • CTA (トップページの勝ちパターンに電話番号が含まれている場合は、常に電話を表示)。
3. 内部リンク計画:
   • ホーム → すべてのサービスのピラーページ。
   • ピラーページ → そのサービスに紐づくすべてのエリア。
   • サービス × エリア → 同じサービスの他のエリア + サービスのピラーページ + 関連サービス。
   • 一貫性のある「近隣エリア」ブロック。
4. ページごとの最小コンテンツ計画: 文字数、必須FAQ、ソーシャルプルーフ、NAP。
5. Lighthouse 予算 (トップ3の勝ちパターンから継承): LCP、CLS、TBT、JS バンドルサイズ。

ツール

• 変数を使用したパターン作成のための LLM。
• schema-dts — JSON-LD を公式タイプに対して検証。
• astro-seo または next-sitemap (自動サイトマップ生成の参考)。

出力

blueprint/{negocio-slug}/
├── url-map.yaml                 ← 生成する全URLの完全なリスト
├── page-templates/
│   ├── home.md                  ← {{...}} 変数を含むテンプレート
│   ├── service-pillar.md
│   └── service-area.md
├── schema-templates/
│   ├── home.jsonld
│   ├── service-pillar.jsonld
│   └── service-area.jsonld
├── internal-linking.yaml
├── lighthouse-budget.json
└── README.md                    ← この設計書の使い方

url-map.yaml の例:

home: /
services:
  - slug: cerrajero-24h
    barrios: [centro, sant-oleguer, can-rull, gracia]
  - slug: aperturas-puertas
    barrios: [centro, sant-oleguer, can-rull]
legales:
  - aviso-legal
  - politica-privacidad
  - cookies

品質 / QA

• 各 service-area がホームから 3 クリック以内で到達可能であることを確認。
• ユーザー指定の上限を超えるサービス×エリアの組み合わせを生成しない (超過した場合は警告し、優先順位を尋ねる)。
• ジェネレーターに渡す前に、schema-dts を使用して JSON-LD を検証。

後続で使用されるスキル

→ landing-generator-servicio-barrio (実際のコードを生成) および landing-qa-runner (予算の確認) への直接入力。