Orkas Orkas
Accueil Blog Google Search Console MCP
Produit

Google Search Console MCP : trois façons de le mettre en place, et un premier audit

Google ne fournit pas de serveur MCP pour Search Console : il faut donc choisir entre un serveur communautaire, un serveur hébergé ou une application avec un connecteur intégré. Voici ce que demande chaque option, ce que l'API laisse de côté, et un premier audit que vous pouvez vérifier vous-même.

Un serveur MCP Google Search Console donne à un agent IA comme Claude, Claude Code, Codex ou Cursor un accès à l'API Search Console. L'agent peut récupérer vos clics, vos impressions, votre CTR (taux de clics) et votre position moyenne, vérifier si une page est indexée et lister vos sitemaps. Vous posez votre question avec vos propres mots, par exemple « quelles pages se classent en première page sans obtenir de clics ? », et l'agent lance les requêtes puis passe les lignes en revue. Ce guide compare les trois façons d'en mettre un en place, explique ce que l'API laisse de côté et détaille un premier audit que vous pouvez vérifier vous-même dans Search Console.

En bref : au 9 novembre 2026, Google ne propose aucun serveur MCP officiel pour Search Console. Google en publie un pour Google Analytics, et ni l'annuaire de Claude ni celui de ChatGPT ne contiennent de connecteur Search Console signé Google, Anthropic ou OpenAI. Vous avez le choix entre un serveur communautaire gratuit que vous faites tourner vous-même et qui nécessite un projet Google Cloud ; un serveur hébergé auquel vous vous connectez avec Google ; ou une application avec un connecteur intégré, comme Orkas, où il suffit de cliquer sur Connecter. Les trois lisent la même API, et celle-ci ne liste pas toutes les requêtes : Google omet les requêtes anonymisées, qui représentaient 46,77 % du trafic dans une étude d'Ahrefs portant sur 887 534 propriétés Search Console.

Ce qu'un MCP Search Console peut faire, et ce qu'il ne peut pas faire

Tous les serveurs MCP Search Console, communautaires ou commerciaux, appellent la même API Search Console gratuite. Leurs possibilités dépendent donc de cette API, résumée ci-dessous d'après la référence de l'API et les limites d'utilisation publiées par Google.

Ce que vous demandezAPILimites
Clics, impressions, CTR et position par requête, page, pays, appareil, date ou apparence dans les résultats de rechercheSearch Analytics16 mois d'historique, avec environ 2 à 3 jours de décalage ; jusqu'à 25 000 lignes par demande et 50 000 lignes par jour et par type de recherche
Si une URL est indexée, sa dernière exploration et l'URL canonique choisie par GoogleURL InspectionUne URL par appel ; 2 000 appels par jour et par propriété
Vos sitemaps et leurs erreursSitemapsLa lecture demande un accès en lecture seule ; l'envoi ou la suppression, un accès complet
Les propriétés auxquelles vous avez accèsSitesAjouter ou retirer une propriété demande un accès complet

Certaines données de Search Console n'ont pas d'API, et aucun serveur MCP ne peut donc les récupérer :

  • Les données des Aperçus IA et du Mode IA. Google a étendu le rapport sur les performances de l'IA générative à tous les sites le 31 août 2026, mais la référence de l'API ne mentionne aucun type de recherche ni aucune apparence qui lui corresponde.
  • Les options de rapport les plus récentes. Le type de recherche multimodal et le filtre des requêtes de marque sont eux aussi absents de la référence de l'API.
  • Tester une page en ligne. L'inspection d'URL renvoie la version présente dans l'index de Google. La documentation de l'API est claire : « vous ne pouvez pas tester l'indexabilité d'une URL active ».
  • Le bouton « Request indexing » (Demander une indexation). Il n'existe que dans Search Console. L'API Indexing de Google, une API distincte que certains serveurs appellent, est officiellement réservée aux pages d'offres d'emploi et de diffusions en direct.

Trois façons de connecter Search Console à Claude, Claude Code ou Codex

OptionMise en placePar où passent vos donnéesCoût
Serveur communautaire que vous exécutez, comme mcp-gscProjet Google Cloud, API, identifiants et une entrée de configurationDe votre ordinateur à GoogleGratuit
Serveur hébergé, comme mcpsearchconsole.comConnexion avec Google, puis URL du serveur à coller dans votre application d'IAPar les serveurs du fournisseurOffre gratuite, puis abonnement
Connecteur intégré à OrkasCliquer sur Connecter, puis se connecter avec GoogleDe votre ordinateur à GoogleConnecteur gratuit
  • Les serveurs communautaires sont gratuits et les plus complets. Le plus populaire, AminForou/mcp-gsc, comptait 2 151 étoiles sur GitHub le 9 novembre 2026. Son code comprend 21 outils, dont la comparaison de périodes, l'inspection par lots de 10 URL au maximum et, si vous l'autorisez, l'envoi de sitemaps. Le prix à payer, c'est la mise en place : vous créez vos propres identifiants Google. Sur r/TechSEO, un commentateur a qualifié Google Cloud de « seule friction ».
  • Les serveurs hébergés sont le moyen le plus rapide de l'utiliser dans claude.ai ou ChatGPT sur le Web. Ce sont des serveurs distants, que l'on ajoute donc par URL. Le centre d'aide de Claude indique que les connecteurs personnalisés fonctionnent avec toutes les offres, mais que « les utilisateurs de l'offre gratuite sont limités à un seul connecteur personnalisé ». mcpsearchconsole.com affiche une offre gratuite de 40 extractions de données par mois sur trois propriétés, puis 4,99 € HT par mois. Vos données Search Console transitent par le fournisseur : lisez donc d'abord ses conditions de confidentialité.
  • Un connecteur intégré vous évite la configuration de Google Cloud. Dans Orkas, vous vous connectez avec Google et le connecteur s'exécute sur votre ordinateur. Il est en lecture seule et dispose de quatre outils, moins que les serveurs communautaires.

Faire tourner vous-même un serveur communautaire

Ces étapes suivent le README de mcp-gsc dans sa version 0.4.2 (6 novembre 2026). Nous n'avons pas créé de projet Google Cloud pour ce guide : vérifiez donc le README avant de commencer.

  1. Créez des identifiants Google. Dans la console Google Cloud, créez un projet, activez l'API Search Console, puis créez un ID client OAuth de type Desktop app. Téléchargez son fichier JSON. Pour de l'automatisation, créez plutôt un compte de service, puis ajoutez son adresse e-mail dans Search Console, dans la section Utilisateurs et autorisations des Paramètres, avec un accès complet.
  2. Installez uv. La méthode recommandée par le README lance le serveur avec uvx, qui gère Python à votre place. Sans lui, il vous faut Python 3.11 ou une version ultérieure.
  3. Ajoutez le serveur à votre agent. Dans Claude Code :
    claude mcp add --env GSC_OAUTH_CLIENT_SECRETS_FILE=/path/to/client_secrets.json --transport stdio gsc -- uvx mcp-search-console
    Dans Codex :
    codex mcp add gsc --env GSC_OAUTH_CLIENT_SECRETS_FILE=/path/to/client_secrets.json -- uvx mcp-search-console
    Nous avons vérifié les deux commandes avec Claude Code 2.1.311 et Codex CLI 0.163.0. Pour Claude Desktop ou Cursor, le README fournit une configuration JSON avec le chemin complet vers uvx, car les applications ouvertes depuis le Dock ou le menu Démarrer risquent sinon de ne pas le trouver.
  4. Connectez-vous une fois. À la première utilisation, une fenêtre de navigateur s'ouvre pour la connexion à Google. Depuis la version 0.4.2, le serveur ne demande qu'un accès en lecture seule, sauf si vous définissez GSC_ALLOW_DESTRUCTIVE=true.

Un point que les guides de la communauté ne mentionnent pas : si votre écran de consentement OAuth est configuré en External et laissé en Testing, la documentation OAuth de Google indique que le jeton d'actualisation expire au bout de 7 jours. Vous devriez alors vous reconnecter chaque semaine. Pour l'éviter, publiez l'application en production ou utilisez un compte de service. Une application publiée peut afficher l'avertissement « application non validée », que Google permet d'ignorer pour les applications à usage personnel comptant moins de 100 utilisateurs.

Connecter Search Console dans Orkas

Orkas est une application de bureau pour macOS et Windows dans laquelle plusieurs agents IA travaillent dans un même chat. Son connecteur Google Search Console est intégré : vous n'avez donc pas besoin de projet Google Cloud.

  1. Installez Orkas et connectez-vous. Téléchargez-le pour macOS ou Windows. Les nouveaux comptes reçoivent 500 crédits gratuits pour les modèles intégrés d'Orkas : pas besoin de clé API pour commencer.
  2. Ouvrez Connecteurs. Cliquez sur Connecteurs dans la barre latérale et cherchez Google Search Console. Le filtre Données ou le champ de recherche vous y mènent.
  3. Cliquez sur Connecter et connectez-vous avec Google. Cliquez sur Connecter, utilisez le compte Google qui a accès à votre propriété et autorisez l'accès en lecture seule. La carte passe dans la rubrique Connecté.
  4. Demandez ce dont vous avez besoin. Dans un chat, tapez @ et choisissez le connecteur Google Search Console, ou décrivez simplement la tâche. L'agent liste d'abord vos propriétés, puis interroge celle que vous indiquez.
  • Il est en lecture seule. Orkas ne demande à Google que le champ d'application webmasters.readonly. Les quatre outils listent vos propriétés, interrogent les données de performances, listent les sitemaps et inspectent une URL. Comme ils se contentent de lire, Orkas les exécute sans vous demander d'approuver chaque appel. Ils ne peuvent ni envoyer de sitemaps ni demander une indexation, et une requête renvoie au maximum 25 000 lignes.
  • Les requêtes vont directement à Google. Le connecteur s'exécute sur votre ordinateur et appelle directement l'API Search Console. Seules la connexion à Google et l'actualisation du jeton passent par le serveur d'Orkas, qui détient les identifiants Google de l'application.
  • SeoGeoAgent et vos agents de code peuvent l'utiliser. SeoGeoAgent, l'agent SEO intégré à Orkas, s'appuie sur vos clics, impressions et positions réels dans ses audits dès que Search Console est connecté. Si vous avez installé Claude Code, Codex, OpenCode, Hermes ou OpenClaw et que vous l'avez connecté dans Orkas, il accède au connecteur via la passerelle d'outils d'Orkas, sans configuration MCP de son côté.
  • Besoin d'un accès en écriture ? Utilisez Ajouter un serveur MCP sur la page Connecteurs pour ajouter un serveur communautaire sous forme de commande locale. Orkas propose aussi un connecteur Bing Webmaster Tools.

Un premier audit que vous pouvez vérifier

Une bonne première demande porte sur des chiffres que vous pouvez comparer avec Search Console en une minute, et oblige l'agent à dire ce que les données ne couvrent pas. Remplacez la propriété et les deux URL par les vôtres :

Utilisez le connecteur Google Search Console pour sc-domain:example.com. Sur les 28 derniers jours de données complètes : 1) le total des clics et des impressions par date, et la part de ce total couverte par les lignes de requêtes ; 2) les pages classées entre les positions 5 et 15 avec au moins 100 impressions et un CTR inférieur à 2%, triées par impressions ; 3) l'état d'indexation de https://example.com/new-page/ et https://example.com/old-page/. Indiquez la période sur chaque tableau et n'estimez rien que les données ne montrent pas.

Nous avons lancé cette demande avec Claude Code dans Orkas le 9 novembre 2026, et les quatre outils du connecteur ont fonctionné. Comme nous ne publions pas les chiffres Search Console de notre propre site, les résultats ci-dessous sont un exemple synthétique : des chiffres inventés pour une boutique fictive sur example.com, qui montrent à quoi ressemble une réponse rigoureuse et comment en vérifier chaque partie.

  • Totaux par date (données synthétiques) : 3 480 clics et 151 200 impressions. Ce sont les chiffres auxquels se fier pour l'ensemble du site. Pour vérifier les vôtres, ouvrez le rapport sur les performances, choisissez les mêmes dates personnalisées et le même type de recherche, puis comparez les totaux. Ils devraient être très proches. Un gros écart signifie généralement que l'agent a plutôt additionné des lignes de requêtes ou de pages.
  • Lignes de requêtes (données synthétiques) : 642 lignes couvrant 1 670 clics, soit 48 % du total. Le reste provient de requêtes que Google anonymise et qui n'ont de ligne ni dans le rapport ni dans l'API. Une telle proportion est normale : Ahrefs a constaté que les requêtes anonymisées représentaient 46,77 % du trafic en avril 2025, et davantage sur de nombreux sites. Un agent qui additionne les lignes de requêtes et présente le résultat comme votre trafic peut se tromper de moitié.
  • Pages à faible CTR (données synthétiques) : 9 pages classées entre les positions 5 et 15 avec au moins 100 impressions et un CTR inférieur à 2 %. Celle qui en a obtenu le plus, /blog/linen-care/, a totalisé 2 140 impressions pour une position moyenne de 6,8 et 21 clics, soit un CTR de 1,0 %. Ce sont les premiers titres et descriptions à revoir. Si votre site propose ses versions linguistiques à des adresses se terminant par ?lang=, chaque version a sa propre ligne de page : demandez-les donc regroupées.
  • Inspection d'URL (données synthétiques) : l'ancienne page est indexée, la nouvelle pas encore. https://example.com/old-page/, publiée en septembre, était « Submitted and indexed », avec une dernière exploration le 3 octobre. https://example.com/new-page/, publiée deux jours avant la vérification, était « Discovered - currently not indexed ». Pour vérifier, collez la même URL dans la barre d'inspection en haut de Search Console.

Cinq pièges courants

  • Prendre les lignes de requêtes pour le trafic total. Le guide de Google sur les données de performances explique que les requêtes anonymisées n'ont pas de ligne : « si vous additionnez les clics de toutes les lignes, vous n'obtiendrez pas le même nombre de clics que dans les totaux du graphique ». Pour les totaux, demandez les données par date, sans filtre de requête.
  • Comparer les totaux par page aux totaux du site. Quand on regroupe par page, chaque URL qui apparaît dans un résultat est comptée séparément. Quand on regroupe par propriété, un résultat ne compte qu'une fois pour l'ensemble du site. Les lignes de pages peuvent donc cumuler plus d'impressions que le total du site.
  • Oublier le délai. Les données sont « généralement disponibles au bout de 2 à 3 jours ». L'API renvoie des données finalisées, sauf si on lui demande des données récentes : « les 7 derniers jours » s'arrêtent donc quelques jours avant aujourd'hui.
  • Se tromper de nom de propriété. Une propriété de domaine s'écrit sc-domain:example.com. Une propriété avec préfixe d'URL correspond à l'adresse complète avec la barre oblique finale, comme https://example.com/. Laissez l'agent lister d'abord vos propriétés et copiez le nom qu'il renvoie.
  • En demander trop d'un coup. Chaque demande renvoie au maximum 25 000 lignes, et une ventilation par requête et par page sur 16 mois atteint vite cette limite. Demandez des synthèses, un filtre ou une période plus courte, et laissez l'agent parcourir les lignes plutôt que de les coller toutes dans le chat.

Quelle option choisir ?

Votre situationÀ choisir
Vous utilisez claude.ai ou ChatGPT dans le navigateurUn serveur hébergé, ajouté par URL
Vous voulez tous les outils, y compris l'envoi de sitemaps, et Google Cloud ne vous dérange pasUn serveur communautaire comme mcp-gsc
Vous voulez que Claude Code, Codex et un agent SEO lisent Search Console sans Google CloudLe connecteur intégré d'Orkas
Votre site est trop gros pour 25 000 lignes par demandeL'exportation groupée des données Search Console vers BigQuery, hors MCP

Questions fréquentes

Google propose-t-il un serveur MCP Search Console officiel ?

Non, pas au 9 novembre 2026. Search Console ne figure ni dans la liste des serveurs MCP officiels de Google, ni dans la liste MCP de Google Cloud. Google publie un serveur MCP pour Google Analytics, qui n'inclut pas les données Search Console.

Un MCP Search Console est-il gratuit ?

L'API Search Console est gratuite, tout comme les serveurs communautaires tels que mcp-gsc et le connecteur d'Orkas. Les serveurs hébergés ont généralement une offre gratuite avec une limite mensuelle et une offre payante. L'agent IA que vous connectez a toutefois son propre coût, par exemple un abonnement Claude ou des crédits Orkas.

Un serveur MCP peut-il envoyer des sitemaps ou demander une indexation ?

Il peut envoyer ou supprimer des sitemaps s'il dispose d'un accès complet à Search Console, ce que proposent certains serveurs communautaires. L'API Search Console n'a pas de fonction Request indexing : aucun serveur ne peut donc le faire pour des pages ordinaires. Le connecteur d'Orkas est en lecture seule et ne fait ni l'un ni l'autre.

Pourquoi les chiffres du MCP ne correspondent-ils pas à Search Console ?

Généralement parce que l'agent a additionné les lignes de requêtes, qui excluent les requêtes anonymisées, ou a mélangé des totaux par page et des totaux par propriété. Demandez les totaux par date sans filtre de requête, avec les mêmes dates et le même type de recherche que le rapport. Les totaux devraient alors être très proches.

Est-ce que ça fonctionne avec Claude Code et Codex ?

Oui. Ajoutez un serveur communautaire avec claude mcp add ou codex mcp add, ou un serveur hébergé par URL. Dans Orkas, Claude Code et Codex utilisent le connecteur Search Console intégré via la passerelle d'outils d'Orkas, sans aucune configuration dans l'un ou l'autre outil.

Qu'est-ce que l'Agentic SEO ? donne une vue d'ensemble : un agent mène le travail SEO à partir de données réelles, et une personne valide ce qui est mis en ligne.

Claude SEO skill →

Search Console dans le chat de votre agent Connectez Search Console une seule fois et laissez Claude Code, Codex ou SeoGeoAgent le consulter. Orkas est gratuit sur macOS et Windows. Les nouveaux comptes reçoivent 500 crédits pour le modèle Orkas intégré.
Télécharger Orkas — gratuit