Connecter Search Console à n'importe quel client MCP

Le point de terminaison

Le serveur se trouve sur /mcp du domaine de l'application et parle Streamable HTTP en version de protocole 2025-06-18. Les clients envoient du JSON-RPC en POST, envoient une requête initialize, puis tools/list. Il n'y a rien à installer et aucun proxy local dans le chemin.

• Authorization : Bearer avec une clé de la forme apk_live_ suivie de 32 caractères hexadécimaux
• Les clés sont affichées une seule fois à la création et stockées uniquement sous forme de hachage SHA-256
• Chaque appel met à jour l'horodatage de dernière utilisation et le compteur de requêtes de la clé

Les outils

Regroupés par fonction, avec des noms clairs pour que le modèle choisisse le bon outil. Une clé en lecture seule n'accède jamais à un outil qui écrit ou dépense des crédits de recherche.

• Découverte : list_properties, search_analytics
• Performance : top_queries, top_pages, top_countries, compare_periods
• Diagnostic : content_decay, cannibalization, ctr_benchmark, page_poaching, rank_changes, new_lost_rankings
• Indexation : url_inspection, sitemaps
• Chronologie : annotations, et create_annotation sur une clé en écriture
• Analytics : ga4_overview, ga4_breakdown, ga4_key_events
• Recherche : mots-clés, SERP, backlinks, suivi de positions et audits de site, qui consomment des crédits de recherche
• Moteur de contenu : content_list_tasks, content_claim, content_get_brief, content_submit, content_publish et les outils de visuels de couverture, pour rédiger depuis la file d'attente

Les dates sont facultatives

Omettez la plage sur n'importe quel outil et le serveur utilise les 28 derniers jours stabilisés, en tenant compte du délai de rapport de Search Console, avec la fenêtre de comparaison par défaut sur la période précédente de même durée. Le client n'a jamais besoin de connaître la date du jour pour poser une question pertinente.

Portées et limites de débit

Une clé est en lecture seule ou en lecture et écriture. Une clé en lecture seule ne peut absolument pas accéder à un outil d'écriture, et chaque modification sur une clé en écriture est journalisée pour audit.

• 60 requêtes par minute et par clé, 1 000 par heure et par compte
• Un dépassement de limite renvoie HTTP 429 avec Retry-After en secondes
• Révoquez une seule clé sans toucher au reste du compte

REST, si vous préférez

Les outils Search Console et GA4 sont aussi exposés en routes GET et POST sous /v1, avec un document OpenAPI 3.1 généré à /v1/openapi.json, qui sert aussi de spécification d'appel de fonctions. Mêmes clés, mêmes portées, mêmes limites.