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).
  • SEOPress Insights 3.1 o posterior para las abilities de Insights (posiciones, competidores, backlinks).
  • 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. SEOPress Free y PRO comparten un interruptor; SEOPress Insights tiene el suyo. Activar uno no activa el otro.

SEOPress Free y PRO

  1. Ve a SEO > Ajustes avanzados.
  2. Abre la pestaña Avanzado y luego la sección Abilities API.
  3. Activa Expose abilities to AI agents and external tools.
  4. Guarda.

SEOPress Insights

Insights todavía no tiene un interruptor en sus ajustes. Active sus abilities con un filtro, en el functions.php de su tema o en una pequeña extensión:

add_filter( 'seopress_insights_abilities_api_rest_enabled', '__return_true' );

Si solo usa Insights, sin SEOPress Free ni PRO, este filtro es todo lo que necesita.

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
seopress/get-technical-audit Leer la auditoría técnica del sitio (problemas detectados y su gravedad) manage_options

Las cuatro abilities de IA (generate-*) requieren un proveedor de IA configurado o SEOPress AI Credits.

SEOPress Insights — misma categoría seopress

Ability Qué hace Capacidad
seopress/get-insights-dashboard Leer el escritorio de Insights: resumen de indicadores, tendencia de posiciones, mayores subidas y bajadas, distribución de posiciones, palabras clave favoritas y resumen de backlinks seopress_insights_manage_dashboard
seopress/get-keyword-rankings Leer las posiciones de las palabras clave seguidas, sus variaciones, los volúmenes de búsqueda y las series del gráfico seopress_insights_manage_rankings
seopress/get-competitor-rankings Leer las posiciones de los competidores junto a las suyas seopress_insights_manage_rankings
seopress/list-backlinks Leer sus backlinks con sus puntuaciones de Majestic Citation Flow y Trust Flow seopress_insights_manage_backlinks

Las abilities de Insights son de solo lectura: un agente puede analizar sus datos de seguimiento pero nunca modificarlos. Las tres abilities de posiciones y de escritorio aceptan un start_date y un end_date opcionales (marcas de tiempo Unix), además de un array keyword_ids para limitar el resultado a determinadas palabras clave seguidas.

Las capacidades de Insights son las mismas que controlan el acceso a las pantallas de Insights. Consulte las capacidades de usuario de SEOPress e Insights para asignarlas a un perfil.

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.