Compétence SEO — Optimisation de sites statiques
Outil léger d'audit et de correction SEO pour sites HTML statiques (GitHub Pages, Netlify, Vercel, etc.). Aucun outil de build requis. Il lit votre HTML, signale ce qui manque et l'ajoute.
Configuration
Avant la première utilisation, indiquez à Claude les informations de votre site afin qu'il puisse renseigner les bonnes valeurs :
- Domaine (ex.
https://votrenom.com) - Pages (ex. index, about, resume, projects/foo)
- Profils sociaux (LinkedIn, GitHub, Twitter, etc.)
- Ce pour quoi vous souhaitez être référencé (ex. « jane doe ingénieure logicielle », « portfolio jane doe »)
Claude conserve ce contexte pour la session. Vous n'avez à le dire qu'une seule fois.
Que faire lors de l'invocation
Lisez tous les fichiers HTML du répertoire source du site. Vérifiez chaque élément ci-dessous. Rapportez un tableau de réussite/échec, puis proposez de corriger ce qui manque.
1. Éléments essentiels <head> par page
Chaque page HTML doit contenir ces éléments dans <head> :
<title>[Titre de la page] — [Votre Nom]</title>
<meta name="description" content="[unique, 150-160 caractères, inclut les mots-clés cibles]">
<link rel="canonical" href="https://votredomaine.com/[chemin]/">
<!-- Open Graph -->
<meta property="og:title" content="[identique au titre ou plus court]">
<meta property="og:description" content="[identique à la meta description]">
<meta property="og:image" content="https://votredomaine.com/[chemin-vers-image]">
<meta property="og:image:width" content="1200">
<meta property="og:image:height" content="630">
<meta property="og:url" content="https://votredomaine.com/[chemin]/">
<meta property="og:type" content="website">
<meta property="og:site_name" content="[Votre Nom]">
<!-- Twitter Card -->
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="[identique à og:title]">
<meta name="twitter:description" content="[identique à og:description]">
<meta name="twitter:image" content="https://votredomaine.com/[chemin-vers-image]">
Recommandations :
- Titre : 50-60 caractères. Nom + différenciateur.
- Meta description : 150-160 caractères, unique par page, incluez votre nom et les mots-clés pertinents.
- Image OG : 1200x630px recommandé. Si aucune image personnalisée n'existe par page, utilisez une image partagée. Utilisez une image réelle du site, pas un placeholder.
- URL canonique : doit correspondre exactement à l'URL déployée réelle (cohérence de la barre oblique finale).
2. Données structurées (JSON-LD)
Ajoutez les schémas Personne + SiteWeb sur la page d'accueil :
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Person",
"name": "[Votre Nom]",
"url": "https://votredomaine.com",
"jobTitle": "[Votre Titre/Rôle]",
"affiliation": {
"@type": "Organization",
"name": "[École ou Entreprise]"
},
"sameAs": [
"[URL GitHub]",
"[URL LinkedIn]"
],
"knowsAbout": ["[compétence1]", "[compétence2]", "[compétence3]"]
}
</script>
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "WebSite",
"name": "[Votre Nom] — [Slogan du portfolio]",
"url": "https://votredomaine.com"
}
</script>
Pour les pages de projet, utilisez CreativeWork :
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "CreativeWork",
"name": "[Nom du projet]",
"author": { "@type": "Person", "name": "[Votre Nom]" },
"description": "[Brève description du projet]",
"url": "https://votredomaine.com/[projet]/"
}
</script>
Règles : JSON-LD uniquement (pas de Microdata/RDFa). Pas de FAQPage (réservé au gouvernement/santé). Pas de HowTo (obsolète). Pas de texte placeholder dans les champs de schéma.
3. robots.txt
Créez à la racine du site :
User-agent: *
Allow: /
Sitemap: https://votredomaine.com/sitemap.xml
4. sitemap.xml
Créez à la racine du site :
<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
<url>
<loc>https://votredomaine.com/</loc>
<lastmod>[AAAA-MM-JJ]</lastmod>
<priority>1.0</priority>
</url>
<!-- répéter pour chaque page -->
</urlset>
Définissez lastmod avec les dates réelles de dernière modification. Mettez à jour le sitemap lorsque les pages changent.
5. SEO des images
- Toutes les balises
<img>doivent avoir un textealtdescriptif (pas « image1 » ou « capture d'écran ») - Utilisez le format WebP si possible, gardez les images sous 200 Ko
- Ajoutez
loading="lazy"aux images situées sous la ligne de flottaison - L'image OG doit être un fichier réel, pas un placeholder
6. Signaux de contenu et mots-clés
- Balises H1 : Une par page, inclut le nom ou le nom du projet + mots-clés
- Hiérarchie des titres : h1 > h2 > h3, pas de niveaux sautés
- Nom dans le texte : Votre nom doit apparaître naturellement sur chaque page
- Liens internes : Les pages doivent se lier entre elles (page d'accueil vers projets, à propos vers projets, etc.)
- Liens externes : Profils sociaux liés depuis la page à propos/accueil
7. Vérifications techniques
- HTTPS : Vérifiez que tous les liens internes et ressources utilisent
https:// - Cohérence de la barre oblique : Choisissez un motif et respectez-le pour tous les liens, canoniques et le sitemap
- Aucun lien cassé : Vérifiez que tous les attributs
hrefetsrcaboutissent à une ressource valide - Adaptatif mobile : La balise meta viewport est présente sur toutes les pages
- Vitesse de la page : Différez les scripts non critiques. Un JS minimal = bonne base pour les sites statiques.
8. Vérification post-déploiement
Après le déploiement :
- Accédez directement à
/robots.txtet/sitemap.xmlpour vérifier qu'ils sont accessibles - Testez les balises OG en partageant un lien sur Discord/Slack/Twitter et en vérifiant la carte de prévisualisation
- Soumettez le sitemap dans Google Search Console
- Recherchez
site:votredomaine.comaprès quelques jours pour vérifier l'indexation - Recherchez vos requêtes cibles et suivez le classement au fil du temps
9. Configuration de Google Search Console
- Allez dans Google Search Console, ajoutez une propriété pour votre domaine
- Vérifiez via un enregistrement DNS TXT ou la méthode de fichier HTML
- Soumettez l'URL du sitemap
- Surveillez le rapport de couverture pour les problèmes d'indexation
Résultat rapide de l'audit
Lors de l'exécution d'un audit, lisez tous les fichiers HTML et produisez :
| Vérification | Statut | Remarques |
|---|---|---|
| Meta descriptions | ... | ... |
| Balises OG | ... | ... |
| Schéma JSON-LD | ... | ... |
| robots.txt | ... | ... |
| sitemap.xml | ... | ... |
| Texte alt des images | ... | ... |
| Balises H1 | ... | ... |
| Liens internes | ... | ... |
| URL canoniques | ... | ... |
Ensuite, proposez de corriger ce qui manque.