GSC MCP pour Google Search Console.
mcp-gsc relie Google Search Console à Claude, ChatGPT, Cursor ou un autre client MCP. Analysez les requêtes et les pages, inspectez des URL, gérez les sitemaps et utilisez OAuth Google.
- Mode recommandé
- Read-only
- Authentification
- OAuth Google
- Options
- npm / Worker
- Licence
- MIT
npm · Google Search Console MCP
Installer GSC MCP en local avec npm
npm lance un serveur Streamable HTTP sur votre machine. Google OAuth et les identifiants doivent être configurés avant l'exécution : ce n'est pas une connexion en un clic.
1. Préparer l'accès à Google
Node.js ^22.18.0 / >=24.11.0+npm- Utilisez un compte Google ayant accès à la propriété Search Console à analyser.
- Créez un client OAuth dans Google Cloud, activez les API requises et enregistrez l'URI de redirection locale exacte.
- Renseignez ces trois variables d'environnement selon la documentation de cette version. TOKEN_ENCRYPTION_KEY doit être du base64 valide représentant exactement 32 octets aléatoires.
GOOGLE_CLIENT_IDGOOGLE_CLIENT_SECRETTOKEN_ENCRYPTION_KEY
Enregistrez cette URI exacte dans Google Cloud. Hôte, port et chemin doivent correspondre ; localhost et 127.0.0.1 sont différents.
http://127.0.0.1:8080/google/callback localhost ≠ 127.0.0.1
2. Démarrer le serveur local
Après avoir configuré les identifiants dans votre terminal, lancez le paquet npm. Pour l'analyse, utilisez la commande de lecture seule adaptée à votre shell.
Le mode par défaut est readwrite. Pour l'analyse uniquement, choisissez readonly avant l'autorisation Google ; les outils d'écriture ne seront pas enregistrés.
Terminal Bash / zsh
export GSC_ACCESS_MODE=readonly
npx -y @digestseo/mcp-gscPowerShell
$env:GSC_ACCESS_MODE = 'readonly'
npx -y @digestseo/mcp-gscPoint d’accès local · Streamable HTTP
http://127.0.0.1:8080/mcp 3. Connecter votre client MCP
Gardez le lanceur actif et connectez un client sur le même ordinateur à son endpoint Streamable HTTP : ce n'est pas du stdio.
Claude Code
claude mcp add --transport http gsc http://127.0.0.1:8080/mcpConnecter Codex CLI / IDE
codex mcp add gsc --url http://127.0.0.1:8080/mcpCursor
Dans Cursor, ajoutez un serveur MCP Streamable HTTP nommé gsc avec cette URL (Cursor local).
http://127.0.0.1:8080/mcp ChatGPT / Claude.ai
ChatGPT et Claude hébergés dans le cloud ne peuvent pas atteindre le 127.0.0.1 de votre ordinateur. Utilisez votre Worker HTTPS ou un tunnel MCP sécurisé disponible, sous réserve des autorisations du compte.
Besoin d'un accès distant ?Besoin d'un accès distant ?
L'auto-hébergement sur Cloudflare Workers reste disponible, avec configuration Cloudflare et Google OAuth. L'exemple ci-dessous utilise Bash ; suivez SETUP.md pour les étapes complètes.
À propos
Qu’est-ce que mcp-gsc ?
mcp-gsc est un serveur Model Context Protocol auto-hébergeable qui relie votre client IA directement à l’API officielle de Google Search Console.
Exécutez le paquet npm localement en HTTP sur la boucle locale ou déployez votre propre Worker Cloudflare pour un endpoint HTTPS. Les deux utilisent Google OAuth.
Le lanceur local conserve par défaut l'état chiffré dans ~/.mcp-gsc/state ; un Worker utilise le stockage de votre compte Cloudflare. Il ne s'agit pas d'un connecteur hébergé par DigestSEO.
Importez les performances Web : multimodal pour relever les pages à examiner. Cet outil n'analyse pas les photos elles-mêmes. Analyse SEO de Google Lens et de la recherche multimodale.
Comparez la visibilité Google de vos comptes autorisés. Aucun suivi des likes, abonnés ou vues dans les applications. Comparez la visibilité de vos contenus sociaux sur Google.
Outils
Capacités du serveur
Des outils ciblés couvrent les statistiques, l’inspection d’URL, les sitemaps, l’indexation, les diagnostics SEO et le récapitulatif hebdomadaire.
La liste inclut des outils d'écriture facultatifs. GSC_ACCESS_MODE=readonly n'expose que les outils sans modification ; l'Indexing API de Google est réservée aux contenus éligibles.
get_capabilitiesListe les capacités disponibles et l’état de l’authentification.
list_sitesListe les propriétés Search Console accessibles au compte connecté.
query_search_analyticsInterroge les clics, impressions, CTR et positions sur une période personnalisée.
inspect_urlRécupère le rapport d’inspection d’URL en direct et les détails d’indexation.
list_sitemapsListe les sitemaps envoyés avec leur état d’exploration et leurs avertissements.
add_siteAjoute une propriété Search Console au compte connecté.
delete_siteSupprime une propriété Search Console du compte.
submit_sitemapEnvoie un sitemap pour une propriété Search Console.
delete_sitemapSupprime un sitemap envoyé d’une propriété.
get_sitemapRécupère l’état détaillé d’un sitemap envoyé.
identify_quick_winsTrouve les requêtes à fortes impressions classées entre les positions 8 et 20.
detect_cannibalizationTrouve les requêtes où plusieurs pages se concurrencent.
detect_content_decayIdentifie les pages dont les clics issus de la recherche ont le plus baissé.
request_indexingDemande l’indexation via l’API d’indexation de Google. Google restreint actuellement cette API aux pages contenant des données structurées JobPosting ou aux pages de diffusion en direct contenant BroadcastEvent dans VideoObject. Elle n’est pas disponible pour la soumission générale de pages web.
list_indexed_pagesListe les pages ayant reçu des impressions dans Search Console.
compare_performanceCompare les clics, impressions, CTR et positions entre deux périodes.
weekly_digestGénère un rapport SEO hebdomadaire en langage clair.
Déploiement
Besoin d'un accès distant ?
L'auto-hébergement sur Cloudflare Workers reste disponible, avec configuration Cloudflare et Google OAuth. L'exemple ci-dessous utilise Bash ; suivez SETUP.md pour les étapes complètes.
git clone https://github.com/AKzar1el/mcp-gsc.git
cd mcp-gsc && npm install
npx wrangler login
cp wrangler.example.jsonc wrangler.jsonc
npx wrangler deployAjoutez le dépôt à vos favoris et utilisez Search Console dans Claude.
Open source et auto-hébergeable. Configurez Google OAuth avec le guide ou déployez votre propre Worker.