Collega Search Console a qualsiasi client MCP

L'endpoint

Il server si trova su /mcp nel dominio dell'app e utilizza Streamable HTTP alla versione di protocollo 2025-06-18. I client inviano JSON-RPC tramite POST, effettuano una richiesta initialize, quindi tools/list. Non c'è nulla da installare e nessun proxy locale nel percorso.

• Authorization: Bearer, con una chiave nel formato apk_live_ seguita da 32 caratteri esadecimali
• Le chiavi vengono mostrate una sola volta alla creazione e memorizzate solo come hash SHA-256
• Ogni chiamata aggiorna il timestamp dell'ultimo utilizzo della chiave e il contatore delle richieste

Gli strumenti

Raggruppati per funzione, con nomi chiari perché un modello scelga quello giusto. Una chiave di sola lettura non raggiunge mai uno strumento che scrive o consuma crediti di ricerca.

• Individuazione: list_properties, search_analytics
• Prestazioni: top_queries, top_pages, top_countries, compare_periods
• Diagnosi: content_decay, cannibalization, ctr_benchmark, page_poaching, rank_changes, new_lost_rankings
• Indicizzazione: url_inspection, sitemaps
• Cronologia: annotations, e create_annotation con una chiave di scrittura
• Analisi: ga4_overview, ga4_breakdown, ga4_key_events
• Ricerca: parole chiave, SERP, backlink, monitoraggio posizioni e audit del sito, che consumano crediti di ricerca
• Motore di contenuti: content_list_tasks, content_claim, content_get_brief, content_submit, content_publish e gli strumenti per le copertine, per scrivere dalla coda

Le date sono facoltative

Ometti l'intervallo in qualsiasi strumento e il server utilizza gli ultimi 28 giorni consolidati, tenendo conto del ritardo di reporting di Search Console, con la finestra di confronto impostata di default sul periodo precedente della stessa durata. Il client non deve mai conoscere la data odierna per porre una domanda sensata.

Ambiti e limiti di frequenza

Una chiave è di sola lettura oppure di lettura e scrittura. Una chiave di sola lettura non può in alcun modo accedere a uno strumento di scrittura, e ogni modifica effettuata con una chiave di scrittura viene registrata nel log di audit.

• 60 richieste al minuto per chiave, 1.000 all'ora per account
• Il superamento del limite restituisce HTTP 429 con Retry-After in secondi
• Revoca una singola chiave senza toccare il resto dell'account

REST, se preferisci

Gli strumenti di Search Console e GA4 sono esposti anche come route GET e POST sotto /v1, con un documento OpenAPI 3.1 generato in /v1/openapi.json, utilizzabile anche come specifica per il function calling. Stesse chiavi, stessi ambiti, stessi limiti.