Comment connecter Google Search Console à Claude Code avec le MCP

Pourquoi connecter Search Console à un assistant de code ?

Claude Code est précieux quand le travail SEO touche le site lui-même. Dans le même environnement de développement, vous pouvez inspecter les templates, corriger des redirections, modifier des title, tester un build et relire un sitemap. Mais votre code source ne peut pas vous dire quelle page a perdu 300 clics Google la semaine dernière.

Sans accès à Search Console, un assistant peut examiner une page et faire des suggestions raisonnables. Il ne peut pas distinguer un problème prioritaire d’un sujet que personne ne recherche. Cette différence compte quand on manque de temps.

Une connexion MCP ajoute la source de preuves qui manquait. Vous pouvez demander à Claude Code d’identifier les URL concernées dans Search Console, de les comparer aux templates locaux des pages et de préparer des modifications de code fondées sur une véritable enquête.

Ce guide traite du workflow dans le terminal de Claude Code, pas du connecteur du site web de Claude. Si vous travaillez surtout dans un navigateur, suivez notre guide d’installation de Search Console dans Claude.

Ce qu’il vous faut avant de lancer une commande

Il vous faut Claude Code installé et fonctionnel dans un terminal, un compte Google ayant accès à la propriété Search Console visée, et un serveur MCP capable d’obtenir les données de cette propriété. Le serveur peut être auto-hébergé ou distant.

Les étapes ci-dessous utilisent l’endpoint hébergé de GSC Magic. Selon la documentation de GSC Magic, il accepte le transport Streamable HTTP et prend en charge la connexion par OAuth ou par jeton d’accès. Votre compte doit être provisionné et le service accessible : saisir une URL valide ne signifie pas que l’authentification a réussi.

Commencez par vérifier que Claude Code lui-même fonctionne. Ouvrez-le dans un projet quelconque et assurez-vous de pouvoir saisir des prompts. Pas besoin de cloner tout votre site en production pour tester une connexion Search Console en lecture seule.

Avant de vous connecter, décidez si le travail porte sur un site ou plusieurs. On se trompe facilement de propriété Search Console quand un compte Google donne accès à des sites clients, à des domaines de préproduction et à d’anciennes propriétés de préfixe d’URL.

Étape 1 : ajouter l’endpoint MCP distant

Ouvrez votre terminal et lancez la commande suivante :

claude mcp add --transport http --scope user gsc-magic https://mcp.gscmagic.com/mcp

Voici le rôle de chaque élément. claude mcp add enregistre un serveur auprès de Claude Code. Le transport http désigne un service MCP distant plutôt qu’un exécutable local. --scope user rend le connecteur disponible dans votre configuration au niveau utilisateur. Le nom court gsc-magic est simplement l’identifiant que vous verrez dans votre liste d’outils.

L’URL est l’endpoint distant documenté pour GSC Magic. Ce n’est ni l’URL de votre propriété Search Console, ni le sitemap de votre site, ni un endpoint d’API Google.

Pourquoi le scope utilisateur ? Si vous faites du SEO sur plusieurs projets locaux, une connexion au niveau utilisateur est pratique. Pour un dépôt partagé ou un environnement client sensible, relisez les règles de portée de configuration de Claude Code et la politique de votre équipe avant d’ajouter des intégrations externes.

Vous trouverez la commande MCP générale et les indications sur les transports dans la documentation de Claude Code d’Anthropic. Consultez-la si une option de la CLI change dans une version plus récente.

Étape 2 : s’authentifier dans Claude Code

Lancez Claude Code et saisissez :

/mcp

Sélectionnez le serveur gsc-magic. Si le client propose une action Authenticate, suivez-la et terminez la connexion dans le navigateur. Utilisez le compte Google qui dispose des bonnes autorisations sur la propriété Search Console.

N’envoyez jamais votre mot de passe Google, un code d’autorisation OAuth ou un jeton d’accès dans un message de conversation ordinaire. L’authentification est une étape distincte, gérée par le client et le serveur. Si votre navigateur s’ouvre mais que l’autorisation n’aboutit jamais, retournez dans le menu MCP et vérifiez l’état de la connexion avant de recommencer.

Certains environnements ne peuvent pas terminer une connexion OAuth dans un navigateur. GSC Magic documente alors des jetons d’accès personnels, sous Connect → Access tokens dans son tableau de bord. Une connexion par jeton passe par un en-tête, par exemple :

claude mcp add --transport http --scope user gsc-magic https://mcp.gscmagic.com/mcp \
  --header "Authorization: Bearer gsm_YOUR_TOKEN"

Ceci est un modèle, pas un identifiant fonctionnel. Remplacez la valeur fictive dans un processus de configuration locale sécurisé, et ne la versionnez pas dans Git. Si vous n’avez besoin que de rapports d’analyse et d’indexation, créez un jeton en lecture seule. La documentation de la plateforme explique l’expiration, la révocation et les autorisations des jetons.

Étape 3 : vérifier que la connexion fonctionne

Ne commencez pas par « audite tout mon site et corrige tout ». Demandez une réponse que vous pouvez vérifier.

Liste les propriétés Google Search Console auxquelles cette connexion donne accès. Indique les identifiants exacts des propriétés et leur niveau d’autorisation si disponible. N’analyse aucune propriété avant que je l’aie choisie.

Cela vérifie plusieurs choses à la fois : le client découvre bien les outils du serveur, le serveur sait s’authentifier auprès de Google et votre compte Google voit au moins une propriété.

Sélectionnez l’identifiant exact de la propriété dont vous avez besoin. Une propriété de la forme sc-domain:example.com peut inclure les sous-domaines. Une propriété de préfixe d’URL comme https://www.example.com/ couvre un ensemble d’URL plus restreint. Un décalage passé inaperçu peut fausser une comparaison de trafic alors que l’outil fonctionne parfaitement.

Si la liste est vide, vérifiez d’abord votre compte Google et vos droits sur la propriété. Ne supposez pas que le serveur est en panne.

Étape 4 : lancer une première comparaison SEO utile

Une bonne première tâche est ciblée, mesurable et facile à répéter :

Pour la propriété Search Console sélectionnée, compare les 28 derniers jours complets de données aux 28 jours précédents. Indique les plages de dates exactes, le total des clics, des impressions et le CTR, puis liste les dix pages qui ont perdu le plus de clics en valeur absolue. Utilise les données de Search Console, pas des estimations. Présente les explications possibles comme des hypothèses.

Vous pouvez recouper ce rapport dans l’interface Performances de Search Console. Si les totaux diffèrent, vérifiez les choix d’agrégation, les fuseaux horaires, les types de recherche et si les données sont définitives. Google compte les clics et les impressions selon ses propres définitions, pas selon les règles de session de GA4.

Demandez ensuite à Claude Code d’approfondir une page :

Pour l’URL qui a perdu le plus de clics, compare ses dix principales requêtes entre les deux périodes. Regroupe les changements importants par appareil et par pays. Dis-moi quelles observations justifient d’examiner le template de la page et lesquelles ne le justifient pas.

C’est là qu’un assistant de code devient utile. Si la page a perdu en visibilité sur mobile, vous pouvez examiner la navigation mobile, la mise en page responsive et le rendu. Si elle a perdu des impressions sur un petit groupe de requêtes, vous pouvez étudier son contenu et son maillage interne. Mais ne laissez pas le modèle prendre une corrélation pour une preuve.

Étape 5 : relier les données au code de votre site

Supposons que Search Console identifie une URL produit importante dont le taux de clics baisse. Demandez à Claude Code de trouver la route ou le template qui produit le title, la description et les titres de la page.

Voici une séquence raisonnable :

1. Repérez la page ou le template dans votre projet.
2. Inspectez le title, l’URL canonique, la structure des titres et le contenu principal actuels.
3. Lisez les requêtes qui ont généré des impressions pour la page.
4. Proposez une amélioration limitée, cohérente avec le contenu réel de la page.
5. Affichez un diff avant toute modification.
6. Lancez vos build et tests habituels.
7. Notez la date de mise en production pour pouvoir comparer ensuite.

Toutes les pages à faible CTR n’ont pas besoin d’un nouveau title. Une page peut se classer sur des requêtes informationnelles larges qui génèrent peu de clics, ou sa position moyenne a pu changer. Appuyez-vous sur le guide d’analyse du faible CTR avant de réécrire des métadonnées à partir d’un seul chiffre.

Ne demandez jamais à Claude Code de supprimer ou de rediriger des pages simplement parce que deux URL partagent une requête. Cela peut faire plus de dégâts que le problème de départ.

Construire un workflow hebdomadaire reproductible

Vous pouvez conserver le prompt d’analyse dans vos notes ou dans le runbook interne de votre projet. Claude Code n’a pas besoin de se souvenir de la conversation précédente si le prompt précise les paramètres du rapport.

Demandez chaque fois les mêmes fenêtres complètes de 7 ou 28 jours, en indiquant la propriété sélectionnée. Faites renvoyer à l’assistant un tableau avec l’URL, les clics de chaque période, la variation absolue, la variation relative et la requête qui contribue le plus à l’écart. Gardez la première version en lecture seule.

Après le rapport, demandez un plan d’action limité à trois éléments. Une bonne action comprend un signal observé, une vérification proposée, un responsable et un moyen de mesurer le résultat.

Par exemple : « La page de documentation a perdu 120 clics, surtout sur des requêtes d’installation sur ordinateur. Vérifier si la page répond encore à la version actuelle des instructions d’intégration ; ne la mettre à jour que si le contenu est obsolète. » C’est bien plus exploitable que « Améliorer la qualité du contenu ».

Si vous programmez des scripts ou des agents, maîtrisez les appels répétés et respectez les quotas de l’API Search Console. Un reporting hebdomadaire ne devrait pas nécessiter des centaines de requêtes en double.

Dépannage des problèmes courants

Si l’assistant signale une erreur d’outil, lisez l’erreur elle-même avant d’essayer un autre prompt. Reformuler une requête ne résoudra ni un jeton révoqué ni un site auquel votre compte n’a pas accès.

La référence de l’API Search Analytics de Google documente les bornes de dates, les dimensions, les limites et l’agrégation. Comprendre ces limites évite un nombre étonnant de faux diagnostics SEO.

Autorisations et sécurité quand le code rencontre les données de recherche

Relier les données Search Console à un assistant de code est puissant parce que l’assistant peut aussi avoir accès au système de fichiers. C’est précisément pour cela qu’il faut séparer l’enquête de la mise en œuvre.

Considérez les outils de reporting comme étant en lecture seule dès que possible. Demandez des diffs de code proposés et relisez-les avant que l’assistant n’écrive ou ne déploie quoi que ce soit. Utilisez votre workflow Git et vos contrôles habituels. Si vous travaillez avec des propriétés de clients, évitez de mélanger dans un même rapport les données de clients qui n’ont rien à voir entre eux.

GSC Magic documente des jetons en lecture seule et des contrôles de mode écriture distincts. Ses outils Google Search Console permettent de lire les analyses et le statut des URL indexées, tandis que les actions d’administration, comme l’envoi d’un sitemap, exigent une autorisation plus forte. Cette séparation compte davantage que le nombre d’outils que liste le connecteur.

Rappelez-vous que l’API d’inspection d’URL de Google ne demande pas d’indexation. Ses résultats sur la version indexée diffèrent d’un test d’URL en direct. L’Indexing API de Google, distincte, ne prend en charge que des types de contenu restreints et ne doit pas servir de raccourci pour des pages ordinaires.

Questions fréquentes

Claude Code peut-il accéder directement à Google Search Console, sans MCP ?

Pas par défaut. Il faudrait un autre chemin autorisé, comme un script d’API sur mesure ou un export importé. Le MCP est un moyen standard d’exposer ces appels sous forme d’outils que Claude Code peut utiliser.

Est-ce la même installation que Claude sur le web ?

Non. Claude Code utilise une configuration MCP gérée par la CLI. L’application web de Claude a sa propre interface de connecteurs. La source de données peut être la même, mais les étapes de connexion diffèrent.

Claude Code peut-il corriger automatiquement les problèmes de SEO technique ?

Il peut aider à modifier les fichiers auxquels il a le droit d’accéder, mais les données de Search Console ne prouvent pas que chaque modification suggérée soit juste. Relisez les diffs, testez les builds et exigez une validation humaine avant le déploiement.

L’agent connaîtra-t-il mes conversions Google ?

Seulement si vous autorisez une source d’analyse appropriée. Search Console rapporte les clics et les impressions de la recherche ; GA4 est nécessaire pour les sessions et les événements clés.

Quelle tâche essayer en premier ?

Commencez par comparer deux périodes complètes de 28 jours et les dix pages qui ont perdu le plus de clics. Vous pouvez vérifier ces chiffres avant d’engager la moindre modification de code.

Ce qu’il faut retenir

Claude Code s’utilise au mieux comme un pont entre le comportement de recherche mesuré et le site que vous pouvez réellement améliorer. Utilisez le connecteur pour repérer un problème, le code source pour l’étudier et votre processus de relecture habituel pour apporter les changements en toute sécurité.

Pour connaître les outils, les types de jetons et les options de connexion actuellement documentés, gardez la documentation de GSC Magic ouverte pendant que vous configurez votre client. Pour d’autres idées d’analyse, consultez nos 25 prompts pour agents SEO.