Installez le modèle d'audit du Docteur dans Claude ou ChatGPT : vous demandez « fais l'audit de monsite.fr », il passe les 18 points et vous rend un rapport à ouvrir. Gratuit, sans compte, sans clé API.
Pour Claude Desktop, déposez le fichier dans un dossier de compétences ; pour ChatGPT, un GPT ou un projet Gemini, collez simplement le contenu ci-dessous dans les instructions.
Le skill, en entier
7 Ko de markdown
Copiez-le dans un fichier SKILL.md, ou dans les instructions de votre assistant. Version brute à télécharger : skill/audit-seo/SKILL.md.
SKILL.md
---
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 : <https://docteurseo.com/outils/skill-claude-seo>
## 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 <https://pagespeed.web.dev/> (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 : <https://docteurseo.com/outils/audit-seo>
- La méthode complète, seuils compris : <https://docteurseo.com/comment-faire-un-audit-seo>
- L'examen automatique (vitesse, mobile, visibilité) : <https://docteurseo.com/>
Ce que l'assistant fait, et ce qu'il ne peut pas faire
Le skill l'oblige à distinguer les deux, parce que c'est là que les audits automatiques deviennent trompeurs. Il établit ce qui se mesure vraiment :
les quatre adresses du site (http, https, avec et sans www) arrivent-elles au même endroit ;
le robots.txt — son contenu réel, et s'il déclare un plan de site ;
le sitemap.xml : présent, nombre d'adresses, index de sitemaps ;
la balise noindex et l'en-tête X-Robots-Tag ;
les en-têtes de sécurité (HSTS, CSP…), que l'assistant ne verrait pas en lisant la page ;
le titre de la page, le nombre d'images sans description, le nombre de scripts.
Il ne peut pas mesurer la vitesse : PageSpeed demande de charger réellement le site, 20 à 60 secondes, ce qu'un appel d'assistant ne tient pas. Il ne peut pas non plus compter vos pages connues de Google. Le skill lui demande donc de vous réclamer ces chiffres — ou de laisser ces points vides. Un point vide ne compte pas dans le score ; un verdict inventé, lui, rendrait le rapport faux.
L'API, en cinq adresses
Tout est en GET, sans clé, pour rester à portée d'un assistant qui sait seulement ouvrir une adresse.
API
GET /api/audit/points
le référentiel : 18 points, avec pour chacun comment le vérifier
GET /api/audit/nouveau?url=monsite.fr&agent=claude-code
ouvre un audit → identifiant + adresse du rapport
GET /api/audit/mesures?url=monsite.fr
les faits mesurables côté serveur (bruts, sans verdict)
GET /api/audit/reponse?id=ID&point=robots&resultat=ok¬e=...
inscrit un résultat : ok | warn | fail
GET /api/audit/terminer?id=ID
clôt l'audit → score, points bloquants, lien du rapport
Base : https://docteurseo.com · Un audit ouvert sur un même site est repris pendant deux heures au lieu d'être dupliqué · Rate-limit par adresse IP.
Pourquoi tout en GET ?
Parce que c'est le seul verbe qu'un assistant sait employer sans configuration. Ce n'est pas l'usage canonique d'une API, et c'est un choix assumé : aucune donnée sensible ne circule, l'identifiant d'audit n'est pas devinable, les écritures sont bornées à une liste blanche de 18 points, et au pire un lien préchargé crée un audit vide.
Et si l'assistant se trompe ?
Cela arrivera. Un rapport porte le nom de l'assistant qui l'a rempli et la mention qu'il n'engage pas le Docteur. La bonne suite est toujours la même : reprendre le modèle à la main, où chaque ligne indique où regarder. C'est aussi la raison d'être de l'outil — vous devez pouvoir vérifier ce qu'on vous dit sur votre site, qu'un humain ou une machine vous l'ait dit.
Questions sur le skill
Qu’est-ce qu’un skill Claude, concrètement ?
C'est un dossier contenant un fichier SKILL.md : des instructions que l'assistant charge quand la tâche s'y prête. Ici, le fichier explique comment mener un audit technique en 18 points et comment enregistrer les résultats. Vous le déposez une fois, et il suffit ensuite de demander « fais l'audit SEO de monsite.fr ».
Faut-il un compte ou une clé API ?
Non, ni l'un ni l'autre. L'API est ouverte, en lecture comme en écriture, et ne demande qu'un identifiant libre pour l'assistant appelant (paramètre agent) — il sert à afficher sur le rapport qui l'a rempli. Un rate-limit protège le service, c'est tout.
L’IA peut-elle vraiment tout vérifier toute seule ?
Non, et le skill le lui interdit explicitement. Elle établit ce qui se mesure par programme : redirections, robots.txt, plan de site, balise noindex, en-têtes de sécurité, images sans description. Elle ne peut pas mesurer la vitesse (PageSpeed demande 20 à 60 secondes et une exécution réelle du site) ni compter vos pages connues de Google : elle doit vous demander ces chiffres, ou laisser ces points vides. Un point vide ne pénalise pas le score — un verdict inventé, lui, rendrait le rapport faux.
Ça marche avec ChatGPT, ou seulement avec Claude ?
Avec les deux, et avec n'importe quel assistant capable d'ouvrir une adresse web. Le format « skill » est celui de Claude, mais le fichier n'est que du texte : collez-le dans les instructions d'un GPT, d'un projet Gemini ou de votre propre agent. Toute l'API est en GET, précisément pour rester à portée d'un assistant qui ne sait que naviguer.
Où vont les données de l’audit ?
Le rapport est enregistré chez nous, puisque l'assistant n'a pas de navigateur où le ranger : nous gardons l'adresse auditée, les 18 résultats, les notes écrites par l'assistant et l'identifiant qu'il a déclaré. La page du rapport est en noindex et son adresse n'est pas devinable. Rien d'autre n'est collecté : ni email, ni compte, ni identifiant de visiteur.
Le rapport est-il fiable ?
Il vaut ce que vaut la vérification qui l'a produit — c'est écrit sur la page du rapport. Les faits techniques (robots.txt, certificat, en-têtes) sont mesurés par notre serveur et sont donc solides. Les appréciations restent celles de l'assistant. Pour trancher, reprenez le modèle à la main : chaque ligne se vérifie en quelques minutes.
Vous préférez le faire vous-même ?
Le même modèle, en version à remplir : 18 questions posées une par une, avec pour chacune où regarder et quel outil gratuit donne la réponse.
