Codex legge già il tuo codice. Dagli anche i tuoi dati di ricerca. Il server MCP di GSC Wizard è un endpoint Model Context Protocol in hosting che dà a Codex i tuoi dati di Search Console, Bing Webmaster e GA4, così l'agente che modifica i tuoi template può anche vedere quali pagine perdono clic, per quali query si posiziona una pagina e se un URL è indicizzato.
Un solo comando, nessun server locale, nessun progetto Google Cloud. Funziona nella CLI di Codex, nell'estensione per IDE e nell'app desktop, che leggono tutte lo stesso ~/.codex/config.toml.
codex mcp add gsc-wizard --url https://mcp.gscwizard.com/mcp
codex mcp login gsc-wizardhttps://mcp.gscwizard.com/mcp
Streamable HTTP
OAuth (codex mcp login) or Bearer key
112 · GSC, Bing, GA4
Prova gratuita, senza carta di credito. L'accesso MCP è incluso in ogni piano.
La maggior parte degli interventi SEO finisce come modifica al codice: un template del title, un tag canonical, una mappa di redirect, un generatore di sitemap, un blocco di link interni. In un assistente di chat analizzi i dati e poi copi la conclusione nel tuo editor. In Codex l'analisi e la modifica avvengono nella stessa sessione, sullo stesso repository.
Codex può controllare per quali query una pagina ottiene clic prima di riscriverne il title, invece di tirare a indovinare le keyword.
Decay, cannibalizzazione, curve del CTR e punteggio delle opportunità sono calcolati dal server. Codex riceve le conclusioni e le righe che le sostengono, non un export grezzo su cui fare calcoli.
La maggior parte delle letture proviene dal warehouse di GSC Wizard con i tuoi dati archiviati, che va oltre la finestra di 16 mesi di Google ed evita il campionamento delle righe dell'API.
Crea un account GSC Wizard, accedi con Google e scegli le proprietà di Search Console che Codex deve vedere. Codex può leggere solo le proprietà collegate qui.
Da qualsiasi terminale:
codex mcp add gsc-wizard --url https://mcp.gscwizard.com/mcpQuesto scrive una tabella [mcp_servers.gsc-wizard] in ~/.codex/config.toml. Puoi anche scrivere il blocco a mano.
Esegui il login OAuth, che apre il browser sulla schermata di consenso di GSC Wizard. Poi avvia Codex e digita /mcp per verificare che i tool siano elencati.
codex mcp login gsc-wizard
codex
> /mcp
> List my Search Console sites and show clicks for the last 28 days.Se tieni la configurazione di Codex in un repository di dotfile, o vuoi limitare ciò che l'agente può raggiungere, modifica direttamente ~/.codex/config.toml.
[mcp_servers.gsc-wizard]
url = "https://mcp.gscwizard.com/mcp"bearer_token_env_var indica il nome della variabile; Codex ne invia il valore come Authorization: Bearer. La chiave in sé non sta mai nel file di configurazione.
[mcp_servers.gsc-wizard]
url = "https://mcp.gscwizard.com/mcp"
bearer_token_env_var = "GSCW_API_KEY"export GSCW_API_KEY="gscw_live_..."Ogni definizione di tool costa contesto a ogni turno. Per un coding agent che deve solo controllare rendimento e indicizzazione, una allowlist mantiene la sessione leggera e restringe ciò che una prompt injection nel contenuto recuperato potrebbe raggiungere.
[mcp_servers.gsc-wizard]
url = "https://mcp.gscwizard.com/mcp"
bearer_token_env_var = "GSCW_API_KEY"
enabled_tools = [
"list_sites",
"get_site_summary",
"query_top_pages",
"get_page_performance",
"get_query_performance",
"find_decaying_content",
"analyze_cannibalization",
"inspect_url",
"list_sitemaps"
]
tool_timeout_sec = 120I tool di analisi su intervalli di date lunghi possono richiedere più tempo di una semplice consultazione, quindi un tool_timeout_sec generoso evita che Codex abbandoni una chiamata a cui il server sta ancora rispondendo. Imposta enabled = false per disattivare il server senza eliminare il blocco.
codex mcp loginIdeale per il lavoro interattivo sul tuo computer. Codex scopre l'authorization server, si registra e apre l'accesso nel browser. Nessuna chiave da copiare, conservare o ruotare. Il permesso copre i tool di lettura e scrittura e puoi revocarlo dal tuo account GSC Wizard.
gscw_live_ con scope limitatoIdeale per codex exec, pipeline CI, attività nel cloud e tutto ciò che non ha un browser. Creala in Account → Chiavi API in GSC Wizard; viene mostrata una sola volta e archiviata solo come hash.
Usa una chiave con scope di sola lettura per gli agenti. Una chiave di lettura non può chiamare nessuno dei 32 tool di modifica, come submit_sitemap, submit_indexnow_urls o add_site. Il controllo gira sul server prima che il tool venga eseguito, quindi un agente non può essere convinto a scavalcarlo. Le credenziali Google non arrivano mai a Codex: le conserva il server e Codex possiede solo una credenziale GSC Wizard.
I prompt utili combinano i dati di ricerca con il repository che Codex ha aperto.
"Trova le pagine di example.com posizionate dalla 4ª alla 15ª posizione con un CTR sotto la curva. Per ciascuna, trova in questo repository il template o il file di contenuto che ne imposta il title e proponi un title che includa la sua query principale."
"Confronta gli URL che questo branch rimuove o rinomina con le prime 500 pagine per clic negli ultimi 90 giorni. Elenca ogni URL con traffico che non ha un redirect in redirects.json."
"Esegui un'analisi del decay per la sezione /blog/, poi apri in content/ i cinque post che perdono più terreno e prepara un piano di aggiornamento per ciascuno, partendo dalle query che hanno perso."
"Trova le query per cui competono due o più delle nostre pagine. Per ogni coppia, controlla i link interni e i canonical nei template e suggerisci quale pagina deve prevalere."
"Ispeziona i dieci URL aggiunti nell'ultimo commit e dimmi quali non sono ancora indicizzati, con il motivo indicato da Google."
Codex legge AGENTS.md all'inizio di una sessione. Poche righe lì dentro evitano di ripetere la proprietà e le regole della casa in ogni prompt.
## Search data
- Search Console property: sc-domain:example.com (use the gsc-wizard MCP tools).
- Before changing a title, meta description or URL, look up the page's
current queries with get_page_performance and keep its top query in the title.
- Treat the last 3 days as incomplete; report settledThrough with any numbers.
- Never call submit_sitemap or submit_indexnow_urls without asking first.128 tool sono disponibili per ogni account. Ognuno dichiara annotazioni MCP come readOnlyHint e destructiveHint, così Codex sa distinguere le letture dalle scritture quando decide se chiedere un'approvazione.
| Gruppo | Tool rappresentativi | Scope |
|---|---|---|
| Analisi della ricerca | query_search_analytics, query_top_queries, query_top_pages, get_page_performance | lettura |
| Analisi | find_decaying_content, analyze_cannibalization, analyze_ctr_curve, score_opportunities | lettura |
| Rilevamento | detect_anomalies, detect_change_points, get_ranking_changes, forecast_traffic | lettura |
| Indicizzazione e on-page | inspect_url, bulk_inspect_urls, list_sitemaps, audit_onpage_seo | lettura |
| Altre fonti | Bing Webmaster, GA4 (incluso il traffico di referral da LLM), Core Web Vitals | lettura |
| Modifiche | submit_sitemap, submit_indexnow_urls, create_annotation, create_topic_cluster | scrittura |
Le date sono opzionali su ogni tool: un intervallo omesso usa come valore predefinito gli ultimi 28 giorni completi, quindi Codex non deve mai conoscere la data di oggi. I tool con limite di righe restituiscono un blocco di paginazione che indica se esistono altre righe, così l'agente non scambia un elenco tagliato per uno completo. Il catalogo completo con gli argomenti è su mcp.gscwizard.com e i dettagli del protocollo sono nel riferimento del server.
Esegui codex mcp list per verificare che la voce esista e controlla che il blocco in ~/.codex/config.toml sia una voce url e non una voce command. Riavvia Codex dopo aver modificato il file: legge la configurazione all'avvio.
Con una chiave: la variabile indicata in bearer_token_env_var deve essere esportata nella shell che ha avviato Codex e deve contenere l'intera chiave gscw_live_. Con OAuth: riesegui codex mcp login gsc-wizard. In ogni caso l'account deve avere una prova o un abbonamento attivo e almeno una proprietà di Search Console collegata.
È lo scope di sola lettura che fa il suo lavoro. Se vuoi davvero che Codex invii sitemap o URL a IndexNow, crea una chiave con scope di scrittura oppure usa il login OAuth, e tieni quella credenziale fuori dalle esecuzioni senza supervisione.
Aumenta tool_timeout_sec per il server e restringi la richiesta: un filtro per percorso o un intervallo di date più breve risponde più in fretta di una query su tutto il sito e su sedici mesi.
Controlla settledThrough e dataSource nella risposta. L'intervallo predefinito termina sull'ultimo giorno completo, mentre l'interfaccia include gli ultimi giorni parziali.
Sì. Codex supporta i server MCP Streamable HTTP configurati con un url in ~/.codex/config.toml o aggiunti con codex mcp add --url. Il server di GSC Wizard si trova su https://mcp.gscwizard.com/mcp, quindi non c'è nulla da installare o eseguire in locale.
Per l'uso interattivo, codex mcp login esegue il flusso OAuth nel browser e non richiede di gestire chiavi. Per codex exec, i job CI e le altre esecuzioni senza supervisione, usa una chiave API gscw_live_ con scope di sola lettura, salvata in una variabile d'ambiente e referenziata con bearer_token_env_var, così il segreto non finisce mai in config.toml.
Sì. Leggono lo stesso ~/.codex/config.toml, quindi aggiungere gsc-wizard una volta sola lo rende disponibile nel terminale, nell'estensione per IDE e nell'app desktop.
Solo con una credenziale con scope di scrittura. Una chiave API con scope di sola lettura non può chiamare nessuno dei 32 tool di modifica (come submit_sitemap o submit_indexnow_urls); il controllo gira sul server prima che il tool venga eseguito. Puoi anche restringere l'elenco dei tool lato client con enabled_tools in config.toml.
128 tool sono disponibili per ogni account e coprono rendimento di Search Console, analisi, indicizzazione, Bing Webmaster, Yandex Webmaster, GA4 e Google Merchant Center. Inviarli tutti costa contesto a ogni turno, quindi la maggior parte delle configurazioni di Codex elenca in enabled_tools solo i tool che servono per un'attività.
L'accesso MCP è incluso nei piani GSC Wizard e nella prova gratuita, che non richiede carta di credito. L'uso di Codex viene fatturato da OpenAI come di consueto. Vedi i prezzi.
La panoramica del prodotto: cosa fa il server con ogni client MCP.
Trasporto, discovery OAuth, scope, contratto di risposta e rate limit.
Gli stessi dati in ChatGPT, tramite l'app o un connettore in modalità sviluppatore.
Claude Code, Cursor, VS Code, Windsurf, Gemini e Grok.
Gli stessi dati nell'app Gemini, in Antigravity CLI, in Gemini Enterprise o nella Gemini API.
Un esempio concreto di agente autonomo costruito su questo server più un MCP di crawler.
La parte GA4 dello stesso server: sessioni, eventi chiave, ecommerce e traffico da LLM.
La parte Yandex dello stesso server: indice di qualità del sito, query e storico di indicizzazione.
La parte shopping dello stesso server: schede senza costi, problemi dei prodotti, prezzi e audit del feed.
Collega una proprietà, esegui un comando e lascia che l'agente che modifica il tuo sito veda come va nella ricerca.
Workflow pratici per GSC e GA4, aggiornamenti del prodotto ed esperimenti SEO. Niente spam, puoi annullare l'iscrizione quando vuoi.