Skip to main content
SparkCore

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

Básico · Manual, via WP-CLI

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

Básico · Manual, via WP-CLI

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. Com wp spark-speed status vê Cached pages diminuir.
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 --all e depois wp spark-speed warm.

wp spark-speed flush-object-cache

Avançado · Manual, via WP-CLI

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

Avançado · Manual, via WP-CLI

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
--page com um endereço completo deste site, sem query string. Sem --page o 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

Avançado · Manual, via WP-CLI

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 --all coloca todas as páginas do site na fila; o trabalho real faz-se depois com process ou warm.
Quando usar
Após uma purga, ou quando quer ter uma página importante pronta de imediato.
Requisitos
Use --page, não --url: --url já está reservado no WP-CLI.
Como verificar o efeito
Uma linha por dispositivo com o resultado, por exemplo ok ou o motivo pelo qual não funcionou. Com --all vê 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

Avançado · Manual, via WP-CLI

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

Avançado · Manual, via WP-CLI

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 --wait espera 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

Básico · Manual, via WP-CLI

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 --json obté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

Avançado · Manual, via WP-CLI

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 aviso Niet hervat: <reason> (código de saída 1). Depois, verifique com warm-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

Avançado · Manual, via WP-CLI

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. proef executa o teste. aan ativa a funcionalidade e uit desativa-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. aan só funciona após um teste bem-sucedido, ou com --bevestigd depois 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

Avançado · Manual, via WP-CLI

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) e legen (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, aan recusa 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. ou Klantcache uit en geleegd., e com status uma linha com stand, sessies met eigen kopieen e kan 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

Avançado · Manual, via WP-CLI

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. kandidaten mostra 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. aan e uit ativam ou desativam o plano. status mostra o estado.
Quando usar
Quando um plugin carrega muito código no front-end de que os seus visitantes não precisam.
Requisitos
weglaten só é permitido após um teste com o resultado gelijk, ou com --bevestigd depois 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 voorkant e 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> ou wp 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

Avançado · Manual, via WP-CLI

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 com verify-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

Avançado · Manual, via WP-CLI

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. ou Font 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

Avançado · Manual, via WP-CLI

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

Avançado · Manual, via WP-CLI

O que faz
Mostra o que tem de carregar antes do LCP (o caminho crítico). Com --file analisa 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 --page obté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. --page só 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

Avançado · Manual, via WP-CLI · funciona apenas com licença válida

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

Avançado · Manual, via WP-CLI · apenas com licença válida

O que faz
Gere as chaves MCP a partir da linha de comandos. create cria uma nova chave e mostra-a uma única vez. list mostra as chaves sem o segredo. revoke <id> revoga uma chave. Com --label dá 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. create recusa-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
list mostra, 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

Avançado · Manual, via WP-CLI · apenas com licença válida

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 um change_id. A proposta vem de --file ou 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, rejected e next_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_change com o change_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

Avançado · Sem interruptor: ativa enquanto a licença for válida

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çalho X-Spark-Token ou 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

Básico · Manual, via MCP · só leitura

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

Básico · Manual, via MCP · só leitura

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

Básico · Manual, via MCP · só leitura

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

Avançado · Manual, via MCP · só leitura

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

Avançado · Manual, via MCP · só leitura

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

Avançado · Manual, via MCP · só leitura

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 measure faz 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 measure o 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

Avançado · Manual, via MCP · só leitura

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

Avançado · Manual, via MCP · só leitura

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: false se 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

Básico · Manual, via MCP · só leitura

O que faz
Devolve as alterações feitas via MCP ou ai apply, com change_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_id para revert_change.
Requisitos
Opcionalmente limit de 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

Básico · Manual, via MCP · altera algo

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_id e o estado. Acompanhe a ronda com get_optimization_status e 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

Avançado · Manual, via MCP · altera algo

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. Com dry_run vê primeiro o que mudaria. Cada alteração real recebe um change_id e 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
changes e um reason de uma frase. Apenas definições de get_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) e rejected. 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_change com o change_id.

revert_change

Básico · Manual, via MCP · altera algo

O que faz
Reverte uma alteração anterior feita por apply_config ou ai 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 (ver list_changes). Só as últimas 30 alterações via MCP ou WP-CLI são conhecidas.
Como verificar o efeito
JSON com reverted, restored e left_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

Básico · Manual, via MCP · altera algo

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 purged com o endereço ou all.
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.