📚 Itinéraire YinyangSEO Academy · Classe 1 — Sites web agentiques et SEO efficace. Cette skill fait partie du repo de la Classe 1. Clonez ou téléchargez le repo entier et donnez-le à votre agent comme contexte avant de l'exécuter. Le repo est mis à jour pendant le cours.
Générateur de Landing Pages · Service × Quartier
Prend le blueprint et produit des fichiers physiques dans le repo du site client. Astro par défaut (chemins de fichiers simples, SSG par défaut, idéal SEO), mais la sortie peut être adaptée à Next.js ou MDX pur.
Entrées
blueprint/{slug-du-business}/← deweb-blueprint-generator.- Dossier de destination ·
src/pages/(Astro) ouapp/(Next.js). - Locale · défaut
es-ES. - Mode ·
dry-run(liste ce qui serait généré) ouapply(écrit + commit).
Processus
- Charger le blueprint et valider que
url-map.yaml, les templates de pages et les templates de schémas existent. - Pour chaque combinaison service × quartier du
url-map.yaml:- Résoudre les variables (
{service},{quartier},{ville}, etc.) avec les données réelles du business. - Injecter un contenu unique minimum par quartier (PAS de duplication ; voir QA).
- Ajouter le schéma JSON-LD correspondant.
- Calculer les liens internes selon
internal-linking.yaml. - Écrire le fichier au bon endroit dans le repo.
- Résoudre les variables (
- Générer les pages pilier (
/services/{slug}/) avec la liste des quartiers couverts. - Générer
sitemap.xml(ou configurer@astrojs/sitemap) avec les priorités. - Générer
robots.txtcohérent. - Commiter les changements dans une nouvelle branche :
feat/landings-{service}-{N}-quartiers. - Afficher le résumé : N pages créées, poids total HTML, schéma validé, dry-run ou appliqué.
Outils
- Système de fichiers (Lire/Écrire/Modifier) sur le repo du client.
- Git pour les commits.
- Astro +
@astrojs/sitemap+astro-seo. - LLM pour générer le bloc de contenu unique par quartier (avec garde‑fous de longueur et d'unicité).
- schema-dts pour valider le JSON-LD avant d'écrire.
Sortie
src/pages/{service}/{quartier}.astro ← une par combinaison
src/pages/services/{service}.astro ← pilier
src/data/areas-served.json ← source de vérité des zones
public/sitemap.xml ← régénéré
public/robots.txt
Et un commit propre avec le message :
feat(landings): générer N landings service × quartier
- Service : serrurier-24h
- Quartiers : 12
- Pilier mise à jour
- Sitemap régénéré (entrées : 13)
- Schéma JSON-LD validé avec schema-dts
Qualité / QA
- Unicité du contenu : chaque landing doit avoir ≥ 30 % de tokens distincts de ses pages sœurs (similarité de Jaccard < 0.7). Sinon, régénérer le bloc variable.
- Validation du schéma : aucun fichier n'est écrit si le JSON-LD n'est pas valide.
- Maillage interne obligatoire : chaque landing a au moins 3 liens internes vers d'autres quartiers du même service + 1 vers le pilier.
- Budget Lighthouse : délégué à
landing-qa-runnerpost-génération. - Coût/temps : prévenir si > 50 combinaisons en une seule exécution.
Pour quoi l'utiliser ensuite
→ Entrée de landing-qa-runner qui exécute Playwright + Lighthouse-CI sur toutes les URLs générées et bloque le merge si elles ne respectent pas le budget hérité du top 3.