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
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_sitesElenca ogni proprietà di Search Console a cui l’account può accedere, con il livello di permesso. -
gsc_get_siteRecupera una proprietà e il livello di permesso dell’account su di essa. -
gsc_query_analyticsPrestazioni 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_sitemapsSitemap inviate per una proprietà, con stato, errori, avvisi e numero di pagine indicizzate. -
gsc_get_sitemapDettagli di una sitemap inviata. -
gsc_inspect_urlControllo URL: indicizzato o no, stato di copertura, URL canonici, ultima scansione, robots, usabilità sui dispositivi mobili e risultati multimediali. -
gsc_inspect_urls_batchControlla 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_sitescritturaAggiunge una proprietà a Search Console (la verifica avviene comunque nell’interfaccia di Search Console). -
gsc_delete_sitescritturaRimuove una proprietà dalla Search Console dell’account. -
gsc_submit_sitemapscritturaInvia o reinvia una sitemap. -
gsc_delete_sitemapscritturaRimuove una sitemap da Search Console. -
gsc_request_indexingscritturaopzionaleNotifica 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_winsCoppie query-pagina in posizioni 4–20 con molte impressioni: il traffico più economico da guadagnare, ordinato per clic extra potenziali. -
report_traffic_dropsConfronta 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_decayPagine 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_cannibalizationQuery per cui due o più tue pagine ottengono ciascuna una quota significativa di impressioni, disperdendo i segnali di posizionamento. -
report_ctr_outliersPagine con un CTR inferiore alla metà della mediana del tuo sito alla stessa posizione: candidate a title e description migliori. -
report_brand_splitQuery brand e non brand con clic, impressioni e quota di clic, più le query principali di ciascun gruppo. -
report_index_healthLegge gli URL dalle tue sitemap, li controlla con l’API di Controllo URL e li raggruppa per stato di copertura. -
report_google_vs_bingClic 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_sitesSiti in Bing Webmaster Tools per la chiave API, con stato di verifica. -
bing_get_site_rolesUtenti con accesso a un sito. -
bing_query_statsClic, impressioni e posizione media per le principali query di ricerca (settimanali, circa sei mesi). -
bing_page_statsClic, impressioni e posizione media per le pagine principali. -
bing_page_query_statsQuery di ricerca che hanno portato a una pagina. -
bing_query_page_statsPagine mostrate per una query di ricerca. -
bing_query_page_detail_statsStatistiche dettagliate per una query su una pagina. -
bing_query_traffic_statsStorico del traffico per una query. -
bing_rank_traffic_statsClic e impressioni giornalieri per l’intero sito. -
bing_crawl_statsPagine scansionate al giorno, errori di scansione, numero di pagine in indice e pagine bloccate da robots.txt. -
bing_crawl_issuesURL con problemi di scansione: 4xx/5xx, DNS, timeout, malware. -
bing_url_infoDettagli di indicizzazione per un singolo URL: stato HTTP, ultima scansione, data di scoperta, dimensione, anchor. -
bing_url_trafficClic e impressioni per un singolo URL. -
bing_list_sitemapsSitemap e feed inviati a Bing, con stato e numero di URL. -
bing_sitemap_detailsSitemap figlie di un indice di sitemap. -
bing_link_countsLe tue pagine che hanno link in entrata, con il numero di link. -
bing_url_linksPagine esterne che linkano un URL del tuo sito. -
bing_keywordImpressioni di ricerca su Bing per qualsiasi keyword in un periodo (keyword research, non limitata al tuo sito). -
bing_keyword_statsImpressioni settimanali storiche per una keyword. -
bing_url_submission_quotaQuota giornaliera e mensile residua per l’invio di URL. -
bing_list_blocked_urlsURL e directory bloccati nei risultati di Bing. -
bing_crawl_settingsFrequenza di scansione oraria e impostazione di crawl boost. -
bing_list_query_paramsParametri di query che Bing ignora per la normalizzazione degli URL. -
bing_fetched_urlsURL acquisiti in precedenza con Fetch as Bingbot. -
bing_fetched_url_detailsRisultato di una richiesta Fetch as Bingbot: stato, intestazioni, contenuto. -
bing_add_sitescritturaAggiunge un sito a Bing Webmaster Tools. -
bing_verify_sitescritturaTenta la verifica di un sito (meta tag, file XML o DNS già presenti). -
bing_remove_sitescritturaRimuove un sito da Bing Webmaster Tools. -
bing_submit_urlsscritturaInvia fino a 500 URL per la scansione e l’indicizzazione, controllando prima la quota residua. -
bing_save_crawl_settingsscritturaImposta la frequenza di scansione oraria e il crawl boost. -
bing_submit_sitemapscritturaInvia una sitemap o un feed a Bing. -
bing_remove_sitemapscritturaRimuove una sitemap o un feed inviato. -
bing_block_urlscritturaBlocca una pagina o una directory nei risultati di Bing. -
bing_unblock_urlscritturaRimuove il blocco di una pagina o di una directory. -
bing_add_query_paramscritturaDice a Bing di ignorare un parametro di query. -
bing_remove_query_paramscritturaSmette di ignorare un parametro di query. -
bing_fetch_urlscritturaChiede 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_keyGenera una nuova chiave IndexNow e il file da pubblicare sul sito. -
indexnow_submitscritturaAvvisa 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_originCore 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_urlCore Web Vitals reali degli utenti per un singolo URL (servono abbastanza dati di traffico Chrome). -
cwv_historyStorico settimanale dei Core Web Vitals, fino a circa sei mesi, per un origin o un URL. -
psi_run_auditEsegue 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_propertiesAccount Google Analytics e proprietà GA4 a cui l’account può accedere. -
ga_list_data_streamsStream di dati di una proprietà GA4, incluso l’ID misurazione usato dal tag sul sito. -
ga_get_metadataDimensioni e metriche disponibili per una proprietà, comprese quelle personalizzate, con ricerca. -
ga_run_reportEsegue un report GA4 con dimensioni, metriche, intervalli di date, filtri, ordinamento e paginazione. -
ga_run_realtime_reportReport in tempo reale di GA4 per gli ultimi 30 minuti. -
ga_list_key_eventsEventi 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.