Connecter la Search Console à son agent IA

Un agent IA ne devine pas votre trafic. Pour qu'il analyse vos requêtes, vos pages et vos positions réelles, il faut lui donner un accès en lecture à la Search Console. Cet accès passe par un client OAuth Google, et c'est l'étape qui fait abandonner la plupart des gens.

Elle se fait une fois. Comptez vingt minutes la première fois, cinq les suivantes. À la fin, vous tapez /gsc-seo dans votre agent et il déroule ses collectes tout seul.

Ce guide décrit l'installation du skill gsc-seo. Les deux autres skills publics, concurrence-seo et maillage-interne, n'ont besoin d'aucun accès : un git clone et ils tournent.

Ce dont vous avez besoin

• Un compte Google qui a déjà accès à la propriété Search Console du site. C'est le piège numéro un : si vous créez le projet Google Cloud avec une autre adresse que celle qui possède la propriété, tout se passera bien jusqu'au dernier appel, qui renverra une liste vide.
• Python 3 installé.
• Un agent qui lit des skills : Claude Code, Hermes, OpenClaw ou Codex.

1. Créer le projet Google Cloud

Ouvrez la Google Cloud Console et créez un projet. Son nom n'a aucune importance, il ne sera jamais affiché ailleurs.

Google demande parfois d'associer une facturation à un projet neuf. L'API Search Console n'est pas concernée : elle est gratuite et son quota par défaut dépasse largement ce qu'un agent consomme.

2. Activer l'API Search Console

Dans le menu, allez dans APIs & Services → Library, cherchez « Search Console API », ouvrez-la et cliquez sur Enable.

Attention à ne pas activer par erreur « Google Search Console API » dans une version dépréciée, ni l'API Custom Search, qui est un produit différent et payant.

3. Configurer l'écran de consentement

Toujours dans APIs & Services, ouvrez OAuth consent screen et choisissez le type External. Renseignez le minimum demandé : un nom d'application, une adresse de support, une adresse de contact.

Puis, et c'est ce que tout le monde oublie, ajoutez votre propre adresse Google dans Test users. Sans ça, l'autorisation sera refusée avec un message qui parle de vérification d'application, ce qui laisse penser à tort qu'il faut soumettre l'application à Google.

L'application peut rester en mode test : elle n'est utilisée que par vous. Le jeton d'un projet en test expire au bout de sept jours. Si vos collectes s'arrêtent une semaine après, c'est ça, et pas votre configuration : publiez l'application depuis le même écran et le problème disparaît.

4. Créer le client OAuth

APIs & Services → Credentials → Create credentials → OAuth client ID, et choisissez le type Desktop app.

Le type compte. Un client de type Web attend une URL de redirection et échouera avec une erreur redirect_uri_mismatch lors de l'autorisation, puisque le CLI ouvre un serveur local éphémère.

Téléchargez le JSON et déposez-le à l'emplacement attendu :

mkdir -p ~/.config/gsc
mv ~/Téléchargements/client_secret_*.json ~/.config/gsc/credentials.json

5. Installer le CLI

git clone https://github.com/lavallemarcaurele/gsc-seo.git
cd gsc-seo
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt

Déclarez ensuite l'emplacement du dépôt dans votre shell, dans ~/.zshrc ou ~/.bashrc. Le skill s'en sert pour retrouver le CLI :

export GSC_HOME="$HOME/chemin/vers/gsc-seo"

6. La première autorisation

source "$GSC_HOME/.venv/bin/activate"
python "$GSC_HOME/gsc.py" list

Un navigateur s'ouvre et demande l'autorisation. Acceptez avec le compte Google qui a accès à la propriété. Le jeton est écrit dans ~/.config/gsc/token.json et se rafraîchit ensuite tout seul.

La commande affiche vos propriétés. Notez la forme exacte de celle qui vous intéresse : une propriété de domaine s'écrit sc-domain:monsite.fr, une propriété de préfixe d'URL s'écrit https://monsite.fr/. Ce ne sont pas des synonymes, et donner l'une pour l'autre renvoie une erreur d'autorisation alors que l'accès est bon.

Ni credentials.json ni token.json ne doivent finir dans un dépôt Git. Ce sont des identifiants : le .gitignore du dépôt s'en charge, vérifiez qu'ils n'ont pas été copiés ailleurs.

7. Installer le skill dans votre agent

Pour un seul projet :

mkdir -p .claude/skills
cp -r "$GSC_HOME/.claude/skills/gsc-seo" .claude/skills/

Pour tous vos projets :

cp -r "$GSC_HOME/.claude/skills/gsc-seo" ~/.claude/skills/

Puis, dans votre agent : /gsc-seo. Au premier lancement sur un projet, le skill demande la propriété Search Console associée et la mémorise. Il ne repose plus la question ensuite.

Si ça ne marche pas

La liste des propriétés est vide. Le compte utilisé pour l'autorisation n'est pas celui qui a accès à la Search Console. Supprimez ~/.config/gsc/token.json et relancez gsc.py list pour rechoisir le compte.

L'autorisation est refusée. Votre adresse n'est pas dans les utilisateurs de test de l'écran de consentement.

redirect_uri_mismatch. Le client OAuth n'est pas de type Desktop app. Recréez-en un, le bon type ne se change pas après coup.

Tout marchait, plus rien ne marche au bout d'une semaine. L'application est restée en mode test. Publiez-la.

Et ensuite

Une fois cet accès en place, le skill lance ses sept collectes, croise trois fenêtres temporelles et rend un rapport avec cinq priorités. Le guide faire un audit SEO complet avec un agent IA déroule l'enchaînement avec les deux autres skills, et détecter la cannibalisation SEO creuse la collecte la moins évidente des sept.

C'est le même accès qui sert au pack SEO/GEO complet, où il est configuré avec vous pendant l'installation.