--- name: audit-seo description: Faire l'audit technique SEO d'un site web en 18 points, avec le modèle du Docteur SEO, et produire un rapport partageable. À utiliser quand l'utilisateur demande un audit SEO, un audit technique, pourquoi son site n'apparaît pas sur Google, ou une vérification de site avant refonte. --- # Audit SEO en 18 points Ce skill fait passer à un site le **modèle d'audit technique du Docteur SEO** : 18 points, dans un ordre qui compte, et un rapport à remettre à l'utilisateur. Le modèle et l'API sont gratuits, sans compte et sans clé. Documentation : ## La règle d'or **N'inscrivez un résultat que sur ce que vous avez réellement vérifié.** Un point non vérifié se laisse vide : il ne compte pas dans le score. Un verdict inventé, lui, rend le rapport faux — et l'utilisateur prendra des décisions dessus. Il vaut mieux rendre un audit de 10 points sur 18 qu'un audit complet à moitié deviné. Trois points ne peuvent PAS être établis par un programme. Demandez-les à l'utilisateur, ou laissez-les vides : | Point | Ce qu'il faut lui demander | |---|---| | `pages-indexees` | Le nombre de résultats que Google affiche pour `site:sondomaine.fr`, comparé au nombre de pages publiées | | `vitesse`, `mobile`, `ordinateur`, `lcp`, `cls`, `core-web-vitals`, `temps-serveur`, `images`, `js-css` | Les chiffres de (note mobile, LCP, CLS, temps de réponse) | | `erreurs-404` | S'il a des liens cassés connus, ou de lancer un crawl gratuit | ## Le déroulé ### 1. Ouvrir l'audit ``` GET https://docteurseo.com/api/audit/nouveau?url=SITE&agent=VOTRE-NOM ``` - `url` : le domaine ou l'adresse complète (`monsite.fr` suffit). - `agent` : **obligatoire** — un identifiant de l'assistant appelant (`claude-code`, `chatgpt`, `mon-agent-interne`…). Il figure sur le rapport. La réponse contient l'`id` de l'audit, l'adresse du `rapport`, et les 18 `points` avec pour chacun : `label`, `quoi`, `comment` (comment le vérifier), `valide_si`, `non_valide_si`, `critique`. Un audit déjà ouvert sur ce site depuis moins de deux heures est **repris** (`"reprise": true`) au lieu d'être dupliqué : `deja_remplis` liste ce qui est déjà inscrit. ### 2. Relever les faits ``` GET https://docteurseo.com/api/audit/mesures?url=SITE ``` Rend des **faits bruts**, pas des verdicts : statut HTTP, adresse d'arrivée des quatre variantes (http/https, avec et sans www), contenu du `robots.txt`, présence et taille du `sitemap.xml`, balise `noindex`, en-têtes de sécurité, nombre d'images sans description, nombre de scripts. C'est vous qui décidez du résultat de chaque point, en confrontant ces faits à `valide_si` et `non_valide_si`. Si vous avez un accès web, vérifiez aussi de votre côté : la page d'accueil s'affiche-t-elle, le titre est-il présent et parlant, le contenu correspond-il à l'activité. ### 3. Inscrire chaque résultat ``` GET https://docteurseo.com/api/audit/reponse?id=ID&point=POINT&resultat=RESULTAT¬e=NOTE ``` - `point` : l'identifiant exact du point (voir la liste ci-dessous). - `resultat` : `ok` (validé), `warn` (à améliorer) ou `fail` (non valide). - `note` : ce que vous avez constaté, en une phrase (400 caractères max). Facultatif, mais c'est elle qui rend le rapport utile — préférez un fait à un jugement : « Disallow: / présent sous User-agent: * » plutôt que « mauvais ». Un appel par point. La réponse rend le `score_partiel` et la liste des `restants`. ### 4. Clore et rendre le lien ``` GET https://docteurseo.com/api/audit/terminer?id=ID ``` Rend le `score`, le `verdict`, les `points_critiques_en_defaut` et l'adresse du `rapport`. **Terminez toujours en donnant à l'utilisateur le lien du rapport** : c'est une page lisible qu'il peut garder, imprimer ou transmettre à son prestataire. Résumez en trois phrases : le score, le ou les points bloquants, et la première chose à corriger. ## Les 18 points L'ordre compte : les six premiers décident si Google peut voir le site. Tant que l'un d'eux est en défaut, améliorer la vitesse ou les textes ne sert à rien. **Google et votre site** — `redirections`, `robots` *(critique)*, `ssl` *(critique)*, `pages-indexees` *(critique)*, `sitemap`, `erreurs-404` **Optimisation du site** — `temps-serveur`, `vitesse`, `responsive`, `core-web-vitals`, `lcp`, `cls`, `mobile` *(critique)*, `ordinateur`, `images`, `js-css` **Sécurité web** — `entetes-http`, `xss` Les quatre points **critiques** donnent un verdict rouge à tout l'audit dès qu'ils sont en défaut, quel que soit le score : un certificat expiré ou un `robots.txt` fermé rend le reste du travail invisible. Le référentiel complet, avec les consignes de vérification, est toujours disponible sans ouvrir d'audit : ``` GET https://docteurseo.com/api/audit/points ``` ## Barème - `ok` = tous les points du poids, `warn` = la moitié, `fail` = zéro. - Les points critiques comptent double. - **Le score ne porte que sur les points examinés** : laisser un point vide ne pénalise pas, alors qu'un verdict inventé le fausse. - Verdict : vert à partir de 85 % sans aucun point en défaut, rouge en dessous de 55 % ou dès qu'un point critique est en défaut. ## Bonnes manières - **Un audit par site.** Ne rouvrez pas un audit pour corriger une réponse : réécrivez le point, le dernier résultat inscrit gagne. - **Ne promettez pas de positions.** Cet audit vérifie la mécanique du site. Il ne dit rien des mots-clés, du contenu ni des liens entrants — dites-le à l'utilisateur, c'est ce qui décide de sa place dans les résultats une fois la technique saine. - **N'inventez pas de chiffres de vitesse.** Si l'utilisateur ne les fournit pas, ces points restent vides et le rapport le montre honnêtement. - **Écrivez pour un artisan**, pas pour un référenceur : « Google » plutôt que « SEO », des phrases courtes, aucun jargon non expliqué. ## Exemple complet ``` GET /api/audit/nouveau?url=boulangerie-martin.fr&agent=claude-code → { "id": "k7m2p9x4vq8n3b6s", "rapport": "https://docteurseo.com/audit/k7m2p9x4vq8n3b6s", … } GET /api/audit/mesures?url=boulangerie-martin.fr → { "faits": { "robots_txt": { "present": true, "contenu": "User-agent: *\nDisallow: /wp-admin/" }, … } } GET /api/audit/reponse?id=k7m2p9x4vq8n3b6s&point=robots&resultat=ok¬e=Ne%20bloque%20que%20/wp-admin/ GET /api/audit/reponse?id=k7m2p9x4vq8n3b6s&point=ssl&resultat=ok¬e=https%20partout,%20cadenas%20valide GET /api/audit/reponse?id=k7m2p9x4vq8n3b6s&point=sitemap&resultat=fail¬e=Aucun%20sitemap.xml%20a%20la%20racine … GET /api/audit/terminer?id=k7m2p9x4vq8n3b6s → { "score": 72, "verdict": "warn", "rapport": "https://docteurseo.com/audit/k7m2p9x4vq8n3b6s" } ``` ## Pour aller plus loin - Le modèle à remplir à la main : - La méthode complète, seuils compris : - L'examen automatique (vitesse, mobile, visibilité) :