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
- 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 : OFFLINEes 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
- 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.Conwp spark-speed statusverá cómoCached pagesdisminuye. - 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 --ally después conwp spark-speed warm.
wp spark-speed flush-object-cache
- 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
- 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
--pagecon una dirección completa de este sitio, sin cadena de consulta. Sin--pageel 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
- 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--allpone en la cola todas las páginas del sitio; el trabajo real lo hace después conprocessowarm. - Cuándo usarlo
- Tras una purga, o si quiere tener una página importante lista de inmediato.
- Requisitos
- Utilice
--page, no--url:--urlya está ocupado en WP-CLI. - Cómo comprobar el efecto
- Una línea por dispositivo con el resultado, por ejemplo
oko el motivo por el que no funcionó. Con--allverá 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
- 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
- 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
--waitespera 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
- 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
--jsonobtiene 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
- 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 advertenciaNiet hervat: <reason>(código de salida 1). Después, compruebe conwarm-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
- 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.proefejecuta la prueba.aanactiva la función yuitla 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.
aansolo funciona tras una prueba satisfactoria, o con--bevestigddespué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
--bevestigduna 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
- 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) ylegen(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,
aanse 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.oKlantcache uit en geleegd., y constatusuna línea constand,sessies met eigen kopieenykan 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
- 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.
kandidatenmuestra 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.aanyuitactivan o desactivan el plan.statusmuestra el estado. - Cuándo usarlo
- Cuando un plugin carga en el front end mucho código que sus visitantes no necesitan.
- Requisitos
weglatensolo se permite tras una prueba con resultadogelijk, o con--bevestigddespué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 voorkanty 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>owp 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
- 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 converify-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
- 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.oFont 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
- 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
- Qué hace
- Muestra qué debe cargarse antes del LCP (la ruta crítica). Con
--fileanaliza 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--pageobtiene 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.
--pagesolo 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
- 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
- Qué hace
- Gestiona las claves MCP desde la línea de comandos.
createcrea una clave nueva y la muestra una sola vez.listmuestra las claves sin el secreto.revoke <id>revoca una clave. Con--labelda 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.createse 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
listmuestra 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
- 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 unchange_id. La propuesta procede de--fileo 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,rejectedynext_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_changecon elchange_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
- 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 cabeceraX-Spark-Tokeno 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
- 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
- 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
- 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
- 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
- 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
- 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
measurerealiza 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
measurela 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
- 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
- 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: falsesi 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
- Qué hace
- Devuelve los cambios realizados mediante MCP o
ai apply, conchange_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_idpararevert_change. - Requisitos
- Opcionalmente
limitde 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
- 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_idy el estado. Siga la ronda conget_optimization_statusy 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
- 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. Condry_runve primero qué cambiaría. Cada cambio real recibe unchange_idy 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
changesy unreasonde una frase. Solo ajustes deget_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) yrejected. 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_changecon elchange_id.
revert_change
- Qué hace
- Revierte un cambio anterior de
apply_configoai 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éaselist_changes). Solo se conocen los últimos 30 cambios realizados mediante MCP o WP-CLI. - Cómo comprobar el efecto
- JSON con
reverted,restoredyleft_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
- 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
purgedcon la dirección oall. - 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é.
Continuar en la documentación
Todas las instrucciones están en la página de documentación de Spark Speed.
¿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.