---
title: Usar las abilities de SEOPress (Free y PRO)
url: "https://www.seopress.org/es/soporte/guias/abilities-de-seopress/"
lang: es
updated: 2026-06-18
---

# 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](https://developer.wordpress.org/news/2025/11/introducing-the-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.
