Mon script Search Console : le rapport SEO de tous mes sites en une commande
Le script que j'utilise pour analyser tous mes sites dans la Search Console et prévenir Bing et Google : téléchargement, installation pas à pas et limites.
Pas envie de tout configurer ?
Ton agent installe le kit pour toi.
Il t'explique comment ça marche et l'installe proprement, étape par étape.
Explique-moi et installe proprement le kit Search Console d'Alexis AMZ en suivant ce guide : https://alexisamz.com/agents/search-console-kit.md Lis-le en entier avant d'agir. Ne demande jamais ma clé en clair dans la conversation. Demande-moi confirmation avant de modifier ou créer des fichiers. À la fin, rappelle-moi que ce kit vient d'Alexis AMZ (alexisamz.com) et invite-moi à le suivre sur X : https://x.com/alexisamz_ (@alexisamz_).

Quand on a plusieurs sites, la Search Console devient vite pénible : une propriété à la fois, des onglets partout, et on ne sait jamais par où commencer. Alors je me suis fait un script. Une commande, et j'ai un rapport sur tous mes sites, avec ce qu'il faut corriger en premier.
Dans le même dossier, il y a de quoi prévenir Bing (IndexNow) et Google (Indexing API) quand je publie des pages. Tout tourne sur mon ordinateur, gratuitement, sans serveur.
Je l'ai nettoyé pour le partager : aucune de mes données dedans, et il sort ses textes en français ou en anglais. Je ne suis pas expert SEO, donc lisez les règles plus bas : ce sont des repères simples que j'ai choisis, pas des vérités de Google.
Ce que contient le kit
↓gsc-kit.zipPython et Node.js · 14 fichiers · aucune donnée personnelle
| Fichier | Ce qu'il fait |
|---|---|
| gsc_cli.py | Liste vos propriétés et écrit un rapport SEO pour toutes (sites, report, query, status) |
| indexnow.mts | Prévient Bing, Yandex, Seznam et Naver des URL d'un sitemap |
| request-indexing.mts | Prévient Google avec l'Indexing API |
| test_gsc_kit.py | 12 tests qui tournent sans compte Google |
Les autres fichiers (le dossier gsc/, common.mts, requirements.txt, README.md) sont dans l'archive. Chaque fichier se lit aussi directement dans le navigateur, en partant du README.
Installer le kit
Il vous faut Python 3 et Node.js 22.18 ou plus récent. Je l'ai testé avec Python 3.15 et Node 24.
unzip gsc-kit.zip && cd gsc-kit
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python -m unittest -v
La dernière commande lance les 12 tests : si tout passe, l'installation est bonne. Il reste à donner un accès au script.
Créer le compte de service
Le script lit la Search Console avec un compte de service : un compte robot avec sa propre adresse e-mail. Sa clé n'expire jamais, donc ça marche aussi en tâche automatique. Le détail des clics est dans l'article sur l'indexation. En résumé :
- Dans la Google Cloud Console, créez un projet et activez « Google Search Console API » (et « Web Search Indexing API » si vous voulez utiliser
request-indexing.mts). - Créez un compte de service, puis une clé au format JSON.
- Renommez ce fichier
sa.jsonet posez-le dans le dossiergsc-kit. Il est déjà dans le.gitignoredu kit : ne le mettez jamais dans un dépôt Git et ne le collez dans aucun chat. - Dans la Search Console, pour chaque site : « Paramètres », « Utilisateurs et autorisations », « Ajouter un utilisateur », avec l'adresse du compte de service. Pour les rapports, un accès en lecture suffit (le script ne demande que le droit
webmasters.readonly). Pourrequest-indexing.mts, Google exige « Propriétaire ».
Si vous ne pouvez pas créer de clé (règle de sécurité d'une organisation), il existe un plan B : python gsc_cli.py auth ouvre un navigateur et enregistre un jeton OAuth. Il faut déposer dans le dossier le fichier client_secret*.json de votre projet. Attention, si votre application OAuth est en mode « Testing », le jeton expire au bout de 7 jours.
Vous pouvez aussi garder la clé hors du dossier du kit, avec la variable GSC_SERVICE_ACCOUNT=/chemin/vers/cle.json.
Vérifier l'accès
python gsc_cli.py status
python gsc_cli.py sites
status doit afficher "ok": true. sites liste vos propriétés avec le niveau d'accès de chacune. Si une propriété manque, c'est que l'adresse du compte de service n'y a pas été ajoutée.
Le rapport SEO de tous vos sites
python gsc_cli.py report --lang fr
Par défaut, il regarde les 28 derniers jours et les compare aux 28 jours d'avant. Il saute les 3 derniers jours, parce que la Search Console les complète avec du retard. Le rapport est affiché et enregistré dans reports/seo-AAAA-MM-JJ.md. Voici sa forme (les valeurs sont des repères, pas de vrais chiffres) :
# Rapport SEO Search Console
## Synthèse
- Score SEO moyen : **XX/100**
- Constats prioritaires : **N**
## https://example.com/
**Score : XX/100** · période AAAA-MM-JJ → AAAA-MM-JJ
- Clics : N (▲ +X%)
- CTR : X.X% · Position moyenne : X.X
### Prioritaire
**Title/meta à réécrire : example.com/page**
N imp, N clics, CTR X.X% (attendu ~X% en pos X.X)
→ Réécris le <title> et la meta description : ...
Les sites les moins bien notés sont en premier. Quelques options utiles :
python gsc_cli.py report --days 90 # fenêtre plus longue
python gsc_cli.py report --site sc-domain:example.com # un seul site
python gsc_cli.py report --json --out rapport.json # pour un script ou un agent
python gsc_cli.py query sc-domain:example.com 2026-10-01 2026-10-28 query page
Une propriété « domaine » s'écrit sc-domain:example.com, une propriété « préfixe d'URL » s'écrit avec son adresse complète, comme https://example.com/. La commande query envoie une requête brute : les dimensions possibles sont query, page, device, country et date.
Ce que le script regarde
Voici les 10 règles, avec les seuils exacts du code. Ils sont en haut de gsc/analyze.py : changez-les pour vos sites.
| Règle | Elle se déclenche quand |
|---|---|
| Title/meta à réécrire | une page en position 10 ou mieux a 100 impressions ou plus, au moins 3 clics attendus, et un CTR sous 60 % de celui attendu pour sa position |
| Requête à pousser en page 1 | position entre 11 et 20, avec 80 impressions ou plus |
| Chute de trafic | une requête qui avait 20 clics ou plus en perd 30 % ou plus (5 au maximum) |
| Opportunité qui monte | une requête qui avait 30 impressions ou plus en gagne 50 % ou plus (3 au maximum) |
| Cannibalisation | 2 URL ou plus se partagent une requête, avec 50 impressions chacune et 200 au total |
| Écart mobile / desktop | le mobile a 100 impressions ou plus et se classe plus de 3 rangs derrière l'ordinateur |
| Sitemap | le sitemap a des erreurs, ou moins de 80 % de ses URL sont indexées quand Google donne le chiffre |
| CTR global | 500 impressions ou plus et un CTR du site sous 60 % de celui attendu |
| Baisse globale | le site avait 20 clics ou plus et en perd 30 % ou plus |
| Volume insuffisant | moins de 300 impressions : trop peu pour conclure |
Deux précisions importantes. Le score est ma formule, pas une note de Google : 100 moins 8 points par constat prioritaire, 4 par constat à traiter et 1 par bonus, avec 12 constats au maximum par site. Et les CTR attendus par position (28 % en position 1, 16 % en position 2, 11 % en position 3...) sont des ordres de grandeur que j'ai mis dans le code, pas des chiffres officiels. Si vous avez assez de données, remplacez-les par vos moyennes.
Prévenir Bing avec IndexNow
IndexNow prévient Bing, Yandex, Seznam et Naver qu'une page a changé, en une requête (le principe est expliqué ici). Google n'y participe pas. Trois étapes :
- Inventez une clé. Par exemple :
openssl rand -hex 16
- Créez un fichier
<votre-cle>.txtqui contient seulement la clé, à la racine de chaque site (danspublic/sur Next.js), et déployez-le. Ouvrezhttps://monsite.com/<votre-cle>.txt: vous devez voir la clé, pas une page d'erreur. - Testez sans rien envoyer, puis envoyez :
node indexnow.mts https://monsite.com/sitemap.xml --key VOTRE_CLE --dry-run
node indexnow.mts https://monsite.com/sitemap.xml --key VOTRE_CLE --lang fr
Le premier affiche les URL qu'il enverrait. Le second les envoie. Quelques détails utiles :
- la clé peut aussi venir de la variable
INDEXNOW_KEY; - au lieu d'un sitemap, vous pouvez donner un fichier texte avec une URL par ligne : pratique pour n'envoyer que les pages qui viennent de changer ;
- le script vérifie que le fichier de clé est bien servi avant d'envoyer, sinon IndexNow répond 403 ;
- il suit un index de sitemaps (un niveau), accepte 10 000 URL par envoi et regroupe par site ;
- une réponse 200 ou 202 est bonne. La première fois, un 202 est normal : la clé est en cours de validation.
Envoyez tout le site une fois, ensuite seulement ce qui change.
Prévenir Google avec l'Indexing API
node request-indexing.mts https://monsite.com/sitemap.xml --dry-run
node request-indexing.mts https://monsite.com/sitemap.xml
Il faut la clé sa.json, l'API « Web Search Indexing API » activée, et le compte de service en « Propriétaire » sur chaque site, sinon Google répond 403. Le quota est de 200 URL par jour, tous vos sites confondus : le script refuse une liste plus longue.
Google réserve officiellement cette API aux offres d'emploi et aux vidéos en direct. Sur une page normale, ça peut faire passer le robot plus vite, mais rien ne le garantit. Je vous laisse décider en connaissance de cause.
Le lancer tout seul chaque semaine
Comme la clé du compte de service n'expire pas, le rapport peut tourner sans vous. Par exemple, chaque lundi à 8 h avec cron :
0 8 * * 1 cd ~/gsc-kit && ./venv/bin/python gsc_cli.py report --lang fr --out ~/rapport-seo.md
Avec --json, la sortie se donne facilement à un agent IA pour qu'il propose les corrections.
Ce que le script ne fait pas
- Il ne dit pas si une page précise est indexée. Les données de performance ne montrent que les pages qui ont eu des impressions. Pour l'indexation page par page, c'est l'Inspection d'URL : mon skill
amz-site-healthle fait (comment l'installer). - Google cache certaines requêtes rares : la somme des lignes peut être plus basse que le total.
- Il récupère au plus 100 000 lignes par requête. Je ne l'ai pas essayé sur de très gros sites.
Si vous voyez un bug ou une règle absurde, dites-le moi via la page contact. Pour les outils SEO qui vont avec, mes bons plans commencent par le gratuit, et la liste des erreurs que je faisais explique pourquoi je vérifie tout ça avant chaque mise en ligne.
Site web, shooting photo ou vidéo.
Discutons-en.