Tool MCP

70 tool che il tuo agente può chiamare.

52 tool di lettura e 18 tool di scrittura su Google Search Console, Bing Webmaster Tools, IndexNow, Core Web Vitals e GA4. I nomi corrispondono a quelli che il tuo agente vede in tools/list.

Ultimo aggiornamento: 2026-10-30

In breve

GSC Magic espone 70 tool MCP: 12 per Google Search Console, 8 per Report SEO, 38 per Bing Webmaster Tools, 2 per IndexNow, 4 per Core Web Vitals e PageSpeed, 6 per Google Analytics 4. 52 sono in sola lettura; i 18 tool di scrittura (sitemap, IndexNow, invio URL a Bing, impostazioni di scansione) sono offerti solo sui piani a pagamento mentre la modalità scrittura è attiva, e il proprietario può disattivarla in «Settings».

I tool visibili a un dato account dipendono dal piano, dai permessi Google concessi e dalle chiavi aggiunte (Bing, IndexNow). I tool di scrittura sono contrassegnati da scrittura: sono offerti solo su un piano a pagamento mentre la modalità scrittura è attiva (si attiva non appena Google concede i permessi completi per Search Console e il proprietario può disattivarla in «Settings»). Tutto il resto è in sola lettura e un agente può chiamarlo senza problemi.

Google Search Console

Dati sulle prestazioni, Controllo URL e sitemap tramite l’API di Search Console, con OAuth gestito per te.

  • gsc_list_sites Elenca ogni proprietà di Search Console a cui l’account può accedere, con il livello di permesso.
  • gsc_get_site Recupera una proprietà e il livello di permesso dell’account su di essa.
  • gsc_query_analytics Prestazioni di ricerca raggruppate per query, pagina, paese, dispositivo, aspetto nella ricerca, data od ora, con filtri. Fino a 25.000 righe per query.
  • gsc_list_sitemaps Sitemap inviate per una proprietà, con stato, errori, avvisi e numero di pagine indicizzate.
  • gsc_get_sitemap Dettagli di una sitemap inviata.
  • gsc_inspect_url Controllo URL: indicizzato o no, stato di copertura, URL canonici, ultima scansione, robots, usabilità sui dispositivi mobili e risultati multimediali.
  • gsc_inspect_urls_batch Controlla fino a 500 URL in una sola chiamata, con limitazione della frequenza per restare nella quota di Google, e uno stato sintetico per ogni URL.
  • gsc_add_sitescrittura Aggiunge una proprietà a Search Console (la verifica avviene comunque nell’interfaccia di Search Console).
  • gsc_delete_sitescrittura Rimuove una proprietà dalla Search Console dell’account.
  • gsc_submit_sitemapscrittura Invia o reinvia una sitemap.
  • gsc_delete_sitemapscrittura Rimuove una sitemap da Search Console.
  • gsc_request_indexingscritturaopzionale Notifica a Google un URL aggiornato o eliminato tramite l’Indexing API (ufficialmente per le pagine JobPosting e BroadcastEvent).

Report SEO

Analisi che girano sui nostri server e restituiscono numeri elaborati, così l’agente ragiona sui risultati invece di scorrere righe grezze.

  • report_quick_wins Coppie query-pagina in posizioni 4–20 con molte impressioni: il traffico più economico da guadagnare, ordinato per clic extra potenziali.
  • report_traffic_drops Confronta un periodo con quello di pari durata che lo precede e restituisce le pagine o le query che hanno perso e guadagnato più clic.
  • report_content_decay Pagine i cui clic sono calati in ciascuna delle ultime tre finestre: uno scivolamento costante, non un calo isolato. Candidate a un aggiornamento dei contenuti.
  • report_cannibalization Query per cui due o più tue pagine ottengono ciascuna una quota significativa di impressioni, disperdendo i segnali di posizionamento.
  • report_ctr_outliers Pagine con un CTR inferiore alla metà della mediana del tuo sito alla stessa posizione: candidate a title e description migliori.
  • report_brand_split Query brand e non brand con clic, impressioni e quota di clic, più le query principali di ciascun gruppo.
  • report_index_health Legge gli URL dalle tue sitemap, li controlla con l’API di Controllo URL e li raggruppa per stato di copertura.
  • report_google_vs_bing Clic e impressioni per pagina di Google e Bing affiancati.

Bing Webmaster Tools

L’intera API di Bing Webmaster: prestazioni di ricerca, dati di scansione, backlink, keyword research e invio di URL.

  • bing_list_sites Siti in Bing Webmaster Tools per la chiave API, con stato di verifica.
  • bing_get_site_roles Utenti con accesso a un sito.
  • bing_query_stats Clic, impressioni e posizione media per le principali query di ricerca (settimanali, circa sei mesi).
  • bing_page_stats Clic, impressioni e posizione media per le pagine principali.
  • bing_page_query_stats Query di ricerca che hanno portato a una pagina.
  • bing_query_page_stats Pagine mostrate per una query di ricerca.
  • bing_query_page_detail_stats Statistiche dettagliate per una query su una pagina.
  • bing_query_traffic_stats Storico del traffico per una query.
  • bing_rank_traffic_stats Clic e impressioni giornalieri per l’intero sito.
  • bing_crawl_stats Pagine scansionate al giorno, errori di scansione, numero di pagine in indice e pagine bloccate da robots.txt.
  • bing_crawl_issues URL con problemi di scansione: 4xx/5xx, DNS, timeout, malware.
  • bing_url_info Dettagli di indicizzazione per un singolo URL: stato HTTP, ultima scansione, data di scoperta, dimensione, anchor.
  • bing_url_traffic Clic e impressioni per un singolo URL.
  • bing_list_sitemaps Sitemap e feed inviati a Bing, con stato e numero di URL.
  • bing_sitemap_details Sitemap figlie di un indice di sitemap.
  • bing_keyword Impressioni di ricerca su Bing per qualsiasi keyword in un periodo (keyword research, non limitata al tuo sito).
  • bing_keyword_stats Impressioni settimanali storiche per una keyword.
  • bing_url_submission_quota Quota giornaliera e mensile residua per l’invio di URL.
  • bing_list_blocked_urls URL e directory bloccati nei risultati di Bing.
  • bing_crawl_settings Frequenza di scansione oraria e impostazione di crawl boost.
  • bing_list_query_params Parametri di query che Bing ignora per la normalizzazione degli URL.
  • bing_fetched_urls URL acquisiti in precedenza con Fetch as Bingbot.
  • bing_fetched_url_details Risultato di una richiesta Fetch as Bingbot: stato, intestazioni, contenuto.
  • bing_add_sitescrittura Aggiunge un sito a Bing Webmaster Tools.
  • bing_verify_sitescrittura Tenta la verifica di un sito (meta tag, file XML o DNS già presenti).
  • bing_remove_sitescrittura Rimuove un sito da Bing Webmaster Tools.
  • bing_submit_urlsscrittura Invia fino a 500 URL per la scansione e l’indicizzazione, controllando prima la quota residua.
  • bing_save_crawl_settingsscrittura Imposta la frequenza di scansione oraria e il crawl boost.
  • bing_submit_sitemapscrittura Invia una sitemap o un feed a Bing.
  • bing_remove_sitemapscrittura Rimuove una sitemap o un feed inviato.
  • bing_block_urlscrittura Blocca una pagina o una directory nei risultati di Bing.
  • bing_unblock_urlscrittura Rimuove il blocco di una pagina o di una directory.
  • bing_add_query_paramscrittura Dice a Bing di ignorare un parametro di query.
  • bing_remove_query_paramscrittura Smette di ignorare un parametro di query.
  • bing_fetch_urlscrittura Chiede a Bingbot di acquisire un URL subito; leggi il risultato più tardi con bing_fetched_url_details.

IndexNow

Avvisa Bing, Yandex, Seznam, Naver e gli altri motori IndexNow di URL nuovi, modificati o eliminati in pochi secondi.

  • indexnow_generate_key Genera una nuova chiave IndexNow e il file da pubblicare sul sito.
  • indexnow_submitscrittura Avvisa i motori IndexNow di URL nuovi, modificati o eliminati: un host per chiamata, fino a 10.000 URL.

Core Web Vitals e PageSpeed

Dati reali degli utenti dal Chrome UX Report e audit Lighthouse per qualsiasi origin o URL di tua proprietà.

  • cwv_get_origin Core Web Vitals reali degli utenti (LCP, INP, CLS, FCP, TTFB) per un intero origin, ultimi 28 giorni, p75 e quote buono/da migliorare/scarso.
  • cwv_get_url Core Web Vitals reali degli utenti per un singolo URL (servono abbastanza dati di traffico Chrome).
  • cwv_history Storico settimanale dei Core Web Vitals, fino a circa sei mesi, per un origin o un URL.
  • psi_run_audit Esegue Lighthouse tramite PageSpeed Insights: punteggi per categoria, metriche di laboratorio, dati sul campo e principali opportunità.

Google Analytics 4

Report GA4 accanto ai tuoi dati di ricerca: sessioni, eventi chiave, pagine di destinazione e traffico di riferimento dagli assistenti AI.

  • ga_list_properties Account Google Analytics e proprietà GA4 a cui l’account può accedere.
  • ga_list_data_streams Stream di dati di una proprietà GA4, incluso l’ID misurazione usato dal tag sul sito.
  • ga_get_metadata Dimensioni e metriche disponibili per una proprietà, comprese quelle personalizzate, con ricerca.
  • ga_run_report Esegue un report GA4 con dimensioni, metriche, intervalli di date, filtri, ordinamento e paginazione.
  • ga_run_realtime_report Report in tempo reale di GA4 per gli ultimi 30 minuti.
  • ga_list_key_events Eventi chiave (in precedenza conversioni) configurati su una proprietà.

Come sono progettati i tool

  • Numeri elaborati, non dump grezzi. I report confrontano i periodi, calcolano le quote e ordinano per impatto sui nostri server, così il modello legge un risultato breve invece di 25.000 righe.
  • Limiti espliciti. I risultati riportano flag di troncamento e note sulle quote (Controllo URL: 2.000 al giorno), così l’agente non scambia mai un dataset parziale per uno completo.
  • Schemi portabili. Niente union, riferimenti o record liberi negli schemi di input, quindi ogni tool si carica in Claude, ChatGPT, Cursor e nei client più piccoli.
  • Hint di sicurezza. Ogni tool dichiara readOnlyHint, destructiveHint e openWorldHint, e il server applica la sola lettura a prescindere da ciò che chiede il client.

I dettagli di connessione per gli sviluppatori sono nella pagina qualsiasi client MCP. L’endpoint è https://mcp.gscmagic.com/mcp.