Usar CMS AI Agent con WordPress

Todo lo que necesitas para WordPress, en el orden en el que lo vas a hacer de verdad. Si te atascas, la última sección trae los mensajes de error reales y qué significa cada uno.

Activa esto primero

  • Una cuenta en el sitio web con permisos de Editor o Administrador. Crea una aparte para CMS AI Agent en vez de usar la tuya: así podrás quitarla después sin tocar nada más.
  • Una contraseña de aplicación, creada en Usuarios → Perfil de tu propio sitio web. No es tu contraseña de acceso: es otra distinta que solo sirve para esto, y puedes retirarla cuando quieras sin cambiar nada más.
  • La API REST de WordPress accesible desde fuera. Viene activada, pero algunos plugins de seguridad y algunos alojamientos la apagan o la bloquean. Si es tu caso, permite las peticiones a /wp-json/ antes de empezar.

Conectar tu sitio web

  1. En CMS AI Agent, añade tu sitio web por su dirección: la misma que escribes en el navegador, con https:// incluido.
  2. Comprobamos la dirección y te decimos qué hemos encontrado: que es WordPress, qué versión, y que su API REST responde.
  3. Escribe el usuario y la contraseña de aplicación que creaste. Puedes dejar los espacios: WordPress la muestra en bloques de cuatro y funciona de las dos formas.
  4. Elige qué puede hacer la conexión: solo leer, escribir borradores, cambiar el SEO. Nunca es «todo», y puedes cambiarlo después.
  5. Instala el plugin WordPress AI Agent en tu sitio web. Este paso es opcional y puedes dejarlo para luego: sin él funciona todo lo que ofrece la propia API REST de WordPress, y con él funcionan además las pocas cosas que el núcleo no expone.

Qué puedes pedir en WordPress

  • Leer el contenido

    Mirar lo que ya hay en el sitio web: la lista de páginas y entradas, quién escribió cada una, cuándo cambió por última vez, si está publicada, y el texto completo de cualquiera de ellas.

    «¿Qué páginas no se han tocado en más de un año?»

  • Crear contenido

    Añadir algo que antes no existía: una página nueva, una entrada nueva, una ficha del tipo que use tu sitio web. Llega como borrador, con título, texto y un resumen corto, listo para que lo leas antes de que lo vea nadie más.

    «Añade una página sobre nuestro nuevo horario y déjala como borrador.»

  • Editar contenido

    Cambiar algo que ya está ahí: el título, el texto, el resumen. Se te dice exactamente qué elementos se han tocado, y tu sitio web conserva su propio historial de lo que decían antes.

    «Cambia el teléfono de la página de Contacto por el nuevo.»

  • Publicar contenido

    Mover algo entre borrador, publicado y privado. Este es el paso que decide si el público puede ver una página, y por eso es algo que se pide a propósito y no algo que ocurre de pasada.

    «Publica el borrador del mercado del sábado.»

  • Programar publicaciones

    Poner una fecha y una hora futuras para que algo aparezca, de modo que una entrada escrita un martes por la tarde salga el lunes por la mañana sin que nadie esté delante del teclado.

    «Programa la entrada del horario de Navidad para el uno de diciembre.»

  • Gestionar imágenes y archivos

    Subir imágenes y archivos al sitio web y rellenar el texto que va con ellos: el título, el pie de foto y el texto alternativo que lee un lector de pantalla y que un buscador lee en lugar de la imagen.

    «Sube las fotos de la semana pasada a la galería y escribe el texto alternativo de cada una.»

  • Gestionar categorías y etiquetas

    Ordenar el contenido para que la gente lo encuentre: en qué categoría está una entrada, qué etiquetas lleva, y crear una categoría o etiqueta nueva cuando hace falta de verdad.

    «Pon todas las entradas de recetas en la categoría Recetas.»

  • Editar la información SEO

    El texto que no se ve en la página pero decide cómo se ve la página en un resultado de búsqueda y cuando alguien la comparte: el título SEO, la descripción de debajo y el texto alternativo de las imágenes.

    «¿Qué páginas no tienen descripción SEO? Escribe una para cada una.»

  • Gestionar los menús

    Los menús en los que hace clic un visitante: añadir una entrada, cambiarle el nombre, ponerlas en otro orden, meter una debajo de otra.

    «Añade la nueva página de Horario al menú principal, después de Contacto.»

  • Tipos de contenido propios

    Pocos sitios web tienen solo páginas y entradas. Una inmobiliaria tiene inmuebles, un restaurante tiene platos, una escuela tiene cursos. Esto es trabajar con esos, en sus propios campos, en vez de obligar a que todo sea una entrada de blog.

    «Añade un plato nuevo a la carta: el nombre, la descripción y el precio.»

  • Información del sitio

    Los datos llanos del sitio web: cómo se llama, con qué software y qué versión funciona, cuántas páginas y entradas tiene, en qué idiomas está escrito y cuándo cambió por última vez.

    «¿Cuántas páginas tiene mi sitio web y cuándo se actualizó cada una?»

  • Información de administración

    Qué hay instalado, qué tiene una actualización pendiente y quién tiene cuenta en el sitio web. Solo lectura: no instala, actualiza, activa ni elimina plugins o temas, no cambia ajustes y no añade ni modifica usuarios.

    «¿Hay algo en mi sitio web esperando una actualización?»

Qué no va a hacer en WordPress

WordPress no tiene forma de hacer esto, así que este agente no lo ofrece. Lo que habría significado:

  • Cambios en lote

    El mismo cambio en muchos elementos a la vez. No ocurre nada de inmediato: primero se te muestra la lista entera, con el valor actual al lado del valor propuesto, y se ejecuta solo después de que digas que sí. Se puede parar a medias y se puede deshacer.

  • Gestionar redirecciones

    Mandar una dirección antigua a una nueva, para que un enlace que alguien guardó o un resultado que sigue en Google acabe en la página correcta en vez de en un error. También puede listar todo lo que ya se está mandando a otro sitio.

Conviene saber sobre WordPress

  • Una contraseña de aplicación se retira desde Usuarios → Perfil de tu propio sitio web en cualquier momento, y la conexión deja de funcionar al instante. No necesitas que lo hagamos nosotros y no tienes que cambiar tu contraseña.
  • Todo lo que se escribe llega como borrador. Publicar es algo aparte que tú pides, así que nada de lo que escriba un asistente puede llegar al público por accidente.
  • Los campos SEO salen de Yoast o Rank Math si tienes alguno instalado, y del plugin acompañante si no. Si no hay ninguno de los dos, los campos SEO son los que guarda WordPress por su cuenta, que son menos.
  • Los plugins de seguridad son el motivo habitual de que un sitio aparentemente sano nos rechace. Wordfence, iThemes y varios alojamientos bloquean por defecto las peticiones a la API REST desde fuera, y el error lo dice cuando ocurre.

Cuando algo sale mal

Los fallos con los que se topa la gente de verdad, con las palabras exactas que te va a mostrar CMS AI Agent. El mensaje está en inglés estés donde estés, porque es lo que dice el software.

La dirección se acepta, pero la comprobación no encuentra WordPress en ella.

Lo que vas a ver

We reached the site but could not find the WordPress REST API. Check the address is right, and that the REST API has not been disabled.

Qué hacer

Abre tusitio.com/wp-json/ en el navegador. Si sale una página de datos, la API está bien y lo más probable es que la dirección que nos diste no sea la correcta: mira si falta el www, si hay una redirección a otro dominio o si el sitio vive en una subcarpeta. Si sale un error o un 404, la API REST está desactivada, casi siempre por un plugin de seguridad o por un fragmento de código del tema.

El usuario y la contraseña se rechazan, aunque son los que acabas de crear.

Lo que vas a ver

WordPress did not accept that username and application password. Create a fresh application password under Users → Profile and try again.

Qué hacer

Casi siempre es que la contraseña no es del tipo correcto. Una contraseña de aplicación se crea en Usuarios → Perfil, al final de la página, y se muestra una sola vez; tu contraseña de acceso normal no sirve aquí y nunca servirá. Crea una nueva y pégala tal cual aparece.

La cuenta entra, pero no se puede cambiar nada.

Lo que vas a ver

That account signed in, but WordPress will not let it edit content. Use an account with Editor or Administrator rights.

Qué hacer

Lo más seguro es que la cuenta sea Suscriptor, Colaborador o Autor. Dale permisos de Editor, o haz la conexión con una cuenta que ya los tenga.

El sitio responde perfectamente en el navegador, pero a nosotros nos rechaza, muchas veces con «Not Acceptable» o un 403.

Lo que vas a ver

The site answered, but something — usually a security plugin or the host's firewall — blocked us. Allow requests to the REST API, then try again.

Qué hacer

Algo delante de WordPress nos está bloqueando: un plugin de seguridad, Cloudflare o el cortafuegos del alojamiento. «Not Acceptable» en concreto suele ser ModSecurity en alojamiento compartido. Pide a tu alojamiento que permita las peticiones a /wp-json/, o añade una excepción en el plugin de seguridad.

Casi todo funciona, pero una petición concreta dice que hace falta un plugin.

Lo que vas a ver

This needs the WordPress AI Agent plugin on the website. Install it, then try again.

Qué hacer

Hay unas pocas cosas que no tienen ruta en la propia API REST de WordPress: qué necesita actualizarse, las redirecciones y algunos campos SEO. Instala el plugin WordPress AI Agent y empiezan a funcionar. Todo lo demás sigue funcionando sin él.

Más sobre WordPress AI Agent