Saltar al contenido Saltar a la navegación
De vuelta al soporte principal

Usar las abilities de SEOPress (Free y PRO)

¿Qué son las abilities de SEOPress?

SEOPress 10 registra un conjunto de abilities en la nueva WordPress Abilities API. 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:

  1. Ve a SEO > Ajustes avanzados.
  2. Abre la pestaña Avanzado.
  3. Activa Exponer las capacidades a través de la API REST.
  4. 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 (/.well-known/mcp.json), un archivo llms.txt y otros endpoints /.well-known/.

Conectar un agente de IA (MCP)

  1. Activa Exponer las capacidades a través de la API REST (y, en PRO, Agent Readiness).
  2. 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).
  3. 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.
  4. 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 abilities
  • GET /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_post sobre la entrada de destino; los ajustes globales requieren manage_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.