Google Search Console MCP : guide et tutoriel

Publié le · Automatisation & navigateur · 6 min de lecture

Bannière mcp-server-gsc

GitHub stars
Licence
Langage principal

Analyser ses données de référencement naturel prend du temps : ouvrir Google Search Console, filtrer les requêtes, exporter les tableaux, croiser les périodes. Le mcp-server-gsc MCP Server change la donne en connectant directement vos données Search Console à votre assistant IA. Cet article vous guide à travers les fonctionnalités, l’installation et l’utilisation pratique de cet outil, pour transformer vos analyses SEO en simples conversations en langage naturel.

Introduction

Google Search Console (GSC) est l’outil de référence pour suivre la performance d’un site dans les résultats de recherche Google : requêtes, clics, impressions, taux de clic (CTR) et position moyenne. Mais l’interface, aussi complète soit-elle, montre vite ses limites dès qu’on veut croiser des données ou analyser de gros volumes. Le projet mcp-server-gsc, développé par ahonn et hébergé sur GitHub, apporte une réponse élégante : un MCP server écrit en TypeScript qui expose vos données GSC via le Model Context Protocol (MCP). Votre assistant IA, comme Claude Desktop, peut alors interroger directement Search Console et répondre à vos questions SEO en langage naturel. Cet article vous propose un MCP guide complet pour maîtriser cet outil.

🎯 Qu’est-ce que mcp-server-gsc ?

mcp-server-gsc est un MCP server (Model Context Protocol Server) qui fait le pont entre l’API Google Search Console et vos agents IA. Concrètement, il traduit les requêtes de votre assistant en appels vers l’API GSC, puis renvoie les résultats dans un format que l’IA peut interpréter et commenter.

Le MCP protocol est au cœur de ce fonctionnement : il définit une structure standardisée pour l’échange d’informations entre l’agent et la source de données. Vous n’avez plus besoin d’écrire du code ou de manipuler l’API vous-même : vous posez une question, l’assistant appelle le bon outil GSC, récupère les données et vous les présente. L’authentification se fait via un compte de service Google, garantissant un accès sécurisé et en lecture seule à vos propriétés Search Console.

Schéma : Assistant IA → MCP Server (gsc) → API Google Search Console → Vos données SEO

⚙️ Fonctionnalités principales

mcp-server-gsc offre un ensemble de fonctionnalités pensées pour l’analyse SEO avancée. Voici les principales :

  • Données de performance enrichies : récupérez jusqu’à 25 000 lignes de données de recherche en un seul appel, bien au-delà de ce que permet l’export manuel de l’interface.

  • Dimensions multiples : croisez les requêtes, les pages, les pays, les appareils et les dates pour des analyses fines de votre trafic organique.

  • Filtrage avancé : filtrez vos données avec des opérateurs puissants (equals, contains, notEquals, notContains, includingRegex, excludingRegex), y compris par expressions régulières.

  • Filtre par appareil : segmentez vos performances entre mobile, ordinateur et tablette.

  • Détection de « Quick Wins » : identifiez automatiquement les opportunités rapides, c’est-à-dire les pages positionnées juste hors du top 3 (positions 4 à 15) avec un fort potentiel de gain de clics.

  • Inspection d’URL : vérifiez l’état d’indexation d’une URL précise directement depuis votre assistant.

  • Gestion des sitemaps : listez, soumettez et inspectez vos sitemaps.

  • Écrit en TypeScript : code robuste, typé et facile à maintenir, installable en une commande via npx.

📦 Installation et configuration

L’installation de mcp-server-gsc se fait en quelques étapes. Voici la marche à suivre :

  1. Prérequis : Node.js version 18 ou supérieure, ainsi que npx disponible sur votre système.

  2. Créer un compte de service Google : dans la console Google Cloud, créez un projet, activez l’API Search Console, puis créez un compte de service et téléchargez sa clé au format JSON.

  3. Autoriser le compte de service : dans Google Search Console, ajoutez l’adresse e-mail du compte de service comme utilisateur de votre propriété (Paramètres > Utilisateurs et autorisations).

  4. Configurer votre client MCP : ajoutez la configuration suivante à votre fichier claude_desktop_config.json :

    {
  "mcpServers": {
    "gsc": {
      "command": "npx",
      "args": ["-y", "mcp-server-gsc"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/chemin/vers/credentials.json"
      }
    }
  }
}

  5. Redémarrer votre assistant : relancez Claude Desktop. Le serveur gsc sera automatiquement téléchargé et démarré via npx.

💡 Guide d’utilisation pratique

Une fois configuré, vous pouvez interroger vos données SEO en langage naturel. Voici des exemples de ce que l’outil traite en coulisses :

  1. Analyser les performances de recherche :

    {
  "siteUrl": "https://exemple.com",
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "dimensions": "query,page",
  "rowLimit": 5000
}

    Récupère les 5 000 principales combinaisons requête/page pour janvier 2024.

  2. Filtrer par thématique et par appareil :

    {
  "siteUrl": "https://exemple.com",
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "dimensions": "page,query",
  "queryFilter": "regex:(IA|machine learning|ML)",
  "filterOperator": "includingRegex",
  "deviceFilter": "MOBILE",
  "rowLimit": 10000
}

    Isole les requêtes liées à l’IA sur mobile uniquement.

  3. Détecter les opportunités rapides (Quick Wins) :

    {
  "siteUrl": "https://exemple.com",
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "dimensions": "query,page",
  "detectQuickWins": true,
  "quickWinsConfig": {
    "positionRange": [4, 15],
    "minImpressions": 500,
    "minCtr": 2
  }
}

    Fait remonter les pages en position 4 à 15, avec au moins 500 impressions, prêtes à grimper dans le top 3 avec quelques optimisations.

En pratique, vous n’écrivez pas ce JSON : vous demandez simplement à votre assistant « Quelles sont mes opportunités SEO rapides ce mois-ci ? » et il construit la requête pour vous.

🚀 Cas d’usage et exemples

mcp-server-gsc s’avère utile dans de nombreuses situations :

  • Audit SEO conversationnel : demandez à votre IA d’analyser la baisse de trafic d’une page et d’en identifier les causes probables.
  • Reporting automatisé : générez des synthèses mensuelles de performance sans exporter manuellement les données.
  • Détection d’opportunités : repérez les requêtes à fort potentiel où un léger gain de position ferait décoller le trafic.
  • Suivi de l’indexation : vérifiez rapidement si une nouvelle page est bien indexée par Google.
  • Analyse de cannibalisation : croisez requêtes et pages pour repérer les contenus qui se concurrencent entre eux.

Un exemple concret : après la publication d’un article, vous demandez à votre assistant de surveiller son positionnement chaque semaine et de vous alerter dès qu’il entre en page 1. Le tout sans quitter votre conversation.

⚖️ Avantages et inconvénients

Avantages Inconvénients
Analyse SEO en langage naturel, sans code Nécessite la configuration d’un compte de service Google Cloud
Jusqu’à 25 000 lignes par requête Accès en lecture seule aux données de recherche
Détection automatique des Quick Wins Dépend de la disponibilité de l’API Google Search Console
Installation simple via npx Réservé aux propriétés déjà vérifiées dans GSC

❓ FAQ

  • Q : Qu’est-ce que le Model Context Protocol (MCP) ?

    • R : Le MCP est un protocole standardisé qui permet à un assistant IA d’accéder à des sources de données externes, ici Google Search Console, de façon structurée et sécurisée.

  • Q : Mes données Search Console sont-elles en sécurité ?

    • R : Oui. Le serveur utilise un compte de service Google avec un accès en lecture seule. Vos identifiants restent locaux et ne transitent que vers l’API officielle de Google.

  • Q : Faut-il savoir coder pour l’utiliser ?

    • R : Non. Une fois la configuration initiale effectuée, toute l’analyse se fait en langage naturel via votre assistant IA.

  • Q : Avec quels assistants est-il compatible ?

    • R : Avec tout client compatible MCP, notamment Claude Desktop, Cursor et les autres clients de l’écosystème MCP.

🎊 Conclusion et recommandations

mcp-server-gsc est un outil précieux pour tous ceux qui veulent exploiter leurs données de référencement sans friction. En connectant Google Search Console à votre assistant IA, il transforme des analyses fastidieuses en simples conversations, tout en offrant des fonctionnalités avancées comme la détection de Quick Wins et le filtrage par expressions régulières. Si vous gérez le SEO d’un ou plusieurs sites, cet outil mérite une place dans votre boîte à outils.

Essayez mcp-server-gsc dès aujourd’hui et transformez votre workflow SEO ! Visitez le repository GitHub pour plus d’informations et pour commencer.

Recevez gratuitement le guide complet du MCP

Une newsletter simple, sans spam. Désinscription en un clic.