¿Qué son las abilities de SEOPress?
SEOPress 10 registra un conjunto de abilities en la nueva . Una ability es una acción claramente definida (por ejemplo «leer el título SEO de una entrada» o «crear una redirección») que los asistentes de IA y las herramientas de automatización pueden descubrir y ejecutar de forma segura, respetando siempre tus permisos de WordPress existentes.
En la práctica, esto te permite conectar un agente de IA (como Claude, o cualquier herramienta compatible con MCP) a tu sitio y dejar que se encargue de tus tareas SEO, en lugar de hacerlo a mano pantalla por pantalla.
Requisitos
- SEOPress (gratis) 10.0 o posterior para las abilities básicas.
- SEOPress PRO 10.0 o posterior para las abilities PRO (redirecciones, datos estructurados, generación con IA).
- WordPress 6.9 o posterior (la Abilities API forma parte del núcleo de WordPress desde esta versión).
- Un método de autenticación para las llamadas externas (recomendamos las contraseñas de aplicación).
- Para las abilities de generación con IA: un proveedor de IA configurado o SEOPress AI Credits.
Activar las abilities a través de la API REST
Las abilities están desactivadas por defecto. Para permitir que un agente externo acceda a ellas:
- Ve a SEO > Ajustes avanzados.
- Abre la pestaña Avanzado.
- Activa Exponer las capacidades a través de la API REST.
- Guarda.
Una vez activadas, las abilities quedan accesibles bajo el espacio de nombres REST /wp-abilities/v1/, para cualquier usuario que ya esté autorizado a realizar la acción correspondiente.
El AI Assistant del editor (SEOPress PRO) usa estas abilities internamente y no requiere esta opción. Solo la necesitas para conectar un agente externo.
Prepara tu sitio para los agentes (PRO)
SEOPress PRO puede exponer señales de descubrimiento para que las herramientas de IA encuentren y entiendan tu contenido por sí solas. Activa Agent Readiness (en las funciones Técnicas) para publicar una tarjeta de servidor MCP (), un archivo llms.txt y otros endpoints /.well-known/.
Conectar un agente de IA (MCP)
- Activa Exponer las capacidades a través de la API REST (y, en PRO, Agent Readiness).
- Crea una contraseña de aplicación para el usuario de WordPress con cuya identidad actuará el agente (Usuarios > Perfil > Contraseñas de aplicación).
- En tu cliente compatible con MCP, apúntalo a tu sitio y autentícate con ese nombre de usuario y esa contraseña de aplicación.
- El cliente descubre automáticamente las abilities disponibles y las ejecuta por ti.
El agente nunca puede hacer más de lo que ese usuario tiene permitido. Para limitar su alcance, conéctalo con un usuario de rol restringido.
Abilities disponibles
Gratis (SEOPress) — categoría seopress
| Ability | Qué hace | Capacidad |
|---|---|---|
seopress/get-post-title-description |
Leer el título SEO y la meta descripción de una entrada | edit_post |
seopress/update-post-title-description |
Definir o borrar el título SEO y la meta descripción | edit_post |
seopress/get-post-robots-settings |
Leer las directivas de indexación (noindex, nofollow, canonical…) | edit_post |
seopress/update-post-robots-settings |
Actualizar las directivas de indexación | edit_post |
seopress/get-post-social-settings |
Leer los metadatos sociales de Facebook y X | edit_post |
seopress/update-post-social-settings |
Actualizar los metadatos sociales | edit_post |
seopress/analyze-post-content |
Ejecutar el análisis de contenido (puntuación y comprobaciones) | edit_post |
seopress/get-global-titles-settings |
Leer las plantillas de títulos y metas del sitio | manage_options |
SEOPress PRO — misma categoría seopress
| Ability | Qué hace | Capacidad |
|---|---|---|
seopress/list-redirections |
Listar las redirecciones y los 404 detectados | read_redirection |
seopress/get-redirection |
Obtener una redirección por su ID | read_redirection |
seopress/create-redirection |
Crear una redirección (301/302/307/410/451) | publish_redirections |
seopress/update-redirection |
Actualizar una redirección | edit_redirection |
seopress/delete-redirection |
Eliminar una redirección | delete_redirection |
seopress/get-post-schemas |
Leer los datos estructurados (schema) de una entrada | edit_post |
seopress/update-post-schemas |
Reemplazar los datos estructurados de una entrada | edit_post |
seopress/update-target-keywords |
Definir las palabras clave objetivo del análisis de contenido | edit_post |
seopress/generate-seo-title |
Generar un título SEO optimizado por IA | edit_post |
seopress/generate-meta-description |
Generar una meta descripción optimizada por IA | edit_post |
seopress/generate-alt-text |
Generar el texto alternativo de una imagen por IA | edit_post |
seopress/upload-image |
Importar una imagen externa a la biblioteca de medios | upload_files |
Las cuatro abilities de IA (
generate-*) requieren un proveedor de IA configurado o SEOPress AI Credits.
Para desarrolladores
Hay tres rutas REST disponibles:
GET /wp-json/wp-abilities/v1/abilities— listar todas las abilitiesGET /wp-json/wp-abilities/v1/abilities/<name>— la definición de una ability…/abilities/<name>/run— ejecutar una ability
WordPress impone el método HTTP a partir de las anotaciones de la ability:
- abilities de solo lectura → GET (pasa la entrada como parámetros de URL)
- abilities destructivas e idempotentes (actualizaciones, eliminaciones) → DELETE
- el resto (creación) → POST
El endpoint de listado devuelve la URL run exacta de cada ability, por lo que los clientes MCP eligen el método correcto automáticamente.
# Listar todas las abilities
curl https://example.com/wp-json/wp-abilities/v1/abilities \
--user "USUARIO:CONTRASENA_DE_APLICACION"
# Leer el título SEO y la meta descripción de una entrada (GET, solo lectura)
curl "https://example.com/wp-json/wp-abilities/v1/abilities/seopress/get-post-title-description/run?post_id=123" \
--user "USUARIO:CONTRASENA_DE_APLICACION"
# Crear una redirección (POST)
curl -X POST https://example.com/wp-json/wp-abilities/v1/abilities/seopress/create-redirection/run \
--user "USUARIO:CONTRASENA_DE_APLICACION" \
-H "Content-Type: application/json" \
-d '{"origin":"/url-antigua/","destination":"/url-nueva/","type":"301"}'
# Eliminar una redirección (DELETE, destructiva + idempotente)
curl -X DELETE https://example.com/wp-json/wp-abilities/v1/abilities/seopress/delete-redirection/run \
--user "USUARIO:CONTRASENA_DE_APLICACION" \
-H "Content-Type: application/json" \
-d '{"id":42}'
Permisos y seguridad
- Las abilities están desactivadas por defecto; las activas con un solo interruptor.
- Cada llamada se ejecuta con la identidad del usuario autenticado y vuelve a comprobar sus capacidades de WordPress. Un agente nunca puede superarlas.
- Las abilities por entrada requieren
edit_postsobre la entrada de destino; los ajustes globales requierenmanage_options. - Usa contraseñas de aplicación y conecta los agentes con un usuario con el mínimo privilegio.
Preguntas frecuentes
¿Necesito SEOPress PRO? No. El plugin gratuito ya expone 8 abilities. PRO añade redirecciones, datos estructurados y generación con IA.
¿Un agente cambiará cosas sin preguntar? A través de REST, un agente autorizado ejecuta lo que se le pide. En el editor, el AI Assistant propone los cambios para que los revises antes de aplicarlos.
Una ability devuelve «not found». Comprueba que Exponer las capacidades a través de la API REST está activado y que el usuario conectado puede realizar la acción.