WP-CLI e MCP: tutti i comandi e gli strumenti
Questa pagina descrive tutto ciò che si può fare in Spark Speed 0.73.2 senza la schermata di amministrazione: i comandi WP-CLI sul server e gli strumenti MCP con cui un assistente AI come Claude o ChatGPT lavora sul suo sito. È destinata ad amministratori e agenzie che lavorano con la riga di comando o con un assistente AI; per la gestione quotidiana non le serve.
In breve
- Tutti i comandi iniziano con wp spark-speed e vengono eseguiti sul server
- mcp token e ai apply esistono solo con una licenza valida; diagnostics rifiuta senza
- MCP richiede una licenza valida e un client autorizzato che opera come amministratore
- start_optimization richiede una dashboard aperta nel browser per il controllo del browser
Stato e cache
Vedere subito a che punto è la cache, svuotarla e verificare che cosa ricevono i visitatori.
wp spark-speed status
- Che cosa fa
- Mostra in cinque righe lo stato della cache: quale plugin gestisce il drop-in della cache (il file con cui WordPress carica presto la cache delle pagine), se WP_CACHE è attivo, quante pagine sono in cache, quanti indirizzi sono in coda e se il worker locale opzionale è raggiungibile. Utile per dare una rapida occhiata senza aprire wp-admin.
- Quando usarlo
- Dopo un aggiornamento, una migrazione o un purge, oppure in uno script di monitoraggio.
- Come verificare l'effetto
- L'output è in inglese:
Drop-in owner,WP_CACHE,Cached pages,Queue pending,Worker.Worker : OFFLINEè normale: il worker è opzionale e non è incluso nello zip; Spark utilizza allora il percorso PHP. - Esempio
wp spark-speed status- Come annullare
- Nulla da annullare: il comando si limita a leggere.
wp spark-speed purge
- Che cosa fa
- Svuota l'intera cache delle pagine. Poi le pagine vengono ricostruite alla visita successiva o dalla costruzione della cache.
- Quando usarlo
- Quando i visitatori vedono una versione obsoleta o dopo una grossa modifica a tema o impostazioni.
- Come verificare l'effetto
- Vede
Page cache purged.Conwp spark-speed statusvedeCached pagesdiminuire. - Esempio
wp spark-speed purge- Attenzione
- Finché la cache non è stata ricostruita, le prime visite sono più lente. La object cache non viene svuotata da questo comando: per quella c'è
flush-object-cache. - Come annullare
- Non si può annullare. Ricostruisca la cache con
wp spark-speed optimize --alle poiwp spark-speed warm.
wp spark-speed flush-object-cache
- Che cosa fa
- Svuota la object cache (l'archivio temporaneo dei risultati del database, ad esempio in Redis, Memcached, APCu o SQLite) che passa dal drop-in object cache di Spark. È volutamente separata dalla cache delle pagine.
- Quando usarlo
- Quando sospetta che nella object cache ci siano dati obsoleti. Spark non svuota da sé la object cache in automatico.
- Requisiti
- Una object cache di Spark funzionante. In caso contrario riceve un avviso.
- Come verificare l'effetto
- Un messaggio di successo, oppure un avviso se non c'era nulla da svuotare.
- Esempio
wp spark-speed flush-object-cache- Attenzione
- Subito dopo lo svuotamento WordPress chiede di nuovo più dati al database.
- Come annullare
- Non serve: la object cache si riempie di nuovo da sola.
wp spark-speed verify-cache
- Che cosa fa
- Recupera una pagina del suo sito come visitatore desktop e come visitatore mobile e dà un giudizio in JSON: quale stato della cache è stato servito e se corrisponde al codice e alle impostazioni attuali.
- Quando usarlo
- Dopo una modifica, per verificare che i visitatori ricevano la nuova versione in cache.
- Requisiti
--pagecon un indirizzo completo di questo sito, senza query string. Senza--pageil comando si interrompe con un errore.- Come verificare l'effetto
- Nel JSON compare
ok. Il codice di uscita è 0 se tutto è corretto e 2 se non lo è, così può usarlo in uno script. - Esempio
wp spark-speed verify-cache --page=https://example.com/product/example/- Come annullare
- Nulla da annullare: il comando si limita a leggere.
Costruzione della cache
Ottimizzare le pagine, smaltire la coda e seguire o riprendere la costruzione della cache. La stessa costruzione la vede nell'area di amministrazione, nella scheda Cache.
wp spark-speed optimize
- Che cosa fa
- Senza opzioni aggiuntive ricostruisce la homepage, ottimizzata e messa in cache per ogni dispositivo. Con
--page=<address>lo fa per una sola pagina. Con--allmette in coda tutte le pagine del sito; il lavoro vero e proprio lo svolge poi conprocessowarm. - Quando usarlo
- Dopo un purge, oppure quando vuole avere subito pronta una pagina importante.
- Requisiti
- Usi
--page, non--url:--urlè già riservato in WP-CLI. - Come verificare l'effetto
- Per ogni dispositivo una riga con il risultato, ad esempio
oko il motivo per cui non è riuscito. Con--allvede quanti indirizzi sono stati messi in coda. - Esempio
wp spark-speed optimize --page=https://example.com/shop/- Attenzione
- Se il freno di emergenza (modalità sicura) è attivo o l'ottimizzazione è disattivata, le pagine vengono solo messe in cache e non ottimizzate.
- Come annullare
- Svuoti la cache di quella pagina o l'intera cache.
wp spark-speed process
- Che cosa fa
- Elabora subito una parte della coda, per impostazione predefinita 20 indirizzi. Usa lo stesso lock dell'elaborazione in background, così non si ostacolano a vicenda.
- Quando usarlo
- Per smaltire a tappe una coda piena, ad esempio dopo
optimize --all. - Requisiti
- Una coda con indirizzi. Il numero si modifica con
--limit=<number>. - Come verificare l'effetto
- Per ogni indirizzo una riga con il risultato per dispositivo e, alla fine,
Batch done. Remaining: N. - Esempio
wp spark-speed process --limit=50- Attenzione
- Appesantisce il server finché è in esecuzione. Se un'altra elaborazione tiene il lock, non succede nulla.
- Come annullare
- Non applicabile.
wp spark-speed warm
- Che cosa fa
- Smaltisce l'intera coda fino a svuotarla, in blocchi da 25 per impostazione predefinita. Se non c'è avanzamento, ne cerca la causa. Se un'altra elaborazione è in corso, lo segnala e si ferma; con
--waitattende fino a 15 minuti il lock. - Quando usarlo
- Sui siti con poche visite, dove WP-Cron non gira da solo abbastanza spesso, oppure dopo un purge completo.
- Requisiti
- Il sito deve poter raggiungere se stesso (loopback), perché la costruzione recupera le sue pagine. La dimensione dei blocchi si modifica con
--batch=<number>. - Come verificare l'effetto
- Per ogni ciclo
remaining: N (cached M)e un riepilogo. Il codice di uscita è 0 se la coda è vuota, 1 se resta del lavoro e 2 se la costruzione è bloccata o si è inceppata. - Esempio
wp spark-speed warm --wait- Attenzione
- Può richiedere molto tempo e appesantisce il server. Un sito in modalità di manutenzione o dietro una protezione anti-bot che risponde 403 fa fallire le pagine.
- Come annullare
- Si interrompe con Ctrl+C. La cache già costruita si può svuotare con
purge.
wp spark-speed warm-status
- Che cosa fa
- Mostra a che punto è la costruzione della cache: lo stato e da quando, da quanto tempo non succede nulla, il motivo, la coda, le pagine in cache rispetto al totale, un'eventuale pausa, gli indirizzi falliti e l'ultimo test. Con
--jsonottiene tutto come JSON. - Quando usarlo
- Quando la costruzione non avanza, oppure in un monitor che controlla il codice di uscita.
- Come verificare l'effetto
- Le righe hanno etichette in olandese (
stand,sinds,wachtrij,gecached,pauze,fails,laatste toets). Il codice di uscita 0 indica stato sano, 1 una causa nota, 2 uno stallo e 3 che lo stato non è determinabile. - Esempio
wp spark-speed warm-status --json- Come annullare
- Nulla da annullare: il comando si limita a leggere.
wp spark-speed warm-hervat
- Che cosa fa
- Verifica una costruzione della cache in pausa con un tentativo reale sul primo indirizzo in coda e la riprende se il sito risponde correttamente. È la versione da riga di comando del pulsante per riprendere la costruzione nella scheda Cache.
- Quando usarlo
- Dopo aver risolto la causa di una pausa, ad esempio un errore di loopback o una protezione anti-bot.
- Requisiti
- Una pausa aperta. Senza pausa segnala
Er stond geen pauze open.. - Come verificare l'effetto
- Se riprende, vede
Hervat.con la coda e il numero di pagine in cache (codice di uscita 0). Se non riesce, un avvisoNiet hervat: <reason>(codice di uscita 1). Verifichi poi conwarm-status. - Esempio
wp spark-speed warm-hervat- Attenzione
- Se il sito continua a dare errori, la pausa resta.
- Come annullare
- Non applicabile.
Negozio, clienti e piano di caricamento
Questi comandi gestiscono funzioni che trova anche nell'area di amministrazione, con la stessa prova preliminare. I sottocomandi sono parole olandesi: aan, uit, proef, legen.
wp spark-speed winkelwagen
- Che cosa fa
- Gestisce la cache per i visitatori con il carrello pieno, la stessa funzione di Cached pages with a filled cart nella card Cart and logged-in customers.
status(predefinito) mostra lo stato e l'ultima prova.proefesegue la prova.aanattiva la funzione euitla disattiva. - Quando usarlo
- Su un negozio WooCommerce dove gli acquirenti con qualcosa nel carrello altrimenti ricevono ogni volta una pagina costruita da zero e lenta.
- Requisiti
- WooCommerce.
aanfunziona solo dopo una prova riuscita, oppure con--bevestigddopo che ha esaminato personalmente una differenza rilevata. - Come verificare l'effetto
- La prova segnala il risultato, il numero di pagine, se lo script del carrello è necessario e quali differenze ci sono. All'attivazione vede
Winkelwagencache aan; de paginacache is geleegd.. - Esempio
wp spark-speed winkelwagen proef- Attenzione
- L'attivazione svuota l'intera cache delle pagine. Se approva con
--bevestigduna differenza per errore, contenuti personali possono finire in pagine condivise. - Come annullare
wp spark-speed winkelwagen uit- Nome tecnico
woo_cart_cache
wp spark-speed klantcache
- Che cosa fa
- Gestisce la cache dedicata ai clienti con accesso effettuato, la stessa funzione di Own cache for logged-in customers nella card Cart and logged-in customers.
status(predefinito) mostra lo stato, il numero di sessioni con una copia propria e se la funzione può essere attivata.aan,uit(disattiva e svuota) elegen(svuota tutte le copie dei clienti). - Quando usarlo
- Quando i clienti con accesso effettuato ricevono a ogni clic una pagina costruita da zero.
- Requisiti
- Se la funzione non può essere attivata su questo sito, rifiuta
aancon il motivo. Solo ruoli cliente, mai amministratori. Una copia ha al massimo 8 ore. - Come verificare l'effetto
- Messaggi come
Klantcache aan.oKlantcache uit en geleegd., e constatusuna riga constand,sessies met eigen kopieenekan aan. - Esempio
wp spark-speed klantcache status- Attenzione
- Ogni sessione con accesso effettuato riceve copie proprie, quindi l'uso del disco cresce con il numero di clienti.
- Come annullare
wp spark-speed klantcache uit- Nome tecnico
klant_cache
wp spark-speed laadplan
- Che cosa fa
- Gestisce il piano di caricamento: i plugin che caricano codice sul front-end ma non modificano la pagina vengono saltati lì, dopo una prova. È la stessa funzione della card Front-end load plan sotto Diagnostics.
kandidatenmostra i plugin con il numero di file e l'ultima prova.proef <plugin>verifica se la pagina resta uguale senza quel plugin.weglaten <plugin>lo salta sul front-end.laden <plugin>lo carica di nuovo.aaneuitattivano o disattivano il piano.statusmostra lo stato. - Quando usarlo
- Quando un plugin carica sul front-end molto codice di cui i visitatori non hanno bisogno.
- Requisiti
weglatenè consentito solo dopo una prova con esitogelijk, oppure con--bevestigddopo che ha esaminato personalmente una differenza. Vale solo per i visitatori anonimi. Il piano è disattivato per impostazione predefinita.- Come verificare l'effetto
- Una riga con
modus,weggelaten op de voorkante il proprietario del mu-plugin (un plugin che WordPress carica sempre per primo). - Esempio
wp spark-speed laadplan proef contact-form-7- Attenzione
- Una pagina uguale non dimostra che un plugin non svolga un lavoro invisibile, come sicurezza, tracciamento lato server o logging. Ometta solo plugin che conosce.
- Come annullare
wp spark-speed laadplan laden <plugin>owp spark-speed laadplan uit.
Importare e analizzare le misurazioni
Per chi misura da sé: importare misurazioni del browser in modo che Spark dia priorità esattamente all'immagine e ai caratteri giusti, e consultare il percorso critico.
wp spark-speed image-hint
- Che cosa fa
- Importa una misurazione da un browser reale che registra quale immagine di una pagina è l'LCP (l'elemento visibile più grande durante il caricamento). Finché la misurazione è valida, la pagina in cache carica con priorità proprio quell'immagine.
- Quando usarlo
- Quando Spark sceglie da sé l'immagine principale sbagliata.
- Requisiti
- Un file JSON di al massimo 16 KB da una scansione dell'amministratore. Gli script di raccolta citati nella card Measured choices non sono inclusi nello zip del plugin.
- Come verificare l'effetto
- In caso di successo
Observation stored; refresh and verify the affected cache variants.. Se l'indirizzo, l'età, le impostazioni o la prova LCP non corrispondono, la misurazione viene rifiutata. Aggiorni poi la pagina interessata e verifichi converify-cache. - Esempio
wp spark-speed image-hint --file=lcp.json- Attenzione
- Il comando non svuota la cache e non modifica le impostazioni. Le misurazioni scadono dopo sei ore e in caso di modifiche a contenuti, media, menu, tema, plugin o impostazioni.
- Come annullare
- Non esiste un comando separato per eliminare una misurazione; dopo la scadenza torna valida la scelta automatica.
wp spark-speed font-hint
- Che cosa fa
- Importa una misurazione dei caratteri locali caricati davvero in modo visibile, così che vengano precaricati solo quelli.
- Quando usarlo
- Quando vengono precaricati troppi caratteri o quelli sbagliati.
- Requisiti
- Un file JSON di al massimo 16 KB. Gli script di raccolta citati nella card Measured choices non sono inclusi nello zip del plugin.
- Come verificare l'effetto
Font observation stored; refresh and verify affected cache variants.oFont observation rejected..- Esempio
wp spark-speed font-hint --file=fonts.json- Attenzione
- Una misurazione obsoleta può precaricare il carattere sbagliato. Le misurazioni scadono dopo sei ore e in caso di modifiche al sito.
- Come annullare
- Nessun comando separato; dopo la scadenza torna valida la scelta automatica.
wp spark-speed font-metrics
- Che cosa fa
- Importa le misure rilevate del carattere di ripiego, così che il testo si sposti meno mentre il web font si carica.
- Quando usarlo
- Quando il testo si sposta visibilmente non appena arriva il web font.
- Requisiti
- Un file JSON di al massimo 16 KB. I valori fuori dall'intervallo consentito vengono rifiutati. Gli script di raccolta citati nella card Measured choices non sono inclusi nello zip del plugin.
- Come verificare l'effetto
Font metrics stored; refresh the affected cache variants and verify the layout.Poi guardi la pagina.- Esempio
wp spark-speed font-metrics --file=metrics.json- Attenzione
- Misure sbagliate possono invece far spostare il testo. Controlli il layout.
- Come annullare
- Nessun comando separato trovato; svuoti la cache delle pagine interessate.
wp spark-speed kritiek-pad
- Che cosa fa
- Mostra che cosa deve caricarsi prima dell'LCP (il percorso critico). Con
--fileanalizza un JSON di Lighthouse (un'esportazione da DevTools o una risposta di PageSpeed) e conserva il risultato per la card What keeps the score from green sotto Diagnostics. Con--pagerecupera la pagina come visitatore mobile e stima in base all'HTML, senza tempi. - Quando usarlo
- Quando vuole sapere che cosa frena il punteggio.
- Requisiti
- Una delle due opzioni. Il file di Lighthouse deve contenere le richieste di rete.
--pagefunziona solo con indirizzi di questo sito. - Come verificare l'effetto
- JSON compatto nel terminale.
- Esempio
wp spark-speed kritiek-pad --file=lighthouse.json- Come annullare
- Non serve: il comando non modifica nient'altro nel sito.
Comandi che richiedono una licenza valida
Spark Speed ha un solo livello di licenza. I comandi mcp token e ai apply esistono solo finché la licenza è valida (o nel periodo di tolleranza di 14 giorni); diagnostics esiste sempre ma rifiuta senza una licenza valida.
wp spark-speed diagnostics
- Che cosa fa
- Fornisce il report diagnostico come JSON (server, PHP, cache, plugin), oppure lo salva in un file con
--save=<path>. È lo stesso report di Download diagnostic report nell'area di amministrazione. - Quando usarlo
- Per il supporto, oppure da dare a un'AI.
- Requisiti
- Una licenza valida. Il comando esiste anche senza licenza, ma in quel caso rifiuta con un messaggio di errore.
- Come verificare l'effetto
- JSON nel terminale, oppure
Saved to <path>. - Esempio
wp spark-speed diagnostics --save=spark-report.json- Attenzione
- Il file contiene dati del server e delle impostazioni. Lo tratti come riservato.
- Come annullare
- Elimini il file.
wp spark-speed mcp token
- Che cosa fa
- Gestisce le chiavi MCP dalla riga di comando.
createcrea una nuova chiave e la mostra una sola volta.listmostra le chiavi senza il segreto.revoke <id>revoca una chiave. Con--labelassegna un nome alla chiave (per impostazione predefinita WP-CLI). È lo stesso di Create key nella card Connect Claude or ChatGPT (MCP). - Quando usarlo
- Quando vuole collegare al sito un programma AI sul suo computer, come Claude Code.
- Requisiti
- Esiste solo finché la licenza è valida. Deve indicare
--user=<admin>per un utente con diritti di amministratore.createrifiuta di scrivere su uno schermo: inoltri l'output direttamente al suo gestore di password o archivio di segreti. Al massimo cinque chiavi. - Come verificare l'effetto
listmostra per ogni chiave un id, un suggerimento (primi e ultimi quattro caratteri), nome, proprietario, momento di creazione e ultimo utilizzo.- Esempio
wp spark-speed mcp token list --user=admin- Attenzione
- Una chiave può fare tutto ciò che possono fare gli strumenti MCP, come l'amministratore a cui appartiene. Una chiave smarrita non si può recuperare, solo revocare. Se il proprietario perde i diritti di amministratore, la chiave smette di funzionare.
- Come annullare
wp spark-speed mcp token revoke <id> --user=admin(l'id, non la chiave stessa).
wp spark-speed ai apply
- Che cosa fa
- Applica una proposta di configurazione di un'AI tramite lo stesso controllo di sicurezza dello strumento MCP
apply_config: le impostazioni vietate e legate al sito vengono rifiutate, al massimo un interruttore a rischio per volta viene attivato e ogni modifica riceve unchange_id. La proposta proviene da--fileo dallo standard input. - Quando usarlo
- Quando ha creato una proposta con un'AI e vuole applicarla in modo controllato senza aprire l'area di amministrazione.
- Requisiti
- Esiste solo finché la licenza è valida.
--user=<admin>con diritti di amministratore. La proposta è un JSON di al massimo 64 KB. - Come verificare l'effetto
- JSON con, tra l'altro,
applied,change_id,changed,rejectedenext_step. Controlli poi il sito su mobile: menu, slider, moduli e carrello. - Esempio
wp spark-speed ai apply --file=proposal.json --json --user=admin- Attenzione
- Un'impostazione a rischio può rompere il front-end. Dopo ogni modifica riuscita la cache viene ricostruita, il che appesantisce brevemente il server.
- Come annullare
- Non esiste un comando WP-CLI per annullare. Usi lo strumento MCP
revert_changecon ilchange_id, oppure ripristini l'impostazione nell'area di amministrazione.
MCP: collegamento e requisiti
Di che cosa ha bisogno prima che un assistente AI possa usare gli strumenti qui sotto.
Collegamento MCP
- Che cosa fa
- MCP (Model Context Protocol) è uno standard con cui un assistente AI come Claude o ChatGPT può lavorare sul suo sito con strumenti predefiniti. Spark Speed ha un proprio indirizzo MCP in WordPress. All'AI fornisce solo gli strumenti elencati qui sotto: misurare, impostare, annullare e svuotare la cache, senza accesso al server.
- Requisiti
- Una licenza valida e un client autorizzato che opera come amministratore. Ci sono tre modi: una chiave propria (tramite Create key o
wp spark-speed mcp token) nell'headerX-Spark-Tokenoppure come Bearer token; una password applicativa di WordPress di un amministratore; oppure il collegamento da Claude.ai o ChatGPT, in cui accede a WordPress e concede il consenso. Senza licenza valida l'indirizzo rifiuta qualsiasi richiesta. - Come verificare l'effetto
- L'indirizzo e le righe per Claude Code e Claude Desktop si trovano nella card Connect Claude or ChatGPT (MCP) nella scheda Optimization. Dopo la prima richiesta, la sua chiave mostra lì un orario di ultimo utilizzo.
- Esempio
claude mcp add --transport http spark-speed https://example.com/wp-json/spark-speed/v1/mcp --header "X-Spark-Token: <key>"- Attenzione
- Per ogni chiave o utente sono consentite al massimo 120 richieste al minuto. Una richiesta proveniente da un browser di un altro dominio viene rifiutata. Un'AI non può mai modificare alcune impostazioni, tra cui il freno di emergenza, l'annullamento automatico e le impostazioni legate a questo server.
- Come annullare
- Revochi una chiave o un collegamento nella stessa card, oppure con
wp spark-speed mcp token revoke.
Strumenti MCP di sola lettura
Questi strumenti non modificano nulla nel suo sito. Un'AI li usa per misurare e per motivare una proposta.
get_optimization_guide
- Che cosa fa
- Fornisce la guida all'ottimizzazione: il metodo di lavoro, che cosa fa ogni impostazione, quali impostazioni sono a rischio e come si verifica. La stessa guida è contenuta nel report diagnostico.
- Quando usarlo
- All'inizio di una conversazione, così che l'AI sappia come funziona Spark Speed.
- Come verificare l'effetto
- Testo semplice, non JSON.
- Esempio
- Richiesta: "Legga prima la guida di Spark Speed."
- Come annullare
- Nulla da annullare: questo strumento si limita a leggere.
get_site_overview
- Che cosa fa
- Fornisce una panoramica: indirizzo del sito, versioni di plugin, WordPress e PHP, la combinazione riconosciuta di builder, WooCommerce e host, la copertura della cache, gli interruttori principali e le ultime modifiche.
- Quando usarlo
- All'inizio di ogni sessione.
- Come verificare l'effetto
- JSON con, tra l'altro, la versione e gli interruttori.
- Esempio
- Richiesta: "Mi dia una panoramica del mio sito in Spark Speed."
- Come annullare
- Nulla da annullare: questo strumento si limita a leggere.
get_optimization_status
- Che cosa fa
- Mostra se l'optimizer integrato (il pulsante Optimize my site) è attivo e a che punto è un ciclo in corso, con un link alla dashboard. Impostazioni e dati del browser questo strumento non li fornisce volutamente.
- Quando usarlo
- Prima e dopo
start_optimization. - Come verificare l'effetto
- JSON con lo stato e un passo successivo. Un ciclo non più in corso non è ancora la prova che tutto sia riuscito.
- Esempio
- Richiesta: "A che punto è l'ottimizzazione?"
- Come annullare
- Nulla da annullare: questo strumento si limita a leggere.
get_config
- Che cosa fa
- Fornisce tutte le impostazioni attuali, più quali impostazioni un'AI non può modificare, quali sono legate a questo sito o server e quali sono a rischio.
- Quando usarlo
- Prima che l'AI proponga una modifica.
- Come verificare l'effetto
- JSON.
- Esempio
- Richiesta: "Quali impostazioni sono attive adesso?"
- Attenzione
- Con questo strumento l'AI vede la sua intera configurazione di Spark Speed.
- Come annullare
- Nulla da annullare: questo strumento si limita a leggere.
get_diagnostics
- Che cosa fa
- Fornisce il report diagnostico completo: server, cache, che cosa si carica nelle pagine e risultati, comprese le decisioni prese in precedenza dall'optimizer. Voluminoso; lo usi quando la panoramica non basta.
- Quando usarlo
- Nella ricerca di una causa, oppure per rileggere le decisioni di Optimize my site.
- Come verificare l'effetto
- JSON.
- Esempio
- Richiesta: "Che cosa ha deciso l'optimizer nell'ultimo ciclo?"
- Attenzione
- Contiene dati del server.
- Come annullare
- Nulla da annullare: questo strumento si limita a leggere.
check_page
- Che cosa fa
- Recupera una pagina del suo sito come visitatore desktop e mobile: stato della cache (HIT o MISS), la versione servita e ciò che l'HTML carica (script, script rinviati, fogli di stile, preload, immagine LCP). Con
measureesegue anche una misurazione tramite Google PageSpeed Insights. - Quando usarlo
- Dopo ogni modifica, per ogni pagina importante.
- Requisiti
- Un indirizzo completo di questo sito senza query string. Per
measure: una chiave PageSpeed configurata e un sito raggiungibile pubblicamente. - Come verificare l'effetto
- JSON con una parte sulla cache, un'analisi dell'HTML ed eventualmente una misurazione.
- Esempio
{"url": "https://example.com/", "measure": true, "strategy": "mobile"}- Attenzione
- Con
measurel'indirizzo pubblico viene inviato a Google. Si può misurare al massimo due volte al minuto per utente. - Come annullare
- Nulla da annullare: questo strumento si limita a leggere.
get_site_findings
- Che cosa fa
- Fornisce i problemi del sito stesso, con nomi di file e costi misurati: errori 404, catene di reindirizzamenti e file pesanti.
- Quando usarlo
- Quando il punteggio resta basso per qualcosa che Spark non può risolvere.
- Come verificare l'effetto
- JSON.
- Esempio
- Richiesta: "Quali problemi ci sono nel mio sito stesso?"
- Come annullare
- Nulla da annullare: questo strumento si limita a leggere.
get_warm_status
- Che cosa fa
- Fornisce lo stato della costruzione della cache: pagine in cache rispetto al totale, se la costruzione procede o è bloccata e gli indirizzi falliti. Gli stessi dati di
wp spark-speed warm-status. - Quando usarlo
- Dopo un purge o una modifica.
- Come verificare l'effetto
- JSON, oppure
available: falsese lo stato non è determinabile. - Esempio
- Richiesta: "La cache è già stata costruita?"
- Come annullare
- Nulla da annullare: questo strumento si limita a leggere.
list_changes
- Che cosa fa
- Fornisce le modifiche eseguite tramite MCP o
ai applyconchange_id, ora, utente, motivo e se sono state annullate, più la cronologia di tutte le modifiche alle impostazioni del sito. - Quando usarlo
- Per cercare un
change_idda usare conrevert_change. - Requisiti
- Facoltativo
limitda 1 a 60 (predefinito 15). - Come verificare l'effetto
- JSON con un elenco delle modifiche e la cronologia.
- Esempio
{"limit": 20}- Come annullare
- Nulla da annullare: questo strumento si limita a leggere.
Strumenti MCP che modificano qualcosa
Questi quattro strumenti modificano il sito. Un buon assistente AI le chiede prima il consenso e procede un passo alla volta.
start_optimization
- Che cosa fa
- Attiva l'optimizer integrato e avvia un ciclo, lo stesso del pulsante Optimize my site nella card Smart optimization. L'optimizer usa le proprie regole e il proprio controllo del browser. Se un ciclo è già in corso, viene riutilizzato.
- Quando usarlo
- Solo dopo il suo consenso esplicito; l'AI deve inviare
confirm: true. - Requisiti
- Un browser con la dashboard di Spark Speed aperta. Il controllo del browser viene eseguito in quella schermata di amministrazione aperta e il ciclo non viene completato se nessuno apre la dashboard. MCP da solo non basta quindi per concludere un ciclo senza browser.
- Come verificare l'effetto
- La risposta contiene
run_ide lo stato. Segua il ciclo conget_optimization_statuse nella dashboard; un avvio riuscito non è la prova che il controllo sia terminato. - Esempio
{"confirm": true}- Attenzione
- L'optimizer può modificare le impostazioni. Nella 0.73.2 l'area di amministrazione non mostra un elenco delle decisioni né un pulsante per annullare un intero ciclo; le decisioni si rileggono nel report diagnostico o tramite
get_diagnostics. - Come annullare
- Ripristini le impostazioni interessate nella scheda Optimization o Cache.
apply_config
- Che cosa fa
- Modifica le impostazioni di Spark Speed tramite lo stesso controllo di sicurezza della proposta AI nell'area di amministrazione. Gli elenchi vengono integrati, a meno che non siano in
replace_lists. Condry_runvede prima che cosa cambierebbe. Ogni modifica reale riceve unchange_ide compare con il motivo nella cronologia; poi la cache viene ricostruita. - Quando usarlo
- Dopo aver misurato con gli strumenti di lettura, un passo alla volta.
- Requisiti
changese unreasondi una frase. Solo impostazioni daget_config, al massimo 40 per volta e al massimo un interruttore a rischio che si attiva per volta. Le impostazioni vietate e legate al sito vengono rifiutate con un motivo.- Come verificare l'effetto
- JSON con
applied,change_id,changed(vecchio e nuovo valore per impostazione) erejected. Controlli poi il sito su mobile: menu, slider, moduli e carrello. - Esempio
{"changes": {"delay_js": true}, "reason": "Reduce main-thread work", "dry_run": true}- Attenzione
- Un'impostazione a rischio può rompere il front-end. La ricostruzione della cache appesantisce il server.
- Come annullare
revert_changecon ilchange_id.
revert_change
- Che cosa fa
- Annulla una modifica precedente di
apply_configoai apply. Vengono ripristinate solo le impostazioni di quella modifica. Se un'impostazione è stata poi modificata di nuovo, da qualcun altro o da un passaggio successivo, resta così com'è e viene segnalato. - Quando usarlo
- Quando una modifica rompe qualcosa o non porta alcun vantaggio.
- Requisiti
- Un
change_id(vedilist_changes). Sono note solo le ultime 30 modifiche eseguite tramite MCP o WP-CLI. - Come verificare l'effetto
- JSON con
reverted,restoredeleft_alone_because_changed_since. Una seconda volta segnala che la modifica era già stata annullata. - Esempio
{"change_id": "mcp-20261010-101500-ab12cd"}- Attenzione
- Le modifiche eseguite nell'area di amministrazione o dall'optimizer non si annullano con questo strumento.
- Come annullare
- Applichi di nuovo la modifica con
apply_config.
purge_cache
- Che cosa fa
- Svuota la cache delle pagine di un indirizzo, oppure dell'intero sito se non indica alcun indirizzo. Per l'intero sito tutto viene rimesso in coda. Compare nella cronologia.
- Quando usarlo
- Quando una pagina mostra una versione obsoleta.
- Requisiti
- L'indirizzo deve appartenere a questo sito.
- Come verificare l'effetto
- La risposta contiene
purgedcon l'indirizzo oppureall. - Esempio
{"url": "https://example.com/shop/"}- Attenzione
- Dopo un purge completo le pagine sono più lente finché la costruzione non è terminata.
- Come annullare
- Non serve: la costruzione della cache riempie di nuovo la cache.
Approfondimenti nella documentazione
Tutte le istruzioni sono nella pagina della documentazione di Spark Speed.
Ha dubbi su un passaggio? Annulli la modifica, controlli il suo sito e ce lo chieda tramite la pagina dei contatti.
Non ha ancora Spark Speed? Scopra che cosa fa e quanto costa.
Domande frequenti
No. Tramite MCP un'AI può misurare, modificare le impostazioni e avviare un ciclo di ottimizzazione, ma il controllo del browser di quel ciclo viene eseguito nella dashboard di Spark Speed. Questa deve restare aperta in un browser finché il ciclo è in corso.
mcp token e ai apply esistono solo con una licenza valida, e diagnostics rifiuta senza. Gli altri comandi ci sono, ma la gestione e le nuove ottimizzazioni richiedono una licenza valida o il periodo di tolleranza di 14 giorni.
Cerchi il change_id con list_changes e usi revert_change. Vengono ripristinate solo le impostazioni di quella modifica. Le modifiche del pulsante Optimize my site, nella 0.73.2, si annullano ripristinando personalmente le impostazioni.
Una chiave viene mostrata una sola volta e non si può recuperare. La revochi nella card Connect Claude or ChatGPT (MCP) oppure con wp spark-speed mcp token revoke, e ne crei una nuova.
Sono costruiti così nella 0.73.2: winkelwagen, klantcache, laadplan e warm-hervat usano parole olandesi come aan, uit, proef e legen. Anche una parte dell'output è in olandese.