Skip to main content
SparkCore

WP-CLI y MCP: todos los comandos y herramientas

Esta página describe todo lo que puede hacer en Spark Speed 0.73.2 sin una pantalla de administración: los comandos de WP-CLI en el servidor y las herramientas MCP con las que un asistente de IA como Claude o ChatGPT trabaja con su sitio. Está pensada para administradores y agencias que trabajan con la línea de comandos o con un asistente de IA; para la gestión diaria no la necesita.
En resumen
  • Todos los comandos empiezan por wp spark-speed y se ejecutan en el servidor
  • mcp token y ai apply solo existen con una licencia válida; diagnostics se niega a funcionar sin ella
  • MCP requiere una licencia válida y un cliente autorizado que trabaje como administrador
  • start_optimization necesita un panel abierto en el navegador para la comprobación del navegador

Estado y caché

Ver rápidamente cómo está la caché, vaciarla y comprobar lo que reciben los visitantes.

wp spark-speed status

Básico · Manual, mediante WP-CLI

Qué hace
Muestra en cinco líneas el estado de la caché: qué plugin gestiona el drop-in de caché (el archivo con el que WordPress carga pronto la caché de página), si WP_CACHE está activado, cuántas páginas están en caché, cuántas direcciones hay en la cola y si el worker local opcional está accesible. Útil para echar un vistazo rápido sin abrir wp-admin.
Cuándo usarlo
Tras una actualización, una migración o una purga, o en un script de monitorización.
Cómo comprobar el efecto
La salida está en inglés: Drop-in owner, WP_CACHE, Cached pages, Queue pending, Worker. Worker : OFFLINE es normal: el worker es opcional y no viene en el zip; Spark usa entonces la ruta de PHP.
Ejemplo
wp spark-speed status
Cómo deshacerlo
No hay nada que deshacer: el comando solo lee.

wp spark-speed purge

Básico · Manual, mediante WP-CLI

Qué hace
Vacía toda la caché de página. Después, las páginas se reconstruyen en la siguiente visita o mediante la construcción de la caché.
Cuándo usarlo
Cuando los visitantes ven una versión obsoleta, o tras un cambio grande en el tema o en los ajustes.
Cómo comprobar el efecto
Verá Page cache purged. Con wp spark-speed status verá cómo Cached pages disminuye.
Ejemplo
wp spark-speed purge
Atención
Hasta que la caché se haya reconstruido, las primeras visitas son más lentas. Esto no vacía la caché de objetos; para eso existe flush-object-cache.
Cómo deshacerlo
No se puede deshacer. Reconstruya la caché con wp spark-speed optimize --all y después con wp spark-speed warm.

wp spark-speed flush-object-cache

Avanzado · Manual, mediante WP-CLI

Qué hace
Vacía la caché de objetos (el almacenamiento temporal de resultados de la base de datos, por ejemplo en Redis, Memcached, APCu o SQLite) que pasa por el drop-in de caché de objetos de Spark. Esto está separado deliberadamente de la caché de página.
Cuándo usarlo
Si sospecha que hay datos obsoletos en la caché de objetos. Spark no vacía por sí mismo la caché de objetos de forma automática.
Requisitos
Una caché de objetos de Spark que funcione. De lo contrario, recibirá una advertencia.
Cómo comprobar el efecto
Un mensaje de éxito, o una advertencia si no había nada que vaciar.
Ejemplo
wp spark-speed flush-object-cache
Atención
Poco después de vaciarla, WordPress vuelve a consultar más a la base de datos.
Cómo deshacerlo
No es necesario: la caché de objetos se vuelve a llenar sola.

wp spark-speed verify-cache

Avanzado · Manual, mediante WP-CLI

Qué hace
Obtiene una página de su propio sitio como visitante de escritorio y como visitante móvil y emite un veredicto en JSON: qué estado de caché se sirvió y si corresponde al código y a los ajustes actuales.
Cuándo usarlo
Tras un cambio, para comprobar que los visitantes reciben la nueva versión en caché.
Requisitos
--page con una dirección completa de este sitio, sin cadena de consulta. Sin --page el comando se detiene con un error.
Cómo comprobar el efecto
En el JSON consta ok. El código de salida es 0 si todo es correcto y 2 si no lo es, de modo que puede usarlo en un script.
Ejemplo
wp spark-speed verify-cache --page=https://example.com/product/example/
Cómo deshacerlo
No hay nada que deshacer: el comando solo lee.

Construir la caché

Optimizar páginas, procesar la cola y seguir o reanudar la construcción de la caché. Verá la misma construcción en el panel de administración, en la pestaña Cache.

wp spark-speed optimize

Avanzado · Manual, mediante WP-CLI

Qué hace
Sin opciones adicionales, reconstruye la página de inicio, optimizada y en caché para cada dispositivo. Con --page=<address> lo hace para una sola página. Con --all pone en la cola todas las páginas del sitio; el trabajo real lo hace después con process o warm.
Cuándo usarlo
Tras una purga, o si quiere tener una página importante lista de inmediato.
Requisitos
Utilice --page, no --url: --url ya está ocupado en WP-CLI.
Cómo comprobar el efecto
Una línea por dispositivo con el resultado, por ejemplo ok o el motivo por el que no funcionó. Con --all verá cuántas direcciones entraron en la cola.
Ejemplo
wp spark-speed optimize --page=https://example.com/shop/
Atención
Si el freno de emergencia (modo seguro) está activado o la optimización está desactivada, las páginas solo se guardan en caché y no se optimizan.
Cómo deshacerlo
Vacíe la caché de esa página o toda la caché.

wp spark-speed process

Avanzado · Manual, mediante WP-CLI

Qué hace
Procesa ahora una parte de la cola, por defecto 20 direcciones. Usa el mismo bloqueo que el procesamiento en segundo plano, de modo que no se estorban.
Cuándo usarlo
Para procesar paso a paso una cola llena, por ejemplo tras optimize --all.
Requisitos
Una cola con direcciones. El número se ajusta con --limit=<number>.
Cómo comprobar el efecto
Una línea por dirección con el resultado por dispositivo y, al final, Batch done. Remaining: N.
Ejemplo
wp spark-speed process --limit=50
Atención
Carga el servidor mientras se ejecuta. Si otro procesamiento mantiene el bloqueo, no ocurre nada.
Cómo deshacerlo
No aplicable.

wp spark-speed warm

Avanzado · Manual, mediante WP-CLI

Qué hace
Procesa toda la cola hasta vaciarla, en lotes de 25 por defecto. Si no hay avance, averigua por qué. Si hay otro procesamiento en marcha, lo indica y se detiene; con --wait espera hasta 15 minutos como máximo el bloqueo.
Cuándo usarlo
En sitios con pocas visitas, donde WP-Cron no se ejecuta por sí solo con la frecuencia suficiente, o tras una purga completa.
Requisitos
El sitio debe poder alcanzarse a sí mismo (loopback), porque la construcción obtiene sus propias páginas. El tamaño del lote se puede cambiar con --batch=<number>.
Cómo comprobar el efecto
Por ronda remaining: N (cached M) y un resumen. El código de salida es 0 si la cola está vacía, 1 si queda trabajo y 2 si la construcción está bloqueada o atascada.
Ejemplo
wp spark-speed warm --wait
Atención
Puede tardar mucho y carga el servidor. Un sitio en modo de mantenimiento o detrás de una protección contra bots que devuelve 403 hace que las páginas fallen.
Cómo deshacerlo
Detenga con Ctrl+C. La caché ya construida se puede vaciar con purge.

wp spark-speed warm-status

Básico · Manual, mediante WP-CLI

Qué hace
Muestra cómo va la construcción de la caché: el estado y desde cuándo, cuánto tiempo no ha pasado nada, el motivo, la cola, las páginas en caché frente al total, una posible pausa, las direcciones fallidas y la última prueba. Con --json obtiene todo en JSON.
Cuándo usarlo
Si la construcción no avanza, o en un monitor que tenga en cuenta el código de salida.
Cómo comprobar el efecto
Las líneas tienen etiquetas en neerlandés (stand, sinds, wachtrij, gecached, pauze, fails, laatste toets). El código de salida 0 indica buen estado, 1 una causa conocida, 2 atascado y 3 significa que no se puede determinar el estado.
Ejemplo
wp spark-speed warm-status --json
Cómo deshacerlo
No hay nada que deshacer: el comando solo lee.

wp spark-speed warm-hervat

Avanzado · Manual, mediante WP-CLI

Qué hace
Prueba una construcción de caché en pausa con un intento real en la primera dirección de la cola y reanuda la construcción si el sitio responde bien. Es la versión por línea de comandos del botón para reanudar la construcción en la pestaña Cache.
Cuándo usarlo
Después de resolver la causa de una pausa, por ejemplo un error de loopback o una protección contra bots.
Requisitos
Una pausa abierta. Sin pausa indica Er stond geen pauze open..
Cómo comprobar el efecto
Si se reanuda, verá Hervat. con la cola y el número de páginas en caché (código de salida 0). Si no lo consigue, aparece una advertencia Niet hervat: <reason> (código de salida 1). Después, compruebe con warm-status.
Ejemplo
wp spark-speed warm-hervat
Atención
Si el sitio sigue dando errores, la pausa se mantiene.
Cómo deshacerlo
No aplicable.

Tienda, clientes y plan de carga

Estos comandos controlan funciones que también encuentra en el panel de administración, con la misma prueba previa. Los subcomandos son palabras en neerlandés: aan (activar), uit (desactivar), proef (prueba), legen (vaciar).

wp spark-speed winkelwagen

Avanzado · Manual, mediante WP-CLI

Qué hace
Gestiona la caché para visitantes con el carrito lleno, la misma función que Cached pages with a filled cart en la tarjeta Cart and logged-in customers. status (por defecto) muestra el estado y la última prueba. proef ejecuta la prueba. aan activa la función y uit la desactiva.
Cuándo usarlo
En una tienda WooCommerce en la que, de otro modo, los compradores con algo en el carrito reciben siempre una página lenta, construida por completo.
Requisitos
WooCommerce. aan solo funciona tras una prueba satisfactoria, o con --bevestigd después de que usted mismo haya revisado una diferencia encontrada.
Cómo comprobar el efecto
La prueba indica el resultado, el número de páginas, si hace falta el script del carrito y qué diferencias hay. Al activarlo verá Winkelwagencache aan; de paginacache is geleegd..
Ejemplo
wp spark-speed winkelwagen proef
Atención
Activarlo vacía toda la caché de página. Si aprueba con --bevestigd una diferencia por error, puede acabar apareciendo contenido personal en páginas compartidas.
Cómo deshacerlo
wp spark-speed winkelwagen uit
Nombre técnico
woo_cart_cache

wp spark-speed klantcache

Avanzado · Manual, mediante WP-CLI

Qué hace
Gestiona la caché propia para clientes con sesión iniciada, la misma función que Own cache for logged-in customers en la tarjeta Cart and logged-in customers. status (por defecto) muestra el estado, el número de sesiones con copia propia y si la función puede activarse. aan, uit (desactiva y vacía) y legen (vacía todas las copias de clientes).
Cuándo usarlo
Cuando los clientes con sesión iniciada reciben una página construida por completo en cada clic.
Requisitos
Si el sitio no puede con la función, aan se niega e indica el motivo. Solo roles de cliente, nunca administradores. Una copia tiene como máximo 8 horas.
Cómo comprobar el efecto
Mensajes como Klantcache aan. o Klantcache uit en geleegd., y con status una línea con stand, sessies met eigen kopieen y kan aan.
Ejemplo
wp spark-speed klantcache status
Atención
Cada sesión iniciada recibe copias propias, por lo que el uso de disco crece con el número de clientes.
Cómo deshacerlo
wp spark-speed klantcache uit
Nombre técnico
klant_cache

wp spark-speed laadplan

Avanzado · Manual, mediante WP-CLI

Qué hace
Gestiona el plan de carga: los plugins que cargan código en el front end pero no cambian la página se omiten allí, previa comprobación. Es la misma función que la tarjeta Front-end load plan en Diagnostics. kandidaten muestra los plugins con su número de archivos y la última prueba. proef <plugin> comprueba si la página sigue igual sin ese plugin. weglaten <plugin> lo omite en el front end. laden <plugin> lo vuelve a cargar. aan y uit activan o desactivan el plan. status muestra el estado.
Cuándo usarlo
Cuando un plugin carga en el front end mucho código que sus visitantes no necesitan.
Requisitos
weglaten solo se permite tras una prueba con resultado gelijk, o con --bevestigd después de revisar usted mismo una diferencia. Solo se aplica a visitantes anónimos. El plan está desactivado por defecto.
Cómo comprobar el efecto
Una línea con modus, weggelaten op de voorkant y el propietario del mu-plugin (un plugin que WordPress carga siempre en primer lugar).
Ejemplo
wp spark-speed laadplan proef contact-form-7
Atención
Una página igual no demuestra que un plugin no haga un trabajo invisible, como seguridad, seguimiento en el servidor o registro. Omita solo plugins que conozca.
Cómo deshacerlo
wp spark-speed laadplan laden <plugin> o wp spark-speed laadplan uit.

Importar y analizar mediciones

Para quien mide por su cuenta: importar mediciones del navegador para que Spark dé prioridad exactamente a la imagen y a las fuentes adecuadas, y consultar la ruta crítica.

wp spark-speed image-hint

Avanzado · Manual, mediante WP-CLI

Qué hace
Importa una medición de un navegador real que registra qué imagen de una página es el LCP (el elemento visible más grande durante la carga). Mientras la medición sea válida, la página en caché carga esa imagen con prioridad.
Cuándo usarlo
Cuando Spark elige por sí mismo una imagen principal equivocada.
Requisitos
Un archivo JSON de 16 KB como máximo procedente de un análisis de administrador. Los scripts de recopilación mencionados en la tarjeta Measured choices no vienen en el zip del plugin.
Cómo comprobar el efecto
Si tiene éxito, Observation stored; refresh and verify the affected cache variants.. Si no coinciden la dirección, la antigüedad, los ajustes o la prueba del LCP, la medición se rechaza. Después, actualice la página afectada y compruebe con verify-cache.
Ejemplo
wp spark-speed image-hint --file=lcp.json
Atención
El comando no vacía la caché ni cambia ajustes. Las mediciones caducan a las seis horas y con cambios en el contenido, los medios, el menú, el tema, los plugins o los ajustes.
Cómo deshacerlo
No hay un comando aparte para eliminar una medición; tras caducar vuelve a valer la elección automática.

wp spark-speed font-hint

Avanzado · Manual, mediante WP-CLI

Qué hace
Importa una medición de las fuentes locales que realmente se cargan de forma visible, de modo que solo se precarguen esas.
Cuándo usarlo
Cuando se precargan demasiadas fuentes o fuentes equivocadas.
Requisitos
Un archivo JSON de 16 KB como máximo. Los scripts de recopilación mencionados en la tarjeta Measured choices no vienen en el zip del plugin.
Cómo comprobar el efecto
Font observation stored; refresh and verify affected cache variants. o Font observation rejected..
Ejemplo
wp spark-speed font-hint --file=fonts.json
Atención
Una medición obsoleta puede precargar la fuente equivocada. Las mediciones caducan a las seis horas y con cambios en el sitio.
Cómo deshacerlo
No hay un comando aparte; tras caducar vuelve a valer la elección automática.

wp spark-speed font-metrics

Avanzado · Manual, mediante WP-CLI

Qué hace
Importa las medidas obtenidas de la fuente de reserva, para que el texto se desplace menos mientras carga la fuente web.
Cuándo usarlo
Cuando el texto se desplaza de forma visible en cuanto llega la fuente web.
Requisitos
Un archivo JSON de 16 KB como máximo. Los valores fuera del rango permitido se rechazan. Los scripts de recopilación mencionados en la tarjeta Measured choices no vienen en el zip del plugin.
Cómo comprobar el efecto
Font metrics stored; refresh the affected cache variants and verify the layout. Después, revise la página.
Ejemplo
wp spark-speed font-metrics --file=metrics.json
Atención
Unas medidas incorrectas pueden, precisamente, hacer que el texto se desplace. Compruebe el formato.
Cómo deshacerlo
No se ha encontrado un comando aparte; vacíe la caché de las páginas afectadas.

wp spark-speed kritiek-pad

Avanzado · Manual, mediante WP-CLI

Qué hace
Muestra qué debe cargarse antes del LCP (la ruta crítica). Con --file analiza un JSON de Lighthouse (una exportación de DevTools o una respuesta de PageSpeed) y guarda el resultado para la tarjeta What keeps the score from green en Diagnostics. Con --page obtiene la página como visitante móvil y hace una estimación a partir del HTML, sin tiempos.
Cuándo usarlo
Cuando quiere saber qué frena la puntuación.
Requisitos
Una de las dos opciones. El archivo de Lighthouse debe contener las solicitudes de red. --page solo funciona con direcciones de este sitio.
Cómo comprobar el efecto
JSON compacto en el terminal.
Ejemplo
wp spark-speed kritiek-pad --file=lighthouse.json
Cómo deshacerlo
No es necesario: el comando no cambia nada más en el sitio.

Comandos que requieren una licencia válida

Spark Speed tiene un único nivel de licencia. Los comandos mcp token y ai apply solo existen mientras la licencia sea válida (o durante el período de gracia de 14 días); diagnostics existe siempre, pero se niega a funcionar sin una licencia válida.

wp spark-speed diagnostics

Avanzado · Manual, mediante WP-CLI · works only with a valid licence

Qué hace
Devuelve el informe de diagnóstico en JSON (servidor, PHP, caché, plugins), o lo guarda en un archivo con --save=<path>. Es el mismo informe que Download diagnostic report en el panel de administración.
Cuándo usarlo
Para soporte, o para dárselo a una IA.
Requisitos
Una licencia válida. El comando existe también sin licencia, pero entonces se niega con un mensaje de error.
Cómo comprobar el efecto
JSON en el terminal, o Saved to <path>.
Ejemplo
wp spark-speed diagnostics --save=spark-report.json
Atención
El archivo contiene datos del servidor y de los ajustes. Trátelo como confidencial.
Cómo deshacerlo
Elimine el archivo.

wp spark-speed mcp token

Avanzado · Manual, mediante WP-CLI · only with a valid licence

Qué hace
Gestiona las claves MCP desde la línea de comandos. create crea una clave nueva y la muestra una sola vez. list muestra las claves sin el secreto. revoke <id> revoca una clave. Con --label da un nombre a la clave (por defecto, WP-CLI). Es lo mismo que Create key en la tarjeta Connect Claude or ChatGPT (MCP).
Cuándo usarlo
Cuando quiere conectar al sitio un programa de IA de su propio ordenador, como Claude Code.
Requisitos
Existe solo mientras la licencia sea válida. Debe indicar --user=<admin> de un usuario con permisos de administrador. create se niega a escribir en una pantalla: envíe la salida directamente a su gestor de contraseñas o a su almacén de secretos. Máximo cinco claves.
Cómo comprobar el efecto
list muestra por clave un id, una pista (primeros y últimos cuatro caracteres), nombre, propietario, fecha de creación y último uso.
Ejemplo
wp spark-speed mcp token list --user=admin
Atención
Una clave puede hacer todo lo que pueden las herramientas MCP, como el administrador al que pertenece. Una clave perdida no se puede recuperar, solo revocar. Si el propietario pierde sus permisos de administrador, la clave deja de funcionar.
Cómo deshacerlo
wp spark-speed mcp token revoke <id> --user=admin (el id, no la clave en sí).

wp spark-speed ai apply

Avanzado · Manual, mediante WP-CLI · only with a valid licence

Qué hace
Aplica una propuesta de configuración de una IA a través de la misma puerta de seguridad que la herramienta MCP apply_config: se rechazan los ajustes prohibidos y los vinculados al sitio, como máximo se activa un interruptor de riesgo por vez y cada cambio recibe un change_id. La propuesta procede de --file o de la entrada estándar.
Cuándo usarlo
Cuando ha creado una propuesta con una IA y quiere aplicarla de forma controlada sin abrir el panel de administración.
Requisitos
Existe solo mientras la licencia sea válida. --user=<admin> con permisos de administrador. La propuesta es JSON de 64 KB como máximo.
Cómo comprobar el efecto
JSON con, entre otros, applied, change_id, changed, rejected y next_step. Después, compruebe el sitio en el móvil: menú, sliders, formularios y carrito.
Ejemplo
wp spark-speed ai apply --file=proposal.json --json --user=admin
Atención
Un ajuste de riesgo puede romper el front end. Tras cada cambio satisfactorio se reconstruye la caché, lo que carga el servidor durante un momento.
Cómo deshacerlo
No hay un comando de WP-CLI para revertir. Utilice la herramienta MCP revert_change con el change_id, o restaure el ajuste en el panel de administración.

MCP: conexión y requisitos

Lo que necesita antes de que un asistente de IA pueda usar las herramientas siguientes.

MCP-koppeling

Avanzado · Sin interruptor: activo mientras la licencia sea válida

Qué hace
MCP (Model Context Protocol) es un estándar con el que un asistente de IA como Claude o ChatGPT puede trabajar con su sitio mediante herramientas fijas. Spark Speed tiene su propia dirección MCP en WordPress. Solo ofrece a la IA las herramientas que se indican a continuación: medir, establecer ajustes, revertir y vaciar la caché, sin acceso al servidor.
Requisitos
Una licencia válida y un cliente autorizado que trabaje como administrador. Es posible de tres maneras: una clave propia (mediante Create key o wp spark-speed mcp token) en la cabecera X-Spark-Token o como token Bearer; una contraseña de aplicación de WordPress de un administrador; o la conexión desde Claude.ai o ChatGPT, en la que inicia sesión en WordPress y da su permiso. Sin una licencia válida, la dirección rechaza cualquier solicitud.
Cómo comprobar el efecto
La dirección y las reglas para Claude Code y Claude Desktop están en la tarjeta Connect Claude or ChatGPT (MCP) de la pestaña Optimization. Tras la primera solicitud, su clave muestra allí una hora en último uso.
Ejemplo
claude mcp add --transport http spark-speed https://example.com/wp-json/spark-speed/v1/mcp --header "X-Spark-Token: <key>"
Atención
Se permiten como máximo 120 solicitudes por minuto por clave o usuario. Se rechaza una solicitud desde un navegador de otro dominio. Una IA nunca puede cambiar algunos ajustes, entre ellos el freno de emergencia, la reversión automática y los ajustes propios de este servidor.
Cómo deshacerlo
Revoque una clave o una conexión en la misma tarjeta, o con wp spark-speed mcp token revoke.

Herramientas MCP de solo lectura

Estas herramientas no cambian nada en su sitio. Una IA las usa para medir y para respaldar una propuesta.

get_optimization_guide

Básico · Manual, mediante MCP · solo lectura

Qué hace
Devuelve la guía de optimización: el método de trabajo, qué hace cada ajuste, qué ajustes son de riesgo y cómo comprobar. La misma guía está en el informe de diagnóstico.
Cuándo usarlo
Lo primero en una conversación, para que la IA sepa cómo funciona Spark Speed.
Cómo comprobar el efecto
Texto normal, no JSON.
Ejemplo
Pregunta: "Lea primero la guía de Spark Speed."
Cómo deshacerlo
No hay nada que deshacer: esta herramienta solo lee.

get_site_overview

Básico · Manual, mediante MCP · solo lectura

Qué hace
Devuelve una visión general: dirección del sitio, versiones del plugin, de WordPress y de PHP, la combinación reconocida de constructor, WooCommerce y alojamiento, la cobertura de la caché, los interruptores principales y los últimos cambios.
Cuándo usarlo
Al comienzo de cada sesión.
Cómo comprobar el efecto
JSON con, entre otros, la versión y los interruptores.
Ejemplo
Pregunta: "Deme una visión general de mi sitio en Spark Speed."
Cómo deshacerlo
No hay nada que deshacer: esta herramienta solo lee.

get_optimization_status

Básico · Manual, mediante MCP · solo lectura

Qué hace
Muestra si el optimizador integrado (el botón Optimize my site) está activado y cómo va una ronda en curso, con un enlace al panel. Esta herramienta no entrega a propósito ajustes ni datos del navegador.
Cuándo usarlo
Antes y después de start_optimization.
Cómo comprobar el efecto
JSON con el estado y un siguiente paso. Una ronda que ya no se ejecuta todavía no demuestra que todo haya salido bien.
Ejemplo
Pregunta: "¿Cómo va la optimización?"
Cómo deshacerlo
No hay nada que deshacer: esta herramienta solo lee.

get_config

Avanzado · Manual, mediante MCP · solo lectura

Qué hace
Devuelve todos los ajustes actuales, además de qué ajustes no puede cambiar una IA, cuáles están vinculados a este sitio o servidor y cuáles son de riesgo.
Cuándo usarlo
Antes de que la IA proponga un cambio.
Cómo comprobar el efecto
JSON.
Ejemplo
Pregunta: "¿Qué ajustes están activados ahora?"
Atención
Con esto, la IA ve toda su configuración de Spark Speed.
Cómo deshacerlo
No hay nada que deshacer: esta herramienta solo lee.

get_diagnostics

Avanzado · Manual, mediante MCP · solo lectura

Qué hace
Devuelve el informe de diagnóstico completo: servidor, caché, lo que se carga en las páginas y los hallazgos, incluido lo que el optimizador decidió antes. Es grande; úselo si la visión general no basta.
Cuándo usarlo
Al buscar una causa, o para releer las decisiones de Optimize my site .
Cómo comprobar el efecto
JSON.
Ejemplo
Pregunta: "¿Qué decidió el optimizador en la última ronda?"
Atención
Contiene datos del servidor.
Cómo deshacerlo
No hay nada que deshacer: esta herramienta solo lee.

check_page

Avanzado · Manual, mediante MCP · solo lectura

Qué hace
Obtiene una página de su sitio como visitante de escritorio y móvil: estado de la caché (HIT o MISS), la versión servida y lo que carga el HTML (scripts, scripts aplazados, hojas de estilo, preloads, imagen LCP). Con measure realiza además una medición mediante Google PageSpeed Insights.
Cuándo usarlo
Tras cada cambio, para cada página importante.
Requisitos
Una dirección completa de este sitio sin cadena de consulta. Para measure: una clave de PageSpeed configurada y un sitio accesible públicamente.
Cómo comprobar el efecto
JSON con una parte de caché, un análisis del HTML y, en su caso, una medición.
Ejemplo
{"url": "https://example.com/", "measure": true, "strategy": "mobile"}
Atención
Con measure la dirección pública se envía a Google. Se puede medir como máximo dos veces por minuto por usuario.
Cómo deshacerlo
No hay nada que deshacer: esta herramienta solo lee.

get_site_findings

Avanzado · Manual, mediante MCP · solo lectura

Qué hace
Devuelve problemas del propio sitio, con nombres de archivo y costes medidos: errores 404, cadenas de redirecciones y archivos pesados.
Cuándo usarlo
Cuando la puntuación se queda corta por algo que Spark no puede resolver.
Cómo comprobar el efecto
JSON.
Ejemplo
Pregunta: "¿Qué problemas hay en mi propio sitio?"
Cómo deshacerlo
No hay nada que deshacer: esta herramienta solo lee.

get_warm_status

Avanzado · Manual, mediante MCP · solo lectura

Qué hace
Devuelve el estado de la construcción de la caché: páginas en caché frente al total, si la construcción avanza o está atascada, y direcciones fallidas. Los mismos datos que wp spark-speed warm-status.
Cuándo usarlo
Tras una purga o un cambio.
Cómo comprobar el efecto
JSON, o available: false si no se puede determinar el estado.
Ejemplo
Pregunta: "¿Ya está construida la caché?"
Cómo deshacerlo
No hay nada que deshacer: esta herramienta solo lee.

list_changes

Básico · Manual, mediante MCP · solo lectura

Qué hace
Devuelve los cambios realizados mediante MCP o ai apply , con change_id, hora, usuario, motivo y si se han revertido, además de la cronología de todos los cambios de ajustes del sitio.
Cuándo usarlo
Para buscar un change_id para revert_change.
Requisitos
Opcionalmente limit de 1 a 60 (por defecto 15).
Cómo comprobar el efecto
JSON con una lista de cambios y la cronología.
Ejemplo
{"limit": 20}
Cómo deshacerlo
No hay nada que deshacer: esta herramienta solo lee.

Herramientas MCP que modifican algo

Estas cuatro herramientas modifican el sitio. Un buen asistente de IA le pide permiso primero y avanza paso a paso.

start_optimization

Básico · Manual, mediante MCP · modifica algo

Qué hace
Activa el optimizador integrado e inicia una ronda, la misma que el botón Optimize my site en la tarjeta Smart optimization. El optimizador usa sus propias reglas y su comprobación de navegador. Si ya hay una ronda en curso, se reutiliza.
Cuándo usarlo
Solo con su permiso expreso; la IA debe enviar confirm: true .
Requisitos
Un navegador con el panel de Spark Speed abierto. La comprobación del navegador se ejecuta en esa pantalla de administración abierta y la ronda no se completa si nadie abre el panel. Por tanto, MCP por sí solo no basta para completar una ronda sin navegador.
Cómo comprobar el efecto
La respuesta contiene run_id y el estado. Siga la ronda con get_optimization_status y en el panel; un inicio correcto no demuestra que la comprobación haya terminado.
Ejemplo
{"confirm": true}
Atención
El optimizador puede modificar ajustes. En 0.73.2, el panel de administración no muestra una lista de decisiones ni un botón para deshacer una ronda completa; las decisiones se releen en el informe de diagnóstico o mediante get_diagnostics.
Cómo deshacerlo
Restaure los ajustes afectados en la pestaña Optimization o Cache.

apply_config

Avanzado · Manual, mediante MCP · modifica algo

Qué hace
Modifica los ajustes de Spark Speed a través de la misma puerta de seguridad que la propuesta de IA en el panel de administración. Las listas se amplían, salvo que figuren en replace_lists . Con dry_run ve primero qué cambiaría. Cada cambio real recibe un change_id y consta con su motivo en la cronología; después se reconstruye la caché.
Cuándo usarlo
Tras medir con las herramientas de lectura, un paso cada vez.
Requisitos
changes y un reason de una frase. Solo ajustes de get_config, como máximo 40 por vez, y como máximo un interruptor de riesgo que se active por vez. Los ajustes prohibidos y los vinculados al sitio se rechazan con un motivo.
Cómo comprobar el efecto
JSON con applied, change_id, changed (valor antiguo y nuevo por ajuste) y rejected. Después, compruebe el sitio en el móvil: menú, sliders, formularios y carrito.
Ejemplo
{"changes": {"delay_js": true}, "reason": "Reduce main-thread work", "dry_run": true}
Atención
Un ajuste de riesgo puede romper el front end. Reconstruir la caché carga el servidor.
Cómo deshacerlo
revert_change con el change_id.

revert_change

Básico · Manual, mediante MCP · modifica algo

Qué hace
Revierte un cambio anterior de apply_config o ai apply . Solo se revierten los ajustes de ese cambio. Si un ajuste se ha vuelto a modificar después, por otra persona o por un paso posterior, se mantiene y se indica.
Cuándo usarlo
Cuando un cambio rompe algo o no aporta ningún beneficio.
Requisitos
Un change_id (véase list_changes). Solo se conocen los últimos 30 cambios realizados mediante MCP o WP-CLI.
Cómo comprobar el efecto
JSON con reverted, restored y left_alone_because_changed_since. Una segunda vez indica que el cambio ya se había revertido.
Ejemplo
{"change_id": "mcp-20261010-101500-ab12cd"}
Atención
Con esto no se revierten los cambios hechos en el panel de administración ni por el optimizador.
Cómo deshacerlo
Vuelva a aplicar el cambio con apply_config.

purge_cache

Básico · Manual, mediante MCP · modifica algo

Qué hace
Vacía la caché de página de una dirección, o de todo el sitio si no indica ninguna dirección. Si es todo el sitio, todo se vuelve a poner en la cola. Consta en la cronología.
Cuándo usarlo
Cuando una página muestra una versión obsoleta.
Requisitos
La dirección debe pertenecer a este sitio.
Cómo comprobar el efecto
Respuesta purged con la dirección o all.
Ejemplo
{"url": "https://example.com/shop/"}
Atención
Tras una purga completa, las páginas son más lentas hasta que termina la construcción.
Cómo deshacerlo
No es necesario: la construcción de la caché vuelve a llenar la caché.
¿Tiene dudas sobre algún paso? Revierta, compruebe su sitio y consúltenos a través de la página de contacto.
¿Aún no tiene Spark Speed? Vea qué hace y cuánto cuesta.

Preguntas frecuentes

No. Mediante MCP, una IA puede medir, cambiar ajustes e iniciar una ronda de optimización, pero la comprobación del navegador de esa ronda se ejecuta en el panel de Spark Speed. Este debe estar abierto en un navegador mientras dure la ronda.

mcp token y ai apply solo existen con una licencia válida, y diagnostics se niega a funcionar sin ella. Los demás comandos sí están disponibles, pero la gestión y las nuevas optimizaciones requieren una licencia válida o el período de gracia de 14 días.

Busque el change_id con list_changes y utilice revert_change. Solo se revierten los ajustes de ese cambio. Los cambios del botón Optimize my site se revierten en 0.73.2 restaurando usted mismo esos ajustes.

Una clave solo se muestra una vez y no se puede recuperar. Revóquela en la tarjeta Connect Claude or ChatGPT (MCP) o con wp spark-speed mcp token revoke, y cree una nueva.

Así están construidos en 0.73.2: winkelwagen (carrito), klantcache (caché de clientes), laadplan (plan de carga) y warm-hervat (reanudar la construcción) usan palabras en neerlandés como aan, uit, proef y legen. Parte de la salida también está en neerlandés.