Google Search Console Server MCP

Elenca tutte le proprietà GSC a cui l'utente autenticato può accedere. Restituisce l'ID della proprietà (UUID) e l'URL (sc-domain:…) da passare a tutti gli altri strumenti.

Clic, impression, CTR e posizione media per una proprietà in una finestra a scelta. Accetta preset (last_7_days, last_28_days, last_3_months, last_year) o date assolute from/to. Restituisce anche un branded_breakdown che divide clic, impression, CTR e posizione tra branded e non-branded — basato sul tag Brand della proprietà.

Confronta due finestre GSC fianco a fianco e ottieni diff + change_pct per clic, impression, CTR e posizione. Il periodo A può essere un preset; il periodo B è assoluto.

I maggiori movimenti tra due periodi, con i delta già calcolati così il tuo assistente evita di scavare voce per voce. Scegli dimension=keywords or pages, una metrica (clic, impression o posizione) e direction=up / down / both per ottenere chi guadagna, chi cala o le oscillazioni più ampie in entrambe le direzioni. Period B di default è la finestra immediatamente precedente a Period A.

Keyword top di una proprietà ordinate per clic, impression, CTR o posizione — con confronto periodo su periodo. Paginato tramite next_cursor. Filtra con branded: true|false per separare le query di brand da quelle conquistate con la SEO; il riepilogo include un branded_breakdown che leggi in un colpo d'occhio.

Serie temporale giornaliera (clic, impression, CTR, posizione) per una singola query di ricerca in una proprietà. Stesse opzioni di range di date del riepilogo.

Data una singola query, elenca le pagine della tua proprietà che ne guadagnano clic e impression — ordinate per clic, impression, CTR o posizione, con delta periodo su periodo e paginazione tramite next_cursor. Utile per individuare la cannibalizzazione di keyword o per trovare la pagina canonica di un termine.

Pagine top di una proprietà ordinate per clic, impression, CTR o posizione — ogni riga restituisce clic, impression, CTR e posizione con delta periodo su periodo. Paginato tramite next_cursor.

Serie temporale giornaliera (clic, impression, CTR, posizione) per l'URL di una pagina in una proprietà. Compatibile direttamente con la stessa sintassi di range di date del riepilogo.

Dato l'URL di una pagina, elenca le query di ricerca che ne generano clic e impression — ordinate per la metrica scelta, con delta periodo su periodo e paginazione tramite next_cursor. L'inverso di list_pages_for_keyword: parti da un URL e vedi esattamente quali query lo alimentano.

Riepilogo di copertura dell'indice per una proprietà: URL known (inviati via sitemap), quanti Google ne indicizza, indexed_pct e una suddivisione by_state (Submitted and indexed, Crawled – currently not indexed, Discovered – currently not indexed, Excluded by 'noindex', Page with redirect, Not found 404, Soft 404…). indexed porta un vero prev/delta; intervallo di date tramite preset o from/to assoluti.

L'andamento giornaliero delle pagine indicizzate — una serie "indexed" di punti {date, value}, sommata tra le sitemap della proprietà e pronta per un grafico a serie temporale. Restituisce points (giorni con dati reali) e segnala insufficient_history quando i giorni sono troppo pochi per un grafico significativo.

Gli URL attualmente in un dato stato di copertura di Google (passa lo state esattamente come lo riporta get_indexation_summary). Ogni riga restituisce url, state, last_crawled, google_canonical vs declared_canonical e discovered_via (sitemap o pagina referente). Paginato a cursore (limit max 200).

Ispezione URL live di Google per una pagina: coverage_state, verdict (PASS / NEUTRAL / FAIL), indexing_allowed, canonical Google vs utente, last_crawl_time, robots_txt_state, page_fetch_state, sitemaps, un campione di URL referenti, rich_results e mobile_usability. Cache-first — restituisce un risultato fresco dalla cache o aggiorna live da GSC entro la quota di ispezione della proprietà.

Tutte le attività di una proprietà. Filtra per stato (open / done), assegnatario, taskbox (colonna) o q (ricerca per titolo senza distinzione tra maiuscole e minuscole). Paginato tramite next_cursor.

Le colonne della board delle attività (taskbox) di una property: id, nome, stato (todo / in_progress / done) e ordine. Passa un id di taskbox restituito — o la parola chiave dello stato — a create_task o update_task per spostare un'attività in quella colonna.

Dettaglio completo di una singola attività. Accetta un UUID, uno slug o l'URL completo dell'attività nel browser (l'argomento property è opzionale quando passi un URL).

Crea un'attività su una proprietà con titolo (obbligatorio), più descrizione opzionale, assegnatario, priorità (1–5, default 3) e taskbox (di default, la colonna TO-DO).

Aggiorna parzialmente un'attività — qualsiasi combinazione di titolo, descrizione, assegnatario, priorità, taskbox, oppure unassign:true per rimuovere l'assegnatario.

Aggiunge un commento a un'attività. Stesso riferimento flessibile al ticket (UUID / slug / URL) di get_task e update_task.

Elenca i commenti di un'attività, comprese le risposte annidate. Stesso riferimento flessibile al ticket (UUID / slug / URL) di get_task — l'argomento property è opzionale quando passi un URL.

Crea una nota di grafico su una proprietà per una data specifica (Y-m-d) con il testo della nota — più una descrizione più lunga opzionale, una categoria e l'UUID di un'attività collegata. Aggiunta come nota personalizzata a livello di sito, scritta da te.

Elenca le annotazioni di una proprietà entro un intervallo di date, dalla più recente alla più vecchia. Usa un preset (last_7_days, last_28_days, last_3_months, last_year) o date assolute from/to, con ricerca opzionale per sottostringa nel testo della nota e paginazione (limit con tetto a 200).

Dettaglio completo di una singola annotazione tramite il suo id — data, nota, descrizione, categoria, attività collegata, autore e la proprietà a cui appartiene. Usa list_annotations per trovare l'id.

Elimina un'annotazione personalizzata tramite il suo id. Si possono rimuovere solo le tue note personalizzate — le note ufficiali o globali vengono rifiutate. Restituisce l'id con deleted: true.

Elenca i progetti di Site Audit (configurazioni di scansione) della proprietà così puoi scoprire l'audit_id da puntare. Ognuno restituisce audit_id, name, mode (list / complete / organic_traffic), device, start_urls, status, progress, last_crawl_date, pages_crawled e l'ultimo health_score. La maggior parte degli altri strumenti di site-audit usa di default l'audit completato più di recente, quindi serve solo per puntarne uno specifico.

Riepilogo di health tecnica dell'ultima scansione: health_score (current più prev e delta), pages_crawled, crawl_date, issues_by_severity (critical / warning / notice, ciascuno con issue_types e pages_affected vs la scansione precedente), issues_by_category (OnPage, Links, International, Robots, Social) e category_scores per area. Di default usa l'audit più recente.

I problemi tecnici rilevati dall'ultima scansione, dal più grave — ciascuno con issue_code (passalo a list_site_audit_issue_pages), title, severity, category, pages_affected (con prev e delta), indicazioni how_to_fix e priority. Filtra per severity e/o category; paginato a cursore (limit max 200).

Gli URL esatti interessati da un problema — passa il suo issue_code e ottieni ogni url incriminato con il valore per pagina. Paginato a cursore (limit max 200). Trasforma qualsiasi problema dell'audit direttamente in una lista di fix concreta.

Dettaglio completo di scansione per un singolo URL: status_code, crawl_depth, indexability_score e health_score, category_scores, issue_counts e issues[] — i controlli falliti della pagina, ciascuno con issue_code, severity, category, la descrizione per pagina e how_to_fix.

Trova le pagine scansionate che corrispondono a criteri SEO tecnici dal tuo ultimo site audit. Filtra per status_code (es. 404), no_canonical (tag canonical mancante), missing_h1 (intestazione H1 mancante) o check_title (qualsiasi controllo dell'audit mostrato nell'interfaccia, es. "Title Tag too short"). Ordina per health, status_code, url o depth, paginato tramite next_cursor. Ogni riga restituisce url, status_code, title, indexability, performance_score (health 0–100), last_crawled_at, count_errors e count_warnings — più una check_description quando è attivo un filtro per controllo.

Avvia una nuova scansione (azione di scrittura) — mette in coda l'audit e spende i crediti crawler del progetto (separati dai crediti MCP) in proporzione alle pagine scansionate. Supporta le modalità complete e list; restituisce audit_id, status, started_at e pages_queued. I risultati diventano disponibili agli strumenti di lettura una volta terminata la scansione.

Confronta due scansioni per rispondere a "cos'è peggiorato o migliorato dall'ultima volta?" — health_diff più conteggi e quattro liste: new_issues, resolved_issues, worsened e improved, ogni problema con pages_affected, prev e delta. Di default confronta l'ultima scansione con la precedente.

Elenca le pagine che una proprietà monitora in Code Monitor, ognuna con il suo stato di monitoraggio — url, last_change_at (modifica rilevata più recente) e changes_count (totale delle modifiche rilevate). Filtra per sottostringa di url; paginazione a cursore (limit max 200). Restituisce feature_not_available quando il piano non include Code Monitor.

Elenca le modifiche di codice/HTML on-page rilevate, dalle più recenti — ognuna con url, date e change_types (Title, Canonical, Meta Description, noindex, robots.txt, sitemap.xml, H1, Status code, Hreflang, Open Graph, Twitter image, Analytics, Tag Manager). Filtra su una singola pagina con seoMonitorId o page, oppure omettilo per il feed delle modifiche recenti di tutto il progetto; restringi con from/to. Paginazione a cursore (limit max 200).

Ottiene i valori prima/dopo di una singola modifica rilevata, indirizzata tramite url + createdAt — una voce per ogni campo modificato con type, property, before e after (array per i campi a più valori). Passa changeType per restituire un solo campo. Restituisce not_found quando nessuna modifica corrisponde e invalid_change_type per un'etichetta di campo sconosciuta.

Ottiene lo stato catturato più recente di una pagina monitorata — i campi on-page estratti attuali (title, canonical, meta description, meta robots, robots.txt, sitemap.xml, H1, heading, status code, hreflang, immagine Open Graph, Twitter image, Analytics, Tag Manager). Indirizza la pagina tramite seoMonitorId o url; l'HTML grezzo e gli screenshot non vengono memorizzati. Restituisce not_found per una pagina sconosciuta.

Elenca i prompt di AI Tracker (Brand Radar) che una proprietà sta tracciando. Ogni riga restituisce prompt_id, prompt_text, engines_tracked (i motori LLM su cui il prompt viene eseguito), last_run_at (ISO-8601, esecuzione più recente) e runs_in_range (esecuzioni per motore all'interno della finestra). Delimita runs_in_range con un preset (last_7_days, last_28_days, last_3_months, last_year) o date assolute from/to — l'elenco completo dei prompt viene sempre restituito. Filtra per engine (chatgpt/openai, claude/anthropic, gemini, perplexity) e pagina tramite limit (max 200) e next_cursor.

Visibilità per motore di un singolo prompt: runs, mentions, mention_rate (%) e la variazione in punti percentuali rispetto al periodo immediatamente precedente — suddivisa per ChatGPT, Claude, Gemini e Perplexity, con i totali aggregati su tutti i motori. Intervallo di date tramite preset o from/to assoluti (default last_28_days).

Le singole esecuzioni per motore dietro un prompt — una riga per esecuzione con date, engine, i flag mentioned / mentioned_in_text e un response_excerpt (fino a 600 caratteri della risposta AI effettiva). Filtra per engine, delimita per intervallo di date, pagina tramite limit (max 200) e next_cursor.

Le fonti che i motori AI hanno citato rispondendo a un prompt, aggregate sull'intervallo: own_domain più ogni dominio e URL citato, contrassegnati con is_own_domain e url_count — così vedi quali delle tue pagine ottengono citazioni e quali se le aggiudicano i concorrenti.

Crea un prompt di AI Tracker — la domanda che il tracker esegue contro i motori. Imposta la lista dei motori (chatgpt, claude, gemini, perplexity), il country, la lingua della risposta e la cadenza di esecuzione (daily, week o month), e facoltativamente archivialo sotto un topic tramite topicId o topicTitle (find-or-create).

Aggiorna parzialmente un prompt tracciato — qualsiasi combinazione del suo testo, lista dei motori, country, lingua della risposta o cadenza di esecuzione; i campi omessi restano invariati. Il prompt mantiene il suo topic attuale e deve rimanere univoco al suo interno.

Elimina un prompt tracciato e tutte le risposte dei motori registrate. Irreversibile; il topic del prompt resta intatto.

Elenca i topic dei prompt che raggruppano i prompt nella pagina LLM Tracker — ciascuno con topic_id e title. Passa un topic a create_prompt / update_prompt per archiviarvi un prompt.

Crea (o recupera) un topic di prompt tramite title — un upsert idempotente, quindi ricreare un title esistente lo restituisce invariato con created=false. I topic raggruppano i prompt nella pagina LLM Tracker.

Rinomina un topic di prompt tramite il suo topicId. Il nuovo title deve essere non vuoto e univoco all'interno della proprietà (rinominare con lo stesso title è un no-op di successo).

Elimina un topic di prompt. A cascata: ogni prompt archiviato al suo interno, e tutte le risposte registrate di quei prompt, vengono eliminati definitivamente. Restituisce prompts_deleted. Irreversibile.

Elenca le proprietà GA4 collegate ai tuoi progetti. Ogni voce restituisce l'id del progetto e l'URL (entrambi funzionano come argomento property per gli altri strumenti GA4), l'ID della proprietà GA4 sottostante e la data di collegamento. Vengono restituiti solo i progetti con una proprietà GA4 collegata.

Sessioni, utenti, nuovi utenti, conversioni, tasso di coinvolgimento e sessioni per utente per una proprietà in una finestra a scelta — preset (last_7_days, last_28_days, last_3_months, last_year) o date assolute from/to. Ogni metrica restituisce current, prev e delta rispetto al periodo immediatamente precedente.

Confronta due finestre GA4 fianco a fianco — sessioni, utenti, nuovi utenti, conversioni e tasso di coinvolgimento, con entrambi i valori più diff e change_pct per metrica. Il periodo A può essere un preset; il periodo B è assoluto. Il gemello GA4 di compare_date_ranges.

Sessioni suddivise per sorgente di acquisizione. Scegli dimension=source_medium (default) o channel per il raggruppamento dei canali predefinito di GA4 — le righe arrivano ordinate per sessioni, ognuna con la sua share_pct sul totale del periodo, limitate da limit (default 25, max 100).

Metriche GA4 per pagina (landing / URL), ordinate così vedi quali pagine portano più sessioni, iscrizioni (conversioni) o utenti. Ogni riga restituisce la pagina più sessions, users, conversions ed engagement_rate, ciascuna con il prev del periodo precedente e change_pct. Ordina per sessions (default), conversions o users; limitato da limit (default 25, max 100). Il complemento a livello di pagina di get_ga4_traffic_by_source.

Traffico di referral AI/LLM per motore — ChatGPT, Perplexity, Gemini, Claude, Copilot e altri, rilevati dal source/medium di sessione GA4. Ogni motore restituisce sessioni, eventi chiave e durata media delle sessioni, con la variazione rispetto al periodo precedente. Il tuo traffico GEO, misurato.

Elenca i tag di keyword e di pagina di una proprietà. Ogni tag restituisce tag_id, name, type (keyword|page), color, rule_count (regole di assegnazione automatica) e member_count (keyword o pagine che attualmente lo portano). Passa i nomi dei tag al filtro tags di get_top_keywords, get_top_pages e list_winners_losers.

Crea un tag su una proprietà. type è keyword (tagga le keyword), url (tagga le pagine) o both. Il color opzionale è una stringa hex usata dall'interfaccia SEOcrawl. L'identità di un tag è name + type, quindi ricreare un tag esistente ne aggiorna solo il colore.

Applica manualmente un tag a keyword e/o pagine specifiche, oltre a qualsiasi auto-regola. Passa keywords (stringhe esatte) e/o urls (URL di pagina esatti); almeno uno è obbligatorio. Il tag viene creato per il type pertinente se non esiste ancora.

Rimuove un tag da keyword e/o pagine specifiche — l'inverso di apply_tag. Disassegna soltanto il tag da quegli elementi; non elimina il tag stesso e non tocca le regole di assegnazione automatica.

Elimina del tutto un tag: lo disassegna da ogni keyword/pagina e rimuove il tag. type è keyword, url o both. I tag integrati Brand / Non-Brand non possono essere eliminati. Le auto-regole che puntano al tag restano intatte — usa delete_tag_rule per quelle.

Elenca le regole di assegnazione automatica di una proprietà — i pattern che taggano keyword/pagine automaticamente. Filtra eventualmente per tag. Ogni regola restituisce rule_id, tag, field (keyword|url), country e le sue conditions (match + value).

Crea una regola di assegnazione automatica che tagga ogni keyword o pagina corrispondente — attuali e future. field è keyword o url; match è contains, not_contains, exact, starts_with, ends_with o regex (un pattern RE2 sicuro); value è il pattern. Una regola per tag+field; il tagging degli elementi esistenti viene eseguito in modo asincrono.

Elimina una regola di assegnazione automatica tramite il suo rule_id (da list_tag_rules). Interrompe il tagging automatico futuro per quel pattern; gli elementi che già portano il tag lo mantengono (usa remove_tag o delete_tag per disassegnarlo).

Elenca le Smart View di keyword e di pagina definite per una proprietà — ciascuna con view_id, name, type (keyword | page) e i nomi dei tag che raggruppa. I conteggi dei membri per tag arrivano da list_tags.

Crea una Smart View a partire da un set di tag (leggili da list_tags). type è keyword (sui tag di keyword) o page (sui tag di pagina). La vista compare nell'interfaccia SEOcrawl esattamente come una creata in modo nativo e può essere modificata lì.

Elimina una Smart View tramite il suo view_id. Permanente e rimuove la vista anche dall'interfaccia SEOcrawl; i tag sottostanti non vengono toccati. L'id di un normale filtro applicato restituisce not_found.

Elenca i report di SEO Reporting creati per una proprietà — ciascuno con id, name, is_template, is_automate, created_at e owner. Restituisce i report normali per impostazione predefinita; passa templates: true per elencare invece i modelli di report. I report ricorrenti sono esclusi (usa list_report_schedules). Paginato tramite cursore con next_cursor.

Ottieni i metadati di un report (name, is_template, is_automate, owner, created_at, più period e destinatari quando è programmato) e la sua struttura completa di widget — type, titolo, posizione, configurazione e filtri di ogni widget. Restituisce la composizione del report, non i numeri renderizzati (leggili con gli strumenti GSC / GA4).

Genera uno snapshot condivisibile di un report esistente e restituisce il suo URL pubblico (azione di scrittura). Cattura lo stato attuale dei widget del report, deduplicato per hash del contenuto — non accetta un intervallo di date, quindi modifica prima i widget del report se ti serve un altro periodo. Restituisce report_id, snapshot_id e url.

Elenca i report configurati per l'invio ricorrente automatico su una proprietà — ciascuno con id, name, owner, period (week o month) e gli ID utente dei destinatari. Riflette la configurazione di pianificazione salvata (period + destinatari). Paginato tramite cursore con next_cursor.

Recupera una singola URL live on demand (semplice HTTP GET, senza JavaScript) e restituisce i dettagli della risposta — URL finale, codice di stato, catena completa dei redirect, tempo di risposta e dimensione decompressa della pagina — più blocchi opzionali: elementi SEO analizzati (title, meta description, meta robots, canonical, hreflang, intestazioni, tag OG/Twitter, tipi JSON-LD, conteggio parole, conteggio link, immagini senza alt), il contenuto principale come markdown pulito e l'HTML grezzo. I fallimenti di trasporto restituiscono errori strutturati (dns_error, timeout, blocked_url…). Gratuito — non consuma mai crediti MCP; con limite di utilizzo per utente.

Visualizza una griglia di schede KPI a partire dai dati di sintesi — ogni scheda riporta un'etichetta, un valore grezzo, un'unità facoltativa (prefisso $, suffisso % o s per una durata), una variazione periodo su periodo con direzione in aumento/in calo e un raggruppamento facoltativo in sezioni quando ci sono più di quattro schede. Richiamato automaticamente quando uno strumento di sintesi (get_gsc_summary, get_ga4_summary…) restituisce render_with: render-scorecard. Gratis.

Visualizza una tabella interattiva con ordinamento, ricerca e impaginazione lato client a partire da qualsiasi risultato in elenco — keyword principali, pagine principali, maggiori variazioni, prompt, backlink e altro ancora. Le colonne vengono tipizzate dai dati e le celle di tipo array restano come chip. Richiamato automaticamente quando uno strumento di elenco restituisce render_with: render-data-table. Gratis.

Visualizza un grafico a linee interattivo con tooltip al passaggio del mouse e mirino, una legenda attivabile e un doppio asse Y automatico quando due serie usano unità diverse. Alimentato da qualsiasi strumento di cronologia o serie giornaliera (get_page_detail, get_keyword_detail, cronologia delle prestazioni…) che restituisce render_with: render-time-series-chart. Gratis.

Stato in tempo reale del backend MCP per superficie (GSC, GA4, Site Audit, AI Tracker, Attività) e per archivio dati, ciascuno riportato come ok, degraded o down con last_check_at e un sample_error. Gratuito e senza argomenti — interrogalo prima di un workflow in più passaggi così un endpoint rotto è visibile fin da subito.