WP-CLI e MCP: todos os comandos e ferramentas
Esta página descreve tudo o que pode fazer no Spark Speed 0.73.2 sem um ecrã de administração: os comandos WP-CLI no servidor e as ferramentas MCP com que um assistente de IA, como o Claude ou o ChatGPT, trabalha com o seu site. Destina-se a administradores e agências que trabalham com a linha de comandos ou com um assistente de IA; para a gestão diária, não precisa disto.
Em resumo
- Todos os comandos começam por wp spark-speed e correm no servidor
- mcp token e ai apply só existem com uma licença válida; diagnostics recusa sem ela
- O MCP exige uma licença válida e um cliente autorizado que atue como administrador
- start_optimization precisa de um painel aberto no navegador para a verificação no navegador
Estado e cache
Ver rapidamente como está a cache, esvaziá-la e verificar o que os visitantes recebem.
wp spark-speed status
- O que faz
- Mostra em cinco linhas o estado da cache: que plugin gere o drop-in de cache (o ficheiro que o WordPress carrega cedo para a cache de página), se o WP_CACHE está ativo, quantas páginas estão em cache, quantos endereços estão na fila e se o worker local opcional está acessível. Útil para uma vista rápida sem abrir o wp-admin.
- Quando usar
- Após uma atualização, uma migração ou uma purga, ou num script de monitorização.
- Como verificar o efeito
- A saída está em inglês:
Drop-in owner,WP_CACHE,Cached pages,Queue pending,Worker.Worker : OFFLINEé normal: o worker é opcional e não está incluído no zip; o Spark usa então o caminho PHP. - Exemplo
wp spark-speed status- Como reverter
- Nada a desfazer: o comando apenas lê.
wp spark-speed purge
- O que faz
- Esvazia toda a cache de página. Depois, as páginas são reconstruídas na visita seguinte ou pela construção da cache.
- Quando usar
- Quando os visitantes veem uma versão desatualizada ou após uma grande alteração ao tema ou às definições.
- Como verificar o efeito
- Vê
Page cache purged.Comwp spark-speed statusvêCached pagesdiminuir. - Exemplo
wp spark-speed purge- Atenção
- Até a cache ser reconstruída, as primeiras visitas são mais lentas. Isto não esvazia a cache de objetos; para isso existe
flush-object-cache. - Como reverter
- Não pode ser desfeito. Reconstrua a cache com
wp spark-speed optimize --alle depoiswp spark-speed warm.
wp spark-speed flush-object-cache
- O que faz
- Esvazia a cache de objetos (o armazenamento temporário de resultados da base de dados, por exemplo em Redis, Memcached, APCu ou SQLite) que passa pelo drop-in de cache de objetos do Spark. Isto é deliberadamente independente da cache de página.
- Quando usar
- Quando suspeita de dados desatualizados na cache de objetos. O Spark não esvazia a cache de objetos automaticamente.
- Requisitos
- Uma cache de objetos do Spark em funcionamento. Caso contrário, recebe um aviso.
- Como verificar o efeito
- Uma mensagem de sucesso, ou um aviso se não havia nada para esvaziar.
- Exemplo
wp spark-speed flush-object-cache- Atenção
- Logo após esvaziar, o WordPress volta a pedir mais à base de dados.
- Como reverter
- Desnecessário: a cache de objetos volta a encher-se sozinha.
wp spark-speed verify-cache
- O que faz
- Obtém uma página do seu próprio site como visitante de desktop e como visitante móvel e devolve um veredicto em JSON: que estado de cache foi servido e se corresponde ao código e às definições atuais.
- Quando usar
- Após uma alteração, para verificar que os visitantes recebem a nova versão em cache.
- Requisitos
--pagecom um endereço completo deste site, sem query string. Sem--pageo comando termina com um erro.- Como verificar o efeito
- O JSON contém
ok. O código de saída é 0 se tudo corresponder e 2 se não corresponder, para poder usá-lo num script. - Exemplo
wp spark-speed verify-cache --page=https://example.com/product/example/- Como reverter
- Nada a desfazer: o comando apenas lê.
Construção da cache
Otimizar páginas, processar a fila e acompanhar ou retomar a construção da cache. A mesma construção vê no separador Cache da administração.
wp spark-speed optimize
- O que faz
- Sem opções adicionais, reconstrói a página inicial, otimizada e colocada em cache por dispositivo. Com
--page=<address>faz isso para uma única página. Com--allcoloca todas as páginas do site na fila; o trabalho real faz-se depois comprocessouwarm. - Quando usar
- Após uma purga, ou quando quer ter uma página importante pronta de imediato.
- Requisitos
- Use
--page, não--url:--urljá está reservado no WP-CLI. - Como verificar o efeito
- Uma linha por dispositivo com o resultado, por exemplo
okou o motivo pelo qual não funcionou. Com--allvê quantos endereços entraram na fila. - Exemplo
wp spark-speed optimize --page=https://example.com/shop/- Atenção
- Se o travão de emergência (modo seguro) estiver ativo ou a otimização estiver desativada, as páginas são apenas colocadas em cache e não otimizadas.
- Como reverter
- Esvazie a cache dessa página ou toda a cache.
wp spark-speed process
- O que faz
- Processa agora uma parte da fila, por predefinição 20 endereços. Usa o mesmo bloqueio que o processamento em segundo plano, para que não se atrapalhem.
- Quando usar
- Para despachar por etapas uma fila cheia, por exemplo depois de
optimize --all. - Requisitos
- Uma fila com endereços. Ajuste o número com
--limit=<number>. - Como verificar o efeito
- Uma linha por endereço com o resultado por dispositivo e, no fim,
Batch done. Remaining: N. - Exemplo
wp spark-speed process --limit=50- Atenção
- Sobrecarrega o servidor enquanto decorre. Se outro processamento mantiver o bloqueio, nada acontece.
- Como reverter
- Não aplicável.
wp spark-speed warm
- O que faz
- Processa toda a fila até ficar vazia, em lotes de 25 por predefinição. Se não houver progresso, descobre porquê. Se outro processamento estiver em curso, indica-o e para; com
--waitespera até 15 minutos pelo bloqueio. - Quando usar
- Em sites com pouco tráfego, onde o WP-Cron não corre sozinho com a frequência suficiente, ou após uma purga completa.
- Requisitos
- O site tem de conseguir aceder a si próprio (loopback), porque a construção vai buscar as suas próprias páginas. Pode alterar o tamanho do lote com
--batch=<number>. - Como verificar o efeito
- Por ronda
remaining: N (cached M)e um resumo. O código de saída é 0 se a fila estiver vazia, 1 se ainda houver trabalho e 2 se a construção estiver bloqueada ou encravada. - Exemplo
wp spark-speed warm --wait- Atenção
- Pode demorar muito e sobrecarrega o servidor. Um site em modo de manutenção ou atrás de uma proteção contra bots que devolve 403 faz as páginas falharem.
- Como reverter
- Pare com Ctrl+C. A cache já construída pode ser esvaziada com
purge.
wp spark-speed warm-status
- O que faz
- Mostra como está a construção da cache: o estado e desde quando, há quanto tempo nada aconteceu, o motivo, a fila, as páginas em cache face ao total, uma eventual pausa, os endereços falhados e o último teste. Com
--jsonobtém tudo em JSON. - Quando usar
- Quando a construção não avança, ou num monitor que vigia o código de saída.
- Como verificar o efeito
- As linhas têm etiquetas em neerlandês (
stand,sinds,wachtrij,gecached,pauze,fails,laatste toets). Código de saída 0 é saudável, 1 é uma causa conhecida, 2 é encravado e 3 significa que o estado não pode ser determinado. - Exemplo
wp spark-speed warm-status --json- Como reverter
- Nada a desfazer: o comando apenas lê.
wp spark-speed warm-hervat
- O que faz
- Testa uma construção de cache em pausa com uma tentativa real no primeiro endereço da fila e retoma a construção se o site responder bem. É a versão em linha de comandos do botão que retoma a construção no separador Cache.
- Quando usar
- Depois de resolver a causa de uma pausa, por exemplo um erro de loopback ou uma proteção contra bots.
- Requisitos
- Uma pausa em aberto. Sem pausa, indica
Er stond geen pauze open.. - Como verificar o efeito
- Se retomar, vê
Hervat.com a fila e o número de páginas em cache (código de saída 0). Se não funcionar, vê um avisoNiet hervat: <reason>(código de saída 1). Depois, verifique comwarm-status. - Exemplo
wp spark-speed warm-hervat- Atenção
- Se o site continuar a dar erros, a pausa mantém-se.
- Como reverter
- Não aplicável.
Loja, clientes e plano de carregamento
Estes comandos controlam funcionalidades que também encontra na administração, com o mesmo teste prévio. Os subcomandos são palavras neerlandesas: aan, uit, proef, legen.
wp spark-speed winkelwagen
- O que faz
- Controla a cache para visitantes com o carrinho cheio, a mesma funcionalidade que Cached pages with a filled cart no cartão Cart and logged-in customers.
status(por predefinição) mostra o estado e o último teste.proefexecuta o teste.aanativa a funcionalidade euitdesativa-a. - Quando usar
- Numa loja WooCommerce onde os compradores com algo no carrinho receberiam sempre uma página totalmente construída e lenta.
- Requisitos
- WooCommerce.
aansó funciona após um teste bem-sucedido, ou com--bevestigddepois de ter analisado por si uma diferença encontrada. - Como verificar o efeito
- O teste indica o resultado, o número de páginas, se o script do carrinho é necessário e que diferenças existem. Ao ativar, vê
Winkelwagencache aan; de paginacache is geleegd.. - Exemplo
wp spark-speed winkelwagen proef- Atenção
- Ativar esvazia toda a cache de página. Se aprovar indevidamente uma diferença com
--bevestigd, pode ficar conteúdo pessoal em páginas partilhadas. - Como reverter
wp spark-speed winkelwagen uit- Nome técnico
woo_cart_cache
wp spark-speed klantcache
- O que faz
- Controla a cache própria para clientes com sessão iniciada, a mesma funcionalidade que Own cache for logged-in customers no cartão Cart and logged-in customers.
status(por predefinição) mostra o estado, o número de sessões com cópia própria e se a funcionalidade pode ser ativada.aan,uit(desativa e esvazia) elegen(esvazia todas as cópias de clientes). - Quando usar
- Quando os clientes com sessão iniciada recebem uma página totalmente construída a cada clique.
- Requisitos
- Se a funcionalidade não puder ser ativada neste site,
aanrecusa com o motivo. Apenas funções de cliente, nunca administradores. Uma cópia tem, no máximo, 8 horas. - Como verificar o efeito
- Mensagens como
Klantcache aan.ouKlantcache uit en geleegd., e comstatusuma linha comstand,sessies met eigen kopieenekan aan. - Exemplo
wp spark-speed klantcache status- Atenção
- Cada sessão de cliente com sessão iniciada recebe cópias próprias, pelo que a utilização do disco aumenta com o número de clientes.
- Como reverter
wp spark-speed klantcache uit- Nome técnico
klant_cache
wp spark-speed laadplan
- O que faz
- Controla o plano de carregamento: os plugins que carregam código no front-end mas não alteram a página são ignorados aí, após prova. É a mesma funcionalidade que o cartão Front-end load plan em Diagnostics.
kandidatenmostra os plugins com o número de ficheiros e o último teste.proef <plugin>testa se a página se mantém igual sem esse plugin.weglaten <plugin>ignora-o no front-end.laden <plugin>volta a carregá-lo.aaneuitativam ou desativam o plano.statusmostra o estado. - Quando usar
- Quando um plugin carrega muito código no front-end de que os seus visitantes não precisam.
- Requisitos
weglatensó é permitido após um teste com o resultadogelijk, ou com--bevestigddepois de analisar por si uma diferença. Aplica-se apenas a visitantes anónimos. O plano está desativado por predefinição.- Como verificar o efeito
- Uma linha com
modus,weggelaten op de voorkante o proprietário do mu-plugin (um plugin que o WordPress carrega sempre em primeiro lugar). - Exemplo
wp spark-speed laadplan proef contact-form-7- Atenção
- Uma página igual não prova que um plugin não faz trabalho invisível, como segurança, rastreamento do lado do servidor ou registo. Omita apenas plugins que conhece.
- Como reverter
wp spark-speed laadplan laden <plugin>ouwp spark-speed laadplan uit.
Importar e analisar medições
Para quem mede por si: importar medições do navegador para que o Spark dê prioridade à imagem e aos tipos de letra certos, e ver o caminho crítico.
wp spark-speed image-hint
- O que faz
- Importa uma medição de um navegador real que regista que imagem de uma página é o LCP (o maior elemento visível ao carregar). Enquanto a medição for válida, a página em cache carrega exatamente essa imagem com prioridade.
- Quando usar
- Quando o próprio Spark escolhe a imagem principal errada.
- Requisitos
- Um ficheiro JSON de no máximo 16 KB de uma análise de administrador. Os scripts de recolha referidos no cartão Measured choices não estão incluídos no zip do plugin.
- Como verificar o efeito
- Em caso de sucesso,
Observation stored; refresh and verify the affected cache variants.. Se o endereço, a idade, as definições ou a prova do LCP não estiverem corretos, a medição é rejeitada. Depois, atualize a página em causa e verifique comverify-cache. - Exemplo
wp spark-speed image-hint --file=lcp.json- Atenção
- O comando não esvazia a cache nem altera definições. As medições expiram após seis horas e em caso de alterações a conteúdo, multimédia, menu, tema, plugins ou definições.
- Como reverter
- Não existe um comando separado para remover uma medição; depois de expirar, volta a aplicar-se a escolha automática.
wp spark-speed font-hint
- O que faz
- Importa uma medição dos tipos de letra locais que são realmente carregados de forma visível, para que apenas esses sejam pré-carregados.
- Quando usar
- Quando são pré-carregados demasiados tipos de letra, ou os errados.
- Requisitos
- Um ficheiro JSON de no máximo 16 KB. Os scripts de recolha referidos no cartão Measured choices não estão incluídos no zip do plugin.
- Como verificar o efeito
Font observation stored; refresh and verify affected cache variants.ouFont observation rejected..- Exemplo
wp spark-speed font-hint --file=fonts.json- Atenção
- Uma medição desatualizada pode pré-carregar o tipo de letra errado. As medições expiram após seis horas e em caso de alterações ao site.
- Como reverter
- Não existe um comando separado; depois de expirar, volta a aplicar-se a escolha automática.
wp spark-speed font-metrics
- O que faz
- Importa medidas do tipo de letra de substituição, para que o texto se desloque menos enquanto o webfont carrega.
- Quando usar
- Quando o texto se desloca visivelmente assim que o webfont chega.
- Requisitos
- Um ficheiro JSON de no máximo 16 KB. Os valores fora do intervalo permitido são rejeitados. Os scripts de recolha referidos no cartão Measured choices não estão incluídos no zip do plugin.
- Como verificar o efeito
Font metrics stored; refresh the affected cache variants and verify the layout.Verifique depois a página.- Exemplo
wp spark-speed font-metrics --file=metrics.json- Atenção
- Medidas erradas podem, pelo contrário, fazer o texto deslocar-se. Verifique a formatação.
- Como reverter
- Não foi encontrado um comando separado; esvazie a cache das páginas em causa.
wp spark-speed kritiek-pad
- O que faz
- Mostra o que tem de carregar antes do LCP (o caminho crítico). Com
--fileanalisa um JSON do Lighthouse (uma exportação do DevTools ou uma resposta do PageSpeed) e guarda o resultado para o cartão What keeps the score from green em Diagnostics. Com--pageobtém a página como visitante móvel e faz uma estimativa com base no HTML, sem tempos. - Quando usar
- Quando quer saber o que trava a pontuação.
- Requisitos
- Uma das duas opções. O ficheiro do Lighthouse tem de conter os pedidos de rede.
--pagesó funciona com endereços deste site. - Como verificar o efeito
- JSON compacto no terminal.
- Exemplo
wp spark-speed kritiek-pad --file=lighthouse.json- Como reverter
- Desnecessário: o comando não altera mais nada no site.
Comandos que exigem uma licença válida
O Spark Speed tem um único nível de licença. Os comandos mcp token e ai apply só existem enquanto a licença for válida (ou no período de tolerância de 14 dias); diagnostics existe sempre, mas recusa sem licença válida.
wp spark-speed diagnostics
- O que faz
- Devolve o relatório de diagnóstico em JSON (servidor, PHP, cache, plugins), ou guarda-o num ficheiro com
--save=<path>. É o mesmo relatório que Download diagnostic report na administração. - Quando usar
- Para suporte, ou para dar a uma IA.
- Requisitos
- Uma licença válida. O comando também existe sem licença, mas recusa então com uma mensagem de erro.
- Como verificar o efeito
- JSON no terminal, ou
Saved to <path>. - Exemplo
wp spark-speed diagnostics --save=spark-report.json- Atenção
- O ficheiro contém dados do servidor e das definições. Trate-o como confidencial.
- Como reverter
- Elimine o ficheiro.
wp spark-speed mcp token
- O que faz
- Gere as chaves MCP a partir da linha de comandos.
createcria uma nova chave e mostra-a uma única vez.listmostra as chaves sem o segredo.revoke <id>revoga uma chave. Com--labeldá um nome à chave (por predefinição, WP-CLI). É o mesmo que Create key no cartão Connect Claude or ChatGPT (MCP). - Quando usar
- Quando quer ligar ao site um programa de IA no seu próprio computador, como o Claude Code.
- Requisitos
- Existe apenas enquanto a licença for válida. Tem de passar
--user=<admin>de um utilizador com direitos de administrador.createrecusa-se a escrever num ecrã: envie o resultado diretamente para o seu cofre de palavras-passe ou armazenamento de segredos. No máximo, cinco chaves. - Como verificar o efeito
listmostra, por chave, um id, uma dica (os primeiros e os últimos quatro caracteres), o nome, o proprietário, o momento de criação e a última utilização.- Exemplo
wp spark-speed mcp token list --user=admin- Atenção
- Uma chave pode fazer tudo o que as ferramentas MCP podem, como o administrador a quem pertence. Uma chave perdida não pode ser recuperada, apenas revogada. Se o proprietário perder os direitos de administrador, a chave deixa de funcionar.
- Como reverter
wp spark-speed mcp token revoke <id> --user=admin(o id, não a própria chave).
wp spark-speed ai apply
- O que faz
- Aplica uma proposta de configuração de uma IA através da mesma porta de segurança que a ferramenta MCP
apply_config: as definições proibidas e específicas do site são recusadas, é ativado no máximo um interruptor arriscado de cada vez e cada alteração recebe umchange_id. A proposta vem de--fileou da entrada padrão. - Quando usar
- Quando criou uma proposta com uma IA e quer aplicá-la de forma controlada sem abrir a administração.
- Requisitos
- Existe apenas enquanto a licença for válida.
--user=<admin>com direitos de administrador. A proposta é JSON com no máximo 64 KB. - Como verificar o efeito
- JSON com, entre outros,
applied,change_id,changed,rejectedenext_step. Verifique depois o site em móvel: menu, sliders, formulários e carrinho. - Exemplo
wp spark-speed ai apply --file=proposal.json --json --user=admin- Atenção
- Uma definição arriscada pode estragar o front-end. Após cada alteração bem-sucedida, a cache é reconstruída, o que sobrecarrega o servidor por momentos.
- Como reverter
- Não existe um comando WP-CLI para reverter. Use a ferramenta MCP
revert_changecom ochange_id, ou reponha a definição na administração.
MCP: ligação e requisitos
O que precisa antes de um assistente de IA poder usar as ferramentas abaixo.
Ligação MCP
- O que faz
- O MCP (Model Context Protocol) é uma norma que permite a um assistente de IA, como o Claude ou o ChatGPT, trabalhar com o seu site através de ferramentas fixas. O Spark Speed tem o seu próprio endereço MCP no WordPress. Só dá à IA as ferramentas indicadas abaixo: medir, definir definições, reverter e esvaziar a cache, sem acesso ao servidor.
- Requisitos
- Uma licença válida e um cliente autorizado que atue como administrador. Pode ser feito de três formas: uma chave própria (através de Create key ou
wp spark-speed mcp token) no cabeçalhoX-Spark-Tokenou como token Bearer; uma palavra-passe de aplicação do WordPress de um administrador; ou a ligação a partir do Claude.ai ou do ChatGPT, em que inicia sessão no WordPress e dá autorização. Sem licença válida, o endereço recusa qualquer pedido. - Como verificar o efeito
- O endereço e as linhas para o Claude Code e o Claude Desktop estão no cartão Connect Claude or ChatGPT (MCP) no separador Optimization. Após o primeiro pedido, a sua chave mostra aí a hora da última utilização.
- Exemplo
claude mcp add --transport http spark-speed https://example.com/wp-json/spark-speed/v1/mcp --header "X-Spark-Token: <key>"- Atenção
- São permitidos no máximo 120 pedidos por minuto por chave ou utilizador. Um pedido de um navegador de outro domínio é recusado. Uma IA nunca pode alterar algumas definições, entre elas o travão de emergência, a reversão automática e as definições que pertencem a este servidor.
- Como reverter
- Revogue uma chave ou ligação no mesmo cartão, ou com
wp spark-speed mcp token revoke.
Ferramentas MCP só de leitura
Estas ferramentas não alteram nada no seu site. Uma IA usa-as para medir e fundamentar uma proposta.
get_optimization_guide
- O que faz
- Devolve o guia de otimização: o método de trabalho, o que faz cada definição, que definições são arriscadas e como verificar. O mesmo guia consta do relatório de diagnóstico.
- Quando usar
- Logo no início de uma conversa, para que a IA saiba como o Spark Speed funciona.
- Como verificar o efeito
- Texto simples, não JSON.
- Exemplo
- Pedir: "Leia primeiro o guia do Spark Speed."
- Como reverter
- Nada a desfazer: esta ferramenta apenas lê.
get_site_overview
- O que faz
- Dá uma visão geral: endereço do site, versões do plugin, do WordPress e do PHP, a combinação reconhecida de builder, WooCommerce e alojamento, a cobertura da cache, os principais interruptores e as últimas alterações.
- Quando usar
- No início de cada sessão.
- Como verificar o efeito
- JSON com, entre outros, a versão e os interruptores.
- Exemplo
- Pedir: "Dê-me uma visão geral do meu site no Spark Speed."
- Como reverter
- Nada a desfazer: esta ferramenta apenas lê.
get_optimization_status
- O que faz
- Mostra se o optimizer integrado (o botão Optimize my site) está ativo e como está uma ronda em curso, com uma ligação ao painel. Esta ferramenta deliberadamente não devolve definições nem dados do navegador.
- Quando usar
- Antes e depois de
start_optimization. - Como verificar o efeito
- JSON com o estado e um passo seguinte. Uma ronda que já não está em curso ainda não prova que tudo correu bem.
- Exemplo
- Pedir: "Como está a otimização?"
- Como reverter
- Nada a desfazer: esta ferramenta apenas lê.
get_config
- O que faz
- Devolve todas as definições atuais, bem como quais as definições que uma IA não pode alterar, quais estão associadas a este site ou servidor e quais são arriscadas.
- Quando usar
- Antes de a IA propor uma alteração.
- Como verificar o efeito
- JSON.
- Exemplo
- Pedir: "Que definições estão ativas agora?"
- Atenção
- Com isto, a IA vê toda a sua configuração do Spark Speed.
- Como reverter
- Nada a desfazer: esta ferramenta apenas lê.
get_diagnostics
- O que faz
- Devolve o relatório de diagnóstico completo: servidor, cache, o que carrega nas páginas e constatações, incluindo o que o optimizer decidiu anteriormente. É grande; use-o quando a visão geral não chegar.
- Quando usar
- Ao procurar uma causa, ou para reler as decisões de Optimize my site.
- Como verificar o efeito
- JSON.
- Exemplo
- Pedir: "O que decidiu o optimizer na última ronda?"
- Atenção
- Contém dados do servidor.
- Como reverter
- Nada a desfazer: esta ferramenta apenas lê.
check_page
- O que faz
- Obtém uma página do seu site como visitante de desktop e móvel: estado da cache (HIT ou MISS), a versão servida e o que o HTML carrega (scripts, scripts adiados, folhas de estilo, preloads, imagem LCP). Com
measurefaz também uma medição através do Google PageSpeed Insights. - Quando usar
- Após cada alteração, por cada página importante.
- Requisitos
- Um endereço completo deste site sem query string. Para
measure: uma chave do PageSpeed configurada e um site acessível publicamente. - Como verificar o efeito
- JSON com uma parte de cache, uma análise de HTML e, eventualmente, uma medição.
- Exemplo
{"url": "https://example.com/", "measure": true, "strategy": "mobile"}- Atenção
- Com
measureo endereço público é enviado para a Google. A medição pode ser feita no máximo duas vezes por minuto por utilizador. - Como reverter
- Nada a desfazer: esta ferramenta apenas lê.
get_site_findings
- O que faz
- Devolve problemas no próprio site, com nomes de ficheiros e custos medidos: erros 404, cadeias de redirecionamentos e ficheiros pesados.
- Quando usar
- Quando a pontuação fica aquém por algo que o Spark não pode resolver.
- Como verificar o efeito
- JSON.
- Exemplo
- Pedir: "Que problemas existem no meu próprio site?"
- Como reverter
- Nada a desfazer: esta ferramenta apenas lê.
get_warm_status
- O que faz
- Devolve o estado da construção da cache: páginas em cache face ao total, se a construção está a decorrer ou encravada, e endereços falhados. Os mesmos dados que
wp spark-speed warm-status. - Quando usar
- Após uma purga ou uma alteração.
- Como verificar o efeito
- JSON, ou
available: falsese o estado não puder ser determinado. - Exemplo
- Pedir: "A cache já está construída?"
- Como reverter
- Nada a desfazer: esta ferramenta apenas lê.
list_changes
- O que faz
- Devolve as alterações feitas via MCP ou
ai apply, comchange_id, hora, utilizador, motivo e se foram revertidas, mais a cronologia de todas as alterações de definições no site. - Quando usar
- Para procurar um
change_idpararevert_change. - Requisitos
- Opcionalmente
limitde 1 a 60 (predefinição: 15). - Como verificar o efeito
- JSON com uma lista de alterações e a cronologia.
- Exemplo
{"limit": 20}- Como reverter
- Nada a desfazer: esta ferramenta apenas lê.
Ferramentas MCP que alteram algo
Estas quatro ferramentas alteram o site. Um bom assistente de IA pede primeiro a sua autorização e faz um passo de cada vez.
start_optimization
- O que faz
- Ativa o optimizer integrado e inicia uma ronda, igual ao botão Optimize my site no cartão Smart optimization. O optimizer usa as suas próprias regras e a sua própria verificação no navegador. Se já houver uma ronda em curso, essa é reutilizada.
- Quando usar
- Apenas com a sua autorização expressa; a IA tem de enviar também
confirm: true. - Requisitos
- Um navegador com o painel do Spark Speed aberto. A verificação no navegador corre nesse ecrã de administração aberto e a ronda não é concluída se ninguém abrir o painel. O MCP sozinho não chega, portanto, para concluir uma ronda sem navegador.
- Como verificar o efeito
- A resposta contém
run_ide o estado. Acompanhe a ronda comget_optimization_statuse no painel; um arranque bem-sucedido não prova que a verificação esteja concluída. - Exemplo
{"confirm": true}- Atenção
- O optimizer pode alterar definições. Na versão 0.73.2, a administração não mostra uma lista de decisões nem um botão para anular uma ronda inteira; as decisões lê-as no relatório de diagnóstico ou através de
get_diagnostics. - Como reverter
- Reponha as definições em causa no separador Optimization ou Cache.
apply_config
- O que faz
- Altera definições do Spark Speed através da mesma porta de segurança que a proposta de IA na administração. As listas são complementadas, a menos que estejam em
replace_lists. Comdry_runvê primeiro o que mudaria. Cada alteração real recebe umchange_ide entra na cronologia com o motivo; depois, a cache é reconstruída. - Quando usar
- Depois de medir com as ferramentas de leitura, um passo de cada vez.
- Requisitos
changese umreasonde uma frase. Apenas definições deget_config, no máximo 40 de cada vez, e no máximo um interruptor arriscado que seja ativado de cada vez. As definições proibidas e específicas do site são recusadas com um motivo.- Como verificar o efeito
- JSON com
applied,change_id,changed(antigo e novo por definição) erejected. Verifique depois o site em móvel: menu, sliders, formulários e carrinho. - Exemplo
{"changes": {"delay_js": true}, "reason": "Reduce main-thread work", "dry_run": true}- Atenção
- Uma definição arriscada pode estragar o front-end. A reconstrução da cache sobrecarrega o servidor.
- Como reverter
revert_changecom ochange_id.
revert_change
- O que faz
- Reverte uma alteração anterior feita por
apply_configouai apply. Apenas as definições dessa alteração são repostas. Se uma definição tiver sido alterada de novo entretanto, por outra pessoa ou por um passo posterior, essa mantém-se e isso é indicado. - Quando usar
- Quando uma alteração estraga algo ou não traz ganho.
- Requisitos
- Um
change_id(verlist_changes). Só as últimas 30 alterações via MCP ou WP-CLI são conhecidas. - Como verificar o efeito
- JSON com
reverted,restoredeleft_alone_because_changed_since. Uma segunda execução indica que a alteração já tinha sido revertida. - Exemplo
{"change_id": "mcp-20261010-101500-ab12cd"}- Atenção
- Não reverte com isto as alterações feitas na administração ou pelo optimizer.
- Como reverter
- Volte a aplicar a alteração com
apply_config.
purge_cache
- O que faz
- Esvazia a cache de página de um endereço, ou do site inteiro se não indicar nenhum endereço. No caso do site inteiro, tudo é recolocado na fila. Fica registado na cronologia.
- Quando usar
- Quando uma página mostra uma versão desatualizada.
- Requisitos
- O endereço tem de pertencer a este site.
- Como verificar o efeito
- Resposta
purgedcom o endereço ouall. - Exemplo
{"url": "https://example.com/shop/"}- Atenção
- Após uma purga completa, as páginas são mais lentas até a construção terminar.
- Como reverter
- Desnecessário: a cache volta a ser preenchida pela construção da cache.
Tem dúvidas sobre um passo? Reverta, verifique o seu site e pergunte-nos através da página de contacto.
Ainda não tem o Spark Speed? Veja o que faz e quanto custa.
Perguntas frequentes
Não. Através do MCP, uma IA pode medir, alterar definições e iniciar uma ronda de otimização, mas a verificação no navegador dessa ronda corre no painel do Spark Speed. Este tem de estar aberto num navegador enquanto a ronda decorre.
mcp token e ai apply só existem com uma licença válida, e diagnostics recusa sem ela. Os restantes comandos existem, mas a gestão e as novas otimizações exigem uma licença válida ou o período de tolerância de 14 dias.
Procure o change_id com list_changes e use revert_change. Apenas as definições dessa alteração são repostas. As alterações do botão Optimize my site revertem-se, na versão 0.73.2, repondo as próprias definições.
Uma chave é mostrada apenas uma vez e não pode ser recuperada. Revogue-a no cartão Connect Claude or ChatGPT (MCP) ou com wp spark-speed mcp token revoke, e crie uma nova.
Foi assim que foram construídos na versão 0.73.2: winkelwagen, klantcache, laadplan e warm-hervat usam palavras neerlandesas como aan, uit, proef e legen. Também parte da saída está em neerlandês.