tseo

tseo — Audit SEO technique source-only pour Laravel

Plugin Claude Code qui audite et corrige le SEO technique d'un projet Laravel + Blade — sans toucher au contenu rédactionnel.

État : v0.1.0-beta — flow complet (Discovery → Q&A → Audit → Recap → Apply) sur Laravel uniquement.

Objectif

Faire passer un site Laravel à >90% de SEO technique parfait en quelques minutes, en automatisant les tâches chronophages (canonical, sitemap, robots.txt, JSON-LD, OG, Twitter, hreflang, lazy-loading, etc.) — et en laissant à l'humain ce qui demande du jugement (rédaction des descriptions, choix des images OG, configuration Apache/Nginx).

C'est l'outil qu'on lance après avoir finalisé un site, avant de le mettre en prod, pour avoir 100% des fondations techniques en place.

Le flow en une commande

cd /var/www/mon-projet-laravel
/seo-audit

1. DISCOVERY        ← lit le code, énumère pages/liens/indexabilité
2. Q&A INTERACTIF   ← questions à choix sur ce que la source ignore
                       (locale, indexabilité des routes dynamiques, JSON-LD Org, etc.)
3. AUDIT            ← applique references/*.md (51 règles, 11 thèmes actifs) au site
                       Classification : auto-safe / auto-risky / manual
4. RECAP            ← .tseo/recap.md groupé par axe, plan d'action
5. APPLY            ← après ton OK :
                       - auto-safe en batch (1 commit)
                       - auto-risky un par un (1 commit chacun)
                       - manuel → .tseo/manual-todos.md + boilerplates

Tout est commité dans git → rollback facile si besoin (git revert <sha>).

Périmètre

Ce que tseo fait

• Détection Laravel via signatures (composer.json + artisan)
• Énumération routes (statiques + dynamiques) via php artisan route:list --json
• Mapping URL → vue Blade
• Capture des métadonnées HEAD du layout + chaque vue
• Graphe de liens internes + sortants
• Indexabilité (robots.txt, sitemap, meta robots, canonical, X-Robots middleware)
• Évaluation contre 51 règles réparties en 11 thèmes actifs + 8 scaffolds (references/*.md, éditable, voir l'index references/seo-checks.md)
• Application automatique des fixes auto-safe (charset, viewport, lang, canonical self-ref, OG/Twitter structure, robots.txt, etc.)
• Application avec review des fixes auto-risky (sitemap dynamique, restructuration tags, etc.)
• TODO + boilerplate pour les items manuels (descriptions, OG image, JSON-LD à remplir, hreflang multi-locale, etc.)
• Mode incrémental : re-runs sautent les findings déjà appliqués

Ce que tseo ne fait jamais

• Modifier .env, vendor/, storage/, database/
• Toucher au contenu rédactionnel (descriptions, titles, alt, OG copy) — flagué en TODO, jamais drafté
• Crawler le site live en HTTP
• Auditer la qualité éditoriale, l'E-E-A-T, les backlinks, le netlinking
• Toucher à un repo non-git ou un working tree git sale

Stack supportée

Laravel + Blade uniquement (Laravel 10/11/12/13). Tailwind/DaisyUI détectés. Refus propre sur autre stack — le plugin n'a pas vocation à supporter d'autres frameworks pour le moment.

Installation

Depuis GitHub

# Dans Claude Code, ajoute le marketplace une fois :
/plugin marketplace add Wengouu/tseo
# puis :
/plugin install tseo@Wengouu

En local pour développement

git clone https://github.com/Wengouu/tseo /chemin/vers/tseo
# puis dans Claude Code :
/plugin install tseo --source /chemin/vers/tseo

Sortie dans le projet cible

<projet>/.tseo/
├── README.md              # explique le dossier
├── framework.md           # stack détectée
├── site-map.md            # routes énumérées
├── links.md               # graphe des liens
├── indexability.md        # robots, meta, canonical, sitemap
├── scale.md               # cardinalité des routes dynamiques
├── pages/<slug>.md        # une fiche par page HTML
├── raw/site_model.json    # source de vérité machine-readable
├── answers.json           # réponses Q&A (persisté pour reprise)
├── findings.json          # résultats audit (validé)
├── recap.md               # résumé humain
├── applied.md             # ce qui a été modifié + commits SHA
└── manual-todos.md        # TODO + boilerplates à compléter

Sécurité

• Working tree git clean obligatoire avant Phase 5 (apply).
• mtime check par fichier cible : si modifié entre audit et apply → skip ce finding.
• Sandbox strict : seules les modifs dans resources/views/, public/{robots.txt,sitemap.xml,*.webmanifest}, app/Http/, routes/, config/ sont autorisées.
• Confidence < high jamais auto-appliqué — flagué pour review humaine.
• 1 commit par finding auto-risky → rollback granulaire via git revert.

Le référentiel des règles