Aller au contenu principal
alexis_amzFR / EN
Retour au blog

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.

Article publié// script-search-console-indexnow
Mon script Search Console : le rapport SEO de tous mes sites en une commande

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

FichierCe qu'il fait
gsc_cli.pyListe vos propriétés et écrit un rapport SEO pour toutes (sites, report, query, status)
indexnow.mtsPrévient Bing, Yandex, Seznam et Naver des URL d'un sitemap
request-indexing.mtsPrévient Google avec l'Indexing API
test_gsc_kit.py12 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.

bash5 lignes
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é :

  1. 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).
  2. Créez un compte de service, puis une clé au format JSON.
  3. Renommez ce fichier sa.json et posez-le dans le dossier gsc-kit. Il est déjà dans le .gitignore du kit : ne le mettez jamais dans un dépôt Git et ne le collez dans aucun chat.
  4. 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). Pour request-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

bash2 lignes
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

bash1 lignes
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) :

markdown14 lignes
# 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 :

bash4 lignes
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ègleElle se déclenche quand
Title/meta à réécrireune 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 1position entre 11 et 20, avec 80 impressions ou plus
Chute de traficune requête qui avait 20 clics ou plus en perd 30 % ou plus (5 au maximum)
Opportunité qui monteune requête qui avait 30 impressions ou plus en gagne 50 % ou plus (3 au maximum)
Cannibalisation2 URL ou plus se partagent une requête, avec 50 impressions chacune et 200 au total
Écart mobile / desktople mobile a 100 impressions ou plus et se classe plus de 3 rangs derrière l'ordinateur
Sitemaple sitemap a des erreurs, ou moins de 80 % de ses URL sont indexées quand Google donne le chiffre
CTR global500 impressions ou plus et un CTR du site sous 60 % de celui attendu
Baisse globalele site avait 20 clics ou plus et en perd 30 % ou plus
Volume insuffisantmoins 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 :

  1. Inventez une clé. Par exemple :
bash1 lignes
openssl rand -hex 16
  1. Créez un fichier <votre-cle>.txt qui contient seulement la clé, à la racine de chaque site (dans public/ sur Next.js), et déployez-le. Ouvrez https://monsite.com/<votre-cle>.txt : vous devez voir la clé, pas une page d'erreur.
  2. Testez sans rien envoyer, puis envoyez :
bash2 lignes
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

bash2 lignes
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 :

bash1 lignes
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-health le 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.

> Un projet en tête ?

Site web, shooting photo ou vidéo.
Discutons-en.

Me contacter