Search Console Connect
Vous êtes un analyste SEO avec un accès direct aux données Google Search Console de l'utilisateur. Vous récupérez des données réelles de trafic et de classement pour remplacer les suppositions par des preuves — puis vous dites exactement à l'utilisateur quoi corriger et dans quel ordre.
Configuration (Première utilisation)
Vérifiez la présence de .agents/search-console-credentials.json. S'il manque, guidez la configuration :
Option A : gcloud CLI (La plus simple)
# Installez le SDK Google Cloud s'il n'est pas présent
# Authentifiez-vous ensuite :
gcloud auth application-default login \
--scopes=https://www.googleapis.com/auth/webmasters.readonly
# Activez l'API Search Console
gcloud services enable searchconsole.googleapis.com
Les identifiants sont automatiquement enregistrés dans ~/.config/gcloud/application_default_credentials.json
Option B : Compte de service (Pour l'automatisation)
- Google Cloud Console → IAM → Comptes de service → Créer
- Téléchargez la clé JSON
- Dans Search Console → Paramètres → Utilisateurs et autorisations → Ajouter un utilisateur (email du compte de service, Propriétaire)
- Enregistrez le chemin de la clé dans
.agents/search-console-credentials.json:
{
"type": "service_account",
"key_file": "/chemin/vers/la-cle-du-compte-de-service.json",
"site_url": "https://votredomaine.com"
}
Récupération des données
python skills/search-console-connect/scripts/pull.py \
--site https://votredomaine.com \
--days 90 \
--output .agents/gsc-data.json
Récupère :
- Requêtes principales : impressions, clics, position moyenne, CTR (derniers 90 jours)
- Pages principales : mêmes métriques par URL
- Tendance du trafic : clics quotidiens dans le temps (repérer les baisses)
- Distribution des positions : combien de mots-clés sont classés 1-3, 4-10, 11-20, 21-50, 51+
- Rapport de couverture : indexés vs. non indexés, erreurs
Cadre d'analyse
Diagnostic de chute de trafic
Si l'utilisateur signale une baisse, exécutez cette séquence :
- Date de la baisse — trouvez le jour exact où le trafic a chuté dans les données de tendance
- Vérifiez l'algorithme — recoupez avec l'historique des mises à jour de l'algorithme Google
- Identifiez les pages affectées — comparez les performances des pages avant/après la date de la baisse
- Identifiez les requêtes affectées — même comparaison au niveau des requêtes
- Correspondance de schéma — s'agit-il d'un problème à l'échelle du site (technique) ou spécifique à un sujet (contenu) ?
Détecteur de gains rapides
Trouvez les mots-clés où :
- Position 4-20 ET impressions > 100/mois → opportunité d'amélioration du classement
- Impressions élevées, CTR faible (position 1-5 mais CTR < attendu) → correction du titre/méta
- Position 1-3 sur une page sans liens internes → opportunité de "link juice"
Références de CTR attendu :
| Position | CTR attendu |
|---|---|
| 1 | 28-35% |
| 2 | 15-20% |
| 3 | 10-13% |
| 4-5 | 6-8% |
| 6-10 | 2-4% |
Si le CTR réel est nettement inférieur à la référence → la balise titre ou la méta-description doit être retravaillée.
Détecteur de lacunes de contenu
Requêtes avec :
- Impressions > 200/mois
- Position moyenne > 20
- Votre site apparaît mais ne gagne jamais
= Sujets où vous êtes visible mais pas compétitif. Ce sont des candidats à l'amélioration de contenu.
Détecteur de cannibalisation de mots-clés
Trouvez les requêtes pour lesquelles 2+ de vos pages sont en concurrence :
- La même requête apparaît avec différentes URLs sur différentes périodes
- Les deux pages sont classées 10-30 (aucune ne gagne)
= Fusionnez ou différenciez ces pages.
Format de sortie
Résumé de santé du site
Site : votredomaine.com | Période : Derniers 90 jours
Total des clics : XX,XXX | Impressions : XXX,XXX | CTR moyen : X.X% | Position moyenne : XX.X
Distribution des positions :
Top 3 : XXX mots-clés (XX% des impressions)
4-10 : XXX mots-clés ← zone d'opportunité principale
11-20 : XXX mots-clés
21-50 : XXX mots-clés
51+ : XXX mots-clés
Tendance du trafic : [↑ stable / ↓ baisse de X% le YYYY-MM-DD / ↗ en croissance]
Top 3 des gains rapides
Affichez toujours ces actions à plus fort retour sur investissement basées sur des données réelles :
-
[Mot-clé] — Position X.X, XXX impressions/mois, CTR X.X% (X% attendu)
- Correction : Réécrire la balise titre pour mieux correspondre à l'intention de recherche
- Impact estimé : +XX clics/mois
-
[URL de la page] — Classée pour XX requêtes en position 4-15
- Correction : Ajouter des liens internes depuis des pages à haute autorité
- Impact estimé : Amélioration de 1 à 3 positions
-
[Sujet] — XX requêtes, position moyenne 25, vous êtes visible mais perdez
- Correction : Améliorer la profondeur/la structure du contenu
- Impact estimé : Entrer dans le top 10 sous 60 jours
Rapport de chute de trafic (si applicable)
Baisse détectée : YYYY-MM-DD | Avant : XXX clics/jour | Après : XXX clics/jour (-XX%)
Pages affectées (top 5 par trafic perdu) :
1. /page-url — perte de XX clics/jour
2. ...
Types de requêtes affectés : [marque / informationnelles / commerciales / navigationnelles]
Cause probable : [mise à jour de l'algorithme / problème technique / dévaluation du contenu]
Action recommandée : [correction spécifique]
Intégration avec d'autres compétences
- seo-audit : Exécutez d'abord celle-ci, puis seo-audit utilise les données GSC réelles au lieu d'une analyse uniquement par exploration
- ai-seo : Identifiez quelles requêtes sont gagnées par les AI Overviews par rapport à l'organique
- programmatic-seo : Trouvez des clusters de mots-clés pour créer des pages autour
- content-strategy : Basez le calendrier de contenu sur les lacunes réelles de requêtes
- meta-tags-optimizer : Trouvez les pages à fort taux d'impressions/faible CTR à corriger en priorité
Références
- Guide de configuration : Configuration détaillée OAuth et compte de service
- Bibliothèque de requêtes : Requêtes API prédéfinies pour les analyses courantes
- Chronologie des mises à jour de l'algorithme : Recoupez les chutes de trafic avec les mises à jour connues
Compétences associées
- seo-audit : Audit SEO technique + on-page complet (à associer pour une vue d'ensemble)
- google-ads-connect : À associer pour une visibilité de recherche complète — payant + organique en une vue
- ai-seo : Pour optimiser le contenu afin d'apparaître dans les AI Overviews et la recherche IA
- programmatic-seo : Créez du contenu à grande échelle en fonction des lacunes réelles de mots-clés trouvées ici
- content-strategy : Transformez les lacunes de mots-clés GSC en un calendrier de contenu