MCP GSC pour Codex

Google Search Console dans OpenAI Codex

Codex lit déjà votre code. Donnez-lui aussi vos données de recherche. Le serveur MCP de GSC Wizard est un point de terminaison Model Context Protocol hébergé qui fournit à Codex vos données Search Console, Bing Webmaster et GA4 : l'agent qui modifie vos templates peut ainsi voir quelles pages perdent des clics, sur quelles requêtes une page se positionne et si une URL est indexée.

Une seule commande, sans serveur local ni projet Google Cloud. Cela fonctionne dans le CLI Codex, l'extension d'IDE et l'app desktop, qui lisent tous le même fichier ~/.codex/config.toml.

codex mcp add gsc-wizard --url https://mcp.gscwizard.com/mcp
codex mcp login gsc-wizard
Point de terminaison
https://mcp.gscwizard.com/mcp
Transport
Streamable HTTP
Authentification
OAuth (codex mcp login) or Bearer key
Outils
112 · GSC, Bing, GA4

Essai gratuit, sans carte bancaire. L'accès au MCP est inclus dans toutes les formules.

01

Pourquoi Search Console a sa place dans Codex

La plupart des corrections SEO finissent en modification de code : un template de title, une balise canonical, une table de redirections, un générateur de sitemap, un bloc de liens internes. Avec un assistant de chat, vous analysez les données, puis vous copiez la conclusion dans votre éditeur. Dans Codex, l'analyse et la modification se font dans la même session, sur le même dépôt.

Les données à côté du diff

Codex peut consulter les requêtes pour lesquelles une page obtient des clics avant de réécrire son title, au lieu de deviner les mots-clés.

L'analyse s'exécute côté serveur

Le déclin, la cannibalisation, les courbes de CTR et la notation des opportunités sont calculés par le serveur. Codex reçoit des conclusions et les lignes qui les étayent, pas un export brut sur lequel faire des calculs.

Plus d'historique que l'API

La plupart des lectures proviennent de l'entrepôt GSC Wizard qui stocke vos données, lequel remonte au-delà de la fenêtre de 16 mois de Google et évite l'échantillonnage de lignes de l'API.

02

Configuration en trois étapes

  1. 1

    Connectez vos propriétés

    Créez un compte GSC Wizard, connectez-vous avec Google et choisissez les propriétés Search Console que Codex doit voir. Codex ne peut lire que les propriétés connectées ici.

  2. 2

    Ajoutez le serveur à Codex

    Depuis n'importe quel terminal :

    codex mcp add gsc-wizard --url https://mcp.gscwizard.com/mcp

    Cela écrit une table [mcp_servers.gsc-wizard] dans ~/.codex/config.toml. Vous pouvez aussi écrire le bloc à la main.

  3. 3

    Connectez-vous et vérifiez

    Lancez la connexion OAuth, qui ouvre votre navigateur sur l'écran de consentement de GSC Wizard. Démarrez ensuite Codex et tapez /mcp pour vérifier que les outils sont bien listés.

    codex mcp login gsc-wizard
    codex
    > /mcp
    > List my Search Console sites and show clicks for the last 28 days.
03

Le bloc config.toml

Si vous gardez votre configuration Codex dans un dépôt de dotfiles, ou si vous voulez limiter ce que l'agent peut atteindre, modifiez directement ~/.codex/config.toml.

Minimal (OAuth)

[mcp_servers.gsc-wizard]
url = "https://mcp.gscwizard.com/mcp"

Clé API depuis une variable d'environnement

bearer_token_env_var désigne la variable ; Codex envoie sa valeur sous la forme Authorization: Bearer. La clé elle-même n'est jamais écrite dans le fichier de configuration.

[mcp_servers.gsc-wizard]
url = "https://mcp.gscwizard.com/mcp"
bearer_token_env_var = "GSCW_API_KEY"
export GSCW_API_KEY="gscw_live_..."

Ciblé : uniquement les outils dont une tâche a besoin

Chaque définition d'outil consomme du contexte à chaque tour. Pour un agent de code qui n'a besoin que de vérifier les performances et l'indexation, une liste d'autorisation garde la session légère et limite ce qu'une injection de prompt présente dans le contenu récupéré pourrait atteindre.

[mcp_servers.gsc-wizard]
url = "https://mcp.gscwizard.com/mcp"
bearer_token_env_var = "GSCW_API_KEY"
enabled_tools = [
  "list_sites",
  "get_site_summary",
  "query_top_pages",
  "get_page_performance",
  "get_query_performance",
  "find_decaying_content",
  "analyze_cannibalization",
  "inspect_url",
  "list_sitemaps"
]
tool_timeout_sec = 120

Les outils d'analyse sur de longues plages de dates peuvent prendre plus de temps qu'une simple consultation : une valeur généreuse pour tool_timeout_sec évite que Codex abandonne un appel auquel le serveur est encore en train de répondre. Définissez enabled = false pour désactiver le serveur sans supprimer le bloc.

04

OAuth ou clé API

OAuth via codex mcp login

Idéal pour le travail interactif sur votre propre machine. Codex découvre le serveur d'autorisation, s'enregistre et ouvre une connexion dans le navigateur. Aucune clé à copier, à stocker ou à renouveler. L'autorisation couvre les outils de lecture et d'écriture, et vous pouvez la révoquer depuis votre compte GSC Wizard.

Clé gscw_live_ limitée

Idéale pour codex exec, les pipelines CI, les tâches dans le cloud et tout ce qui n'a pas de navigateur. Créez-en une sous Compte → Clés API dans GSC Wizard ; elle n'est affichée qu'une fois et n'est stockée que sous forme de hash.

Utilisez une clé en lecture seule pour les agents. Une clé de lecture ne peut appeler aucun des 32 outils de modification, tels que submit_sitemap, submit_indexnow_urls ou add_site. La vérification s'exécute sur le serveur avant l'exécution de l'outil : on ne peut donc pas convaincre un agent de la contourner. Les identifiants Google n'atteignent jamais Codex : le serveur les conserve et Codex ne détient qu'un identifiant GSC Wizard.

05

Que demander à Codex

Les prompts utiles combinent les données de recherche avec le dépôt que Codex a ouvert.

Corriger les title avec de vraies données de requêtes

« Trouve les pages de example.com positionnées entre la 4e et la 15e place avec un CTR inférieur à la courbe. Pour chacune, repère dans ce dépôt le template ou le fichier de contenu qui définit son title et propose un title qui reprend sa requête principale. »

Vérifier une migration avant de la livrer

« Compare les URL que cette branche supprime ou renomme avec les 500 pages les plus cliquées sur les 90 derniers jours. Liste toutes les URL qui ont du trafic et n'ont pas de redirection dans redirects.json. »

Trouver les contenus à mettre à jour

« Lance une analyse de déclin sur la section /blog/, puis ouvre dans content/ les cinq articles qui déclinent le plus et rédige un plan de mise à jour pour chacun, à partir des requêtes qu'ils ont perdues. »

Résoudre la cannibalisation dans le code

« Trouve les requêtes sur lesquelles au moins deux de nos pages se concurrencent. Pour chaque paire, vérifie les liens internes et les canonicals dans les templates et indique quelle page devrait l'emporter. »

Vérifier l'indexation après un déploiement

« Inspecte les dix URL ajoutées dans le dernier commit et dis-moi lesquelles ne sont pas encore indexées, avec la raison donnée par Google. »

Dites-le une fois à Codex, dans AGENTS.md

Codex lit AGENTS.md au début d'une session. Quelques lignes suffisent pour ne pas répéter la propriété et les règles de la maison dans chaque prompt.

## Search data
- Search Console property: sc-domain:example.com (use the gsc-wizard MCP tools).
- Before changing a title, meta description or URL, look up the page's
  current queries with get_page_performance and keep its top query in the title.
- Treat the last 3 days as incomplete; report settledThrough with any numbers.
- Never call submit_sitemap or submit_indexnow_urls without asking first.
06

Les outils que Codex peut appeler

128 outils sont disponibles pour chaque compte. Chacun publie des annotations MCP telles que readOnlyHint et destructiveHint, ce qui permet à Codex de distinguer les lectures des écritures pour décider s'il doit demander une validation.

Groupe Outils représentatifs Scope
Analyse de la recherchequery_search_analytics, query_top_queries, query_top_pages, get_page_performancelecture
Analysefind_decaying_content, analyze_cannibalization, analyze_ctr_curve, score_opportunitieslecture
Détectiondetect_anomalies, detect_change_points, get_ranking_changes, forecast_trafficlecture
Indexation & on-pageinspect_url, bulk_inspect_urls, list_sitemaps, audit_onpage_seolecture
Autres sourcesBing Webmaster, GA4 (y compris le trafic de référence des LLM), Core Web Vitalslecture
Modificationssubmit_sitemap, submit_indexnow_urls, create_annotation, create_topic_clusterécriture

Les dates sont facultatives pour chaque outil : une plage omise correspond par défaut aux 28 derniers jours complets, si bien que Codex n'a jamais besoin de connaître la date du jour. Les outils à plafond de lignes renvoient un bloc de pagination qui indique s'il reste des lignes, afin que l'agent ne prenne pas une liste tronquée pour une liste complète. Le catalogue complet, avec les arguments, se trouve sur mcp.gscwizard.com, et les détails du protocole dans la référence du serveur.

07

Dépannage

/mcp n'affiche pas gsc-wizard

Lancez codex mcp list pour vérifier que l'entrée existe, et assurez-vous que le bloc de ~/.codex/config.toml est une entrée url et non une entrée command. Redémarrez Codex après avoir modifié le fichier : il lit la configuration au démarrage.

Chaque appel renvoie 401 unauthorized

Avec une clé : la variable désignée dans bearer_token_env_var doit être exportée dans le shell qui a lancé Codex et contenir la clé gscw_live_ complète. Avec OAuth : relancez codex mcp login gsc-wizard. Dans les deux cas, le compte doit avoir un essai ou un abonnement actif et au moins une propriété Search Console connectée.

Un outil d'écriture est refusé

C'est le scope de lecture qui fait son travail. Si vous voulez vraiment que Codex soumette des sitemaps ou des URL IndexNow, créez une clé avec droit d'écriture ou utilisez la connexion OAuth, et gardez cet identifiant à l'écart des exécutions sans surveillance.

Les appels expirent sur les grandes propriétés

Augmentez tool_timeout_sec pour le serveur, et restreignez la requête : un filtre sur un chemin ou une plage de dates plus courte répond plus vite qu'une requête sur tout le site et sur seize mois.

Les chiffres diffèrent de l'interface Search Console

Vérifiez settledThrough et dataSource dans la réponse. La plage par défaut se termine au dernier jour complet, alors que l'interface inclut les tout derniers jours, encore partiels.

08

Questions fréquentes

Codex prend-il en charge les serveurs MCP distants comme GSC Wizard ?

Oui. Codex prend en charge les serveurs MCP Streamable HTTP configurés avec une url dans ~/.codex/config.toml ou ajoutés avec codex mcp add --url. Le serveur GSC Wizard se trouve sur https://mcp.gscwizard.com/mcp : il n'y a donc rien à installer ni à exécuter en local.

Dois-je utiliser OAuth ou une clé API avec Codex ?

Pour un usage interactif, codex mcp login lance le flux OAuth dans votre navigateur et ne demande aucune gestion de clé. Pour codex exec, les jobs CI et les autres exécutions sans surveillance, utilisez une clé API gscw_live_ en lecture seule, stockée dans une variable d'environnement et référencée avec bearer_token_env_var : le secret n'atterrit ainsi jamais dans config.toml.

Le CLI Codex, l'extension d'IDE et l'app partagent-ils la configuration MCP ?

Oui. Ils lisent le même fichier ~/.codex/config.toml : ajouter gsc-wizard une seule fois le rend disponible dans le terminal, dans l'extension d'IDE et dans l'app desktop.

Codex peut-il modifier quoi que ce soit dans ma Search Console ?

Seulement avec un identifiant ayant le droit d'écriture. Une clé API en lecture seule ne peut appeler aucun des 32 outils de modification (comme submit_sitemap ou submit_indexnow_urls) ; la vérification s'exécute sur le serveur avant l'exécution de l'outil. Vous pouvez aussi restreindre la liste des outils côté client avec enabled_tools dans config.toml.

De combien d'outils Codex dispose-t-il ?

128 outils sont disponibles pour chaque compte et couvrent les performances Search Console, l'analyse, l'indexation, Bing Webmaster, Yandex Webmaster, GA4 et Google Merchant Center. Les envoyer tous consomme du contexte à chaque tour : la plupart des configurations Codex ne listent donc dans enabled_tools que les outils dont une tâche a besoin.

Est-ce payant ?

L'accès au MCP est inclus dans les formules GSC Wizard et dans l'essai gratuit, qui ne demande pas de carte bancaire. L'utilisation de Codex est facturée par OpenAI comme d'habitude. Voir les tarifs.

Voir aussi

Donnez vos données de recherche à Codex

Connectez une propriété, lancez une commande, et laissez l'agent qui modifie votre site voir comment il performe dans la recherche.

Des astuces Search Console dans votre boîte mail

Des méthodes concrètes pour GSC et GA4, les nouveautés du produit et des expériences SEO. Pas de spam, désinscription à tout moment.