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.

Desde SEOPress 10.4, las abilities también cubren los términos de taxonomía: categorías, etiquetas, categorías de producto de WooCommerce y taxonomías personalizadas. Un agente puede leer y actualizar su título SEO, su meta descripción y sus ajustes de robots y de redes sociales, encontrar los términos a los que les faltan metadatos y, con SEOPress PRO, obtener sugerencias de IA para ellos.

Requisitos

• SEOPress (gratis) 10.0 o posterior para las abilities básicas, 10.4 o posterior para las abilities de términos de taxonomía.
• SEOPress PRO 10.0 o posterior para las abilities PRO (redirecciones, datos estructurados, generación con IA), 10.4 o posterior para la generación con IA en los términos.
• 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 Exponer capacidades a agentes de IA y herramientas externas.
4. Guarda.

SEOPress Insights

Insights todavía no tiene un interruptor en sus ajustes. Activa sus abilities con un filtro, en el functions.php de tu tema o en un pequeño plugin:

add_filter( 'seopress_insights_abilities_api_rest_enabled', '__return_true' );

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

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.

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 Preparación del agente (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 capacidades a agentes de IA y herramientas externas (y, en PRO, Preparación del agente).
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 perfil restringido.

Abilities disponibles

Gratis (SEOPress): categoría seopress

Las tres abilities list-posts-* solo devuelven las entradas que el usuario conectado puede leer, 20 por página por defecto (per_page hasta 100, page para recorrer los resultados).

Gratis (SEOPress), términos de taxonomía: desde SEOPress 10.4, misma categoría seopress

Las abilities de términos reciben un term_id y leen o escriben los mismos campos que el metabox de SEO de la pantalla de edición del término. Funcionan con cualquier taxonomía pública, salvo que Desactivar caja meta de SEO esté activado para ella en SEO > Títulos y metas > Taxonomías. El listado solo devuelve los términos de las taxonomías que el usuario conectado puede gestionar, 20 por página por defecto (per_page hasta 100).

SEOPress PRO: misma categoría seopress

SEOPress Insights: misma categoría seopress

Las capacidades de Insights son las mismas que controlan el acceso a las pantallas de Insights. Consulta 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
• abilities destructivas e idempotentes (actualizaciones, eliminaciones) → DELETE
• el resto (creación) → POST

La entrada de una ability siempre va dentro de una clave input. Con GET y DELETE, pásala como parámetros de URL (?input[post_id]=123); con POST, envíala como cuerpo JSON ({"input": {…}}). 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.

# List all abilities
curl https://example.com/wp-json/wp-abilities/v1/abilities \
--user "USERNAME:APPLICATION_PASSWORD"

# Read a post's SEO title and meta description (GET, read-only)
curl -g "https://example.com/wp-json/wp-abilities/v1/abilities/seopress/get-post-title-description/run?input[post_id]=123" \
--user "USERNAME:APPLICATION_PASSWORD"

# Find the product categories without a meta description (GET, read-only)
curl -g "https://example.com/wp-json/wp-abilities/v1/abilities/seopress/list-terms-missing-metadata/run?input[taxonomy][]=product_cat&input[missing]=description" \
--user "USERNAME:APPLICATION_PASSWORD"

# Set the SEO title of term 15 (DELETE, destructive + idempotent)
curl -g -X DELETE "https://example.com/wp-json/wp-abilities/v1/abilities/seopress/update-term-title-description/run?input[term_id]=15&input[title]=Garden+tools" \
--user "USERNAME:APPLICATION_PASSWORD"

# Create a redirect (POST)
curl -X POST https://example.com/wp-json/wp-abilities/v1/abilities/seopress/create-redirection/run \
--user "USERNAME:APPLICATION_PASSWORD" \
-H "Content-Type: application/json" \
-d '{"input":{"origin":"/old-url/","destination":"/new-url/","type":"301"}}'

# Delete a redirect (DELETE, destructive + idempotent)
curl -g -X DELETE "https://example.com/wp-json/wp-abilities/v1/abilities/seopress/delete-redirection/run?input[id]=42" \
--user "USERNAME:APPLICATION_PASSWORD"

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; las abilities por término requieren edit_term sobre el término de destino; los ajustes globales requieren manage_options.
• Desde SEOPress 10.4, las abilities que modifican los ajustes SEO de una entrada o de un término (update-post-*, update-term-*) rechazan los perfiles marcados en SEO > Ajustes avanzados > Seguridad > Cajas meta de SEO: perfiles bloqueados, como ya hacían el metabox de SEO y la API REST. La lectura sigue estando permitida.
• Desde SEOPress PRO 10.4, las abilities de IA también comprueban los perfiles de Generación con IA de la misma pestaña Seguridad.
• 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 21 abilities, para las entradas, los términos de taxonomía y los ajustes globales. PRO añade redirecciones, datos estructurados, la auditoría técnica y la 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 Asistente IA propone los cambios para que los revises antes de aplicarlos.

Una ability devuelve «not found». Comprueba que Exponer capacidades a agentes de IA y herramientas externas está activado y que el usuario conectado puede realizar la acción.

Una ability de términos indica que la taxonomía no es compatible. La taxonomía no es pública, o Desactivar caja meta de SEO está activado para ella en SEO > Títulos y metas > Taxonomías. Las abilities de términos solo funcionan donde está disponible el metabox de SEO de la pantalla de edición del término.