📚 Itinerario YinyangSEO Academy · Clase 1 — Web エージェンティックと効率的SEO。 このスキルはClase 1のリポジトリの一部です。実行する前に、リポジトリ全体をクローンまたはダウンロードしてAIエージェントにコンテキストとして与えてください。リポジトリはコース中に更新されます。
ランディングジェネレーター · サービス × エリア
Blueprint からクライアントのWebサイトリポジトリに物理ファイルを生成します。デフォルトは Astro（シンプルなファイルルート、SSGデフォルト、SEOに最適）ですが、出力はNext.jsや純粋なMDXにも対応可能です。
入力
blueprint/{negocio-slug}/←web-blueprint-generatorの出力。- 出力先フォルダ ·
src/pages/(Astro) またはapp/(Next.js)。 - ロケール · デフォルト
es-ES。 - モード ·
dry-run（生成される内容をリスト表示）またはapply（書き込み＋コミット）。
プロセス
- Blueprint をロードし、
url-map.yaml、page-templates、schema-templates が存在することを検証します。 url-map.yamlの各サービス×エリアの組み合わせごとに:- 変数（
{servicio}、{barrio}、{ciudad}など）を実際のビジネスデータで解決します。 - エリアごとに最小限のユニークなコンテンツを注入します（重複禁止、QAを参照）。
- 対応する JSON-LD スキーマを追加します。
internal-linking.yamlに従って内部リンクを計算します。- リポジトリ内の正しいパスにファイルを書き込みます。
- 変数（
- ピラーページ（
/servicios/{slug}/）を生成し、カバーするエリアのリストを含めます。 sitemap.xmlを生成（または@astrojs/sitemapを設定）し、優先度を割り当てます。- 一貫性のある
robots.txtを生成します。 - 変更をコミットします。新しいブランチ名:
feat/landings-{servicio}-{N}-barrios。 - サマリーを表示: 作成されたページ数、HTML総サイズ、スキーマ検証結果、dry-run か適用済みかを表示。
ツール
- クライアントリポジトリ上のファイルシステム（Read/Write/Edit）
- Git によるコミット
- Astro +
@astrojs/sitemap+astro-seo - LLMによるエリアごとのユニークコンテンツブロック生成（長さとユニーク性のガードレール付き）
- schema-dts によるJSON-LD書き込み前検証
出力
src/pages/{servicio}/{barrio}.astro ← 組み合わせごとに1ファイル
src/pages/servicios/{servicio}.astro ← ピラーページ
src/data/areas-served.json ← エリアの信頼できる情報源
public/sitemap.xml ← 再生成
public/robots.txt
以下のメッセージでクリーンなコミット:
feat(landings): N件のランディング サービス×エリアを生成
- サービス: cerrajero-24h
- エリア数: 12
- ピラーページ更新
- サイトマップ再生成 (エントリー: 13)
- JSON-LD スキーマを schema-dts で検証済み
品質 / QA
- コンテンツのユニーク性: 各ランディングは、姉妹ページと比較して30%以上の異なるトークンを持つ必要があります（Jaccard類似度 < 0.7）。違反する場合は変数ブロックを再生成します。
- スキーマ検証: JSON-LDが検証に合格しない限り、ファイルは書き込まれません。
- 内部リンク必須: 各ランディングには、同じサービスの他のエリアへの最小3つの内部リンクと、ピラーページへの1つのリンクが必要です。
- Lighthouse予算: 生成後の
landing-qa-runnerに委任されます。 - コスト/時間: 1回の実行で50を超える組み合わせがある場合は警告を表示します。
後の利用
→ 生成されたすべてのURLに対してPlaywright + Lighthouse-CIを実行し、トップ3から継承した予算を満たさない場合はマージをブロックする landing-qa-runner への入力となります。