Audit de portefeuille GSC
Répond à la question « comment va tout le monde ? » sur toutes les propriétés d'un compte Search Console — une question à laquelle les outils par site ne peuvent répondre sans des dizaines d'exportations manuelles.
Configuration
Nécessite un jeton d'actualisation OAuth avec le champ d'application https://www.googleapis.com/auth/webmasters.readonly :
export GOOGLE_GSC_CLIENT_ID=... # ou GOOGLE_CLIENT_ID
export GOOGLE_GSC_CLIENT_SECRET=... # ou GOOGLE_CLIENT_SECRET
export GOOGLE_REFRESH_TOKEN=...
export GSC_EXCLUDE="olddomain.com" # optionnel, séparé par des virgules
pip install requests
L'échec de configuration le plus courant est unauthorized_client lors de l'actualisation du jeton. Cela signifie que le jeton d'actualisation a été émis pour un client OAuth différent de l'identifiant/secret que vous lui associez. Les comptes qui ont ajouté des intégrations Google au fil du temps ont généralement plusieurs clients ; faites correspondre la paire qui a émis le jeton.
Exécution
python3 scripts/audit_gsc.py # complet : classement + comparaison des requêtes pour les 12 premiers
python3 scripts/audit_gsc.py portfolio # juste le tableau classé
python3 scripts/audit_gsc.py queries --site sc-domain:exemple.com
python3 scripts/audit_gsc.py --days 90 # trimestre sur trimestre
Indicateurs : --days (fenêtre, comparée à la fenêtre immédiatement précédente), --site (répétable), --top, --limit, --min-clics.
Sections et leur signification
| Section | Interprétation |
|---|---|
| NOUVEAU | Requêtes avec zéro clic lors de la période précédente. Là où la croissance se produit réellement. |
| EN HAUSSE | En hausse ≥50 %. Vérifiez si la position a également changé : si ce n'est pas le cas, la demande a augmenté, pas votre classement. |
| EN BAISSE | En baisse ≥40 % par rapport à une base réelle. La position vous indique de quel type il s'agit : classement en baisse = perte de classement ; classement stable mais clics effondrés = quelque chose a pris les clics au-dessus de vous (Aperçu IA, nouvelle fonctionnalité SERP, ou la requête a changé de forme). |
| PERDU | Classé avant, aucune donnée maintenant. |
| ÉCART DE CTR | ≥1 500 impressions, top 10, moins de 2 % de CTR. Réécritures de titres et de descriptions, les gains les moins chers disponibles. |
Interprétation
- Rapportez d'abord les clics, puis les impressions. Une seule grande propriété peut faire varier les impressions du portefeuille au point de masquer le fait que tout le reste a augmenté.
- Séparez la marque de la non-marque. Un site dont l'ensemble des mots-clés se résume à son propre nom (ou à des fautes d'orthographe du nom d'un concurrent) n'a pas de moteur d'acquisition, même si le nombre de clics semble bon. Dites-le clairement dans le rapport.
- L'effondrement complet d'un site sur son propre terme de marque n'est généralement pas du SEO. Vérifiez la propriété avant de diagnostiquer les classements :
whois <domaine> | grep -i "registrar\|updated date"plus vérifiez s'il résout toujours. Les domaines expirés, transférés ou contestés produisent une falaise de classement textuelle qu'aucun travail SEO ne pourra réparer. - « nouveau » dans le tableau du portefeuille signifie zéro clic dans la fenêtre précédente, ce qui pour un site récemment lancé est un lancement, pas une lacune de données.
- Ne négligez pas les requêtes dans des langues que vous ne lisez pas. Sur les sites multi-marchés, la croissance se trouve généralement dans la longue traîne non anglaise ; traduisez les intéressantes plutôt que de les filtrer.
- Une propriété qui renvoie une erreur 403 est vérifiée pour le référencement mais pas pour les analyses de recherche. Le script la signale au lieu de la cacher.
Remarques
- Les données GSC accusent un retard d'environ 3 jours ; le script compense automatiquement ce décalage.
- Les deux périodes sont récupérées par propriété en parallèle, donc un compte de 40 propriétés ne prend que quelques secondes.
- Les lignes de requêtes sont limitées à 25 000 par période, bien au-dessus de ce qu'un seul site renvoie pour une fenêtre de 28 jours.