Opérations & Automatisation SEO (seo-ops)

Opérations et Automatisation SEO (seo-ops)

Un runbook automatisé pour amorcer le serveur MCP seo, intégrer des contrôles de qualité pré-push et CI/CD, et exécuter des audits techniques et de classement fondés sur des preuves.

---

Phase 0 : Vérification Pré-Vol Obligatoire & Installation Automatique

[!IMPORTANT] Hypothèse de configuration manuelle nulle : Avant toute analyse de code ou audit, vérifier que le CLI et le serveur MCP seo sont configurés et disponibles dans la session en cours.

flowchart TD
    Start["Invoquer /seo-ops"] --> Check{"Le MCP / CLI SEO est-il configuré ?"}
    Check -->|Non / Manquant| AutoInstall["1. Lancer l'installation automatique<br/>('npm i -g seo' + écrire mcp_config.json)"]
    AutoInstall --> TestDaemon["2. Vérifier : 'npx -y seo mcp serve --test'"]
    TestDaemon --> PromptRestart["3. Demander à l'utilisateur de redémarrer l'Agent/IDE & ARRÊTER"]
    Check -->|Oui / Actif| RouteIntent["Passer au routage de l'intention utilisateur"]

Runbook d'auto-installation (Déclenché lorsque MCP / CLI est manquant)

1. Installer le paquet :

   npm install -g seo
   

2. Configurer le serveur MCP : S'assurer que .agents/mcp_config.json (et ~/.gemini/config/mcp_config.json) contient :

   {
     "mcpServers": {
       "seo": {
         "command": "npx",
         "args": ["-y", "seo", "mcp", "serve"]
       }
     }
   }
   

3. Vérifier le démon :

   npx -y seo mcp serve --test
   

4. Demander un redémarrage & Arrêter le tour : Si les outils MCP viennent d'être ajoutés dans cette session, Antigravity nécessite un rechargement de la session/fenêtre pour enregistrer les outils. Indiquer clairement :

   "Le CLI et le serveur MCP seo ont été installés et enregistrés. Veuillez recharger la fenêtre de l'IDE ou redémarrer la session de l'agent pour que les nouveaux outils MCP (seo_list_reports, seo_describe_report, seo_run_report) soient chargés, puis rappeler /seo-ops." Ne PAS procéder à des modifications manuelles du code ou à des suppositions erronées sans outils actifs.

---

Routage d'Intention Actif (Lorsque MCP / CLI est Prêt)

Lorsque les prérequis sont satisfaits, demander à l'utilisateur ou inspecter le contexte pour connaître son objectif :

flowchart LR
    Route["Session Active"] --> A["1. Configuration CI/CD & Pré-Push (setup-cicd)"]
    Route --> B["2. Audit Technique & On-Page (audit-technical)"]
    Route --> C["3. Search Console & Audit de Croissance (audit-gsc)"]
    Route --> D["4. Vérification de l'état de l'environnement (check-health)"]

---

Chemin A : CI/CD du Référentiel & Contrôle de Qualité Pré-Push (setup-cicd)

Appliquer des contrôles SEO de non-régression dans les pipelines de développement et de déploiement :

• 1. Vérifier Node 22+ : Exécuter node -v pour s'assurer d'un runtime Node 22+.
• 2. Configurer le Hook Pré-Push Local :
  • Déployer le script d'exécution pré-push (scripts/seo-pre-push.ps1 ou scripts/seo-pre-push.sh) avec une sonde automatique du serveur de développement (réutilisation des instances actives ou lancement de cmd.exe /c pnpm run dev avec nettoyage de l'arborescence des processus).
  • Dans .husky/pre-push, exécuter les étapes discrètes :

    pnpm run test:all
    pnpm run seo:pre-push
    

  • Voir cicd-pipeline-guide.md.
• 3. Installer le Workflow GitHub Actions :
  • Créer .github/workflows/seo-check.yml en utilisant seo-ci.yml.template.
• 4. Valider le Pipeline :
  • Windows : powershell -ExecutionPolicy Bypass -File .agents/skills/seo-ops/scripts/verify-seo-setup.ps1 -Mode cicd
  • Linux/macOS : bash .agents/skills/seo-ops/scripts/verify-seo-setup.sh -m cicd

---

Chemin B : Audit Technique & On-Page (audit-technical)

Exécuter des explorations fondées sur des preuves sur des builds locales ou des URLs en direct :

• 1. Démarrer le Build Local / Cible :
  • Exécuter pnpm build && pnpm start sur http://127.0.0.1:3000.
• 2. Exécuter l'Audit Technique :
  • Via MCP : Appeler seo_run_report avec reportId: "audit-page" ou "site-crawl" et params: {"url": "http://127.0.0.1:3000"}.
  • Via CLI :

    npx -y seo report --url http://127.0.0.1:3000 --actions-only --json
    

• 3. Corriger le Code Next.js :
  • Mettre à jour generateMetadata() (titre, description, OpenGraph, canoniques).
  • Corriger les composants de données structurées JSON-LD (BreadcrumbList, Article, WebSite).
  • Corriger les balises <Link> internes cassées et app/sitemap.ts.
  • Voir ranking-optimization-guide.md.
• 4. Vérifier les Corrections :
  • Ré-exécuter seo audit-page --url <url-cible> pour confirmer un état vierge sans problèmes.

---

Chemin C : Search Console & Opportunités de Croissance (audit-gsc)

Débloquer des opportunités de classement sur des domaines en direct avec Search Console :

• 1. Découvrir les Rapports via MCP :
  • Appeler seo_list_reports (catégorie : "gsc" ou "pseo").
  • Appeler seo_describe_report pour reportId: "quick-wins", "second-page", ou "pseo-patterns".
• 2. Exécuter l'Audit d'Opportunités :
  • Appeler seo_run_report avec la propriété cible (site: "sc-domain:example.com").
• 3. Appliquer les Améliorations :
  • Quick Wins (Positions 4–10) : Affiner <title> et <meta description> pour augmenter le CTR.
  • Second Page (Positions 10–20) : Ajouter des liens internes contextuels depuis des pages parentes à haute autorité et approfondir le contenu.
  • Modèles pSEO : Échafauder des routes dynamiques avec generateStaticParams().
• 4. Revérifier : Confirmer que les métadonnées et schémas mis à jour sont rendus dans la version SSR de production.

---

Cas Limites & Pièges Connus

• Nécessité de Redémarrer le Processus : Lorsque .agents/mcp_config.json est modifié, l'agent ne peut pas accéder aux nouveaux outils avant que la session/fenêtre soit rechargée. Ne jamais sauter l'invite de redémarrage.
• Résolution de Chemin Windows : Toujours utiliser "command": "npx" avec ["-y", "seo", "mcp", "serve"] pour éviter les erreurs de recherche binaire %PATH% sur Windows.
• Pas de Supposition Statique : Ne jamais inspecter le code de manière statique pour le SEO sans d'abord exécuter les outils MCP ou le rapport CLI.
• Séparation des Preuves : Garder les preuves d'exploration observées séparées des estimations de mots-clés provenant de fournisseurs externes.

---

Guides de Référence & Ressources

• Configuration MCP & Référence des Outils
• Guide du Pipeline CI/CD & Pré-Push
• Guide d'Optimisation du Classement & de Correction du Code SEO
• Modèle de Workflow CI GitHub Actions
• Modèle de Fichier de Configuration MCP