---
title: Utiliser les abilities SEOPress (Free et PRO)
url: "https://www.seopress.org/fr/support/guides/abilities-seopress/"
lang: fr-FR
updated: 2026-06-18
---

# Utiliser les abilities SEOPress (Free et PRO)

## Que sont les abilities SEOPress ?

SEOPress 10 enregistre un ensemble d’**abilities** sur la nouvelle [WordPress Abilities API](https://developer.wordpress.org/news/2025/11/introducing-the-wordpress-abilities-api/). Une ability est une action clairement définie (par exemple « lire la balise titre d’un article » ou « créer une redirection ») que les assistants IA et les outils d’automatisation peuvent découvrir et exécuter en toute sécurité, vos permissions WordPress existantes étant toujours respectées.

Concrètement, cela vous permet de connecter un agent IA (comme Claude, ou n’importe quel outil compatible MCP) à votre site et de le laisser réaliser vos tâches SEO à votre place, au lieu de naviguer manuellement dans les écrans.

## Prérequis

- SEOPress (Free) **10.0** ou plus récent pour les abilities de base.
- **SEOPress PRO 10.0** ou plus récent pour les abilities PRO (redirections, données structurées, génération IA).
- **WordPress 6.9 ou plus récent** (l’Abilities API fait partie du cœur de WordPress à partir de cette version).
- Une méthode d’authentification pour les appels externes (nous recommandons les **mots de passe d’application**).
- Pour les abilities de génération IA : un fournisseur d’IA configuré ou **SEOPress AI Credits**.

## Activer les abilities via l’API REST

Les abilities sont **désactivées par défaut**. Pour permettre à un agent externe d’y accéder :

1. Allez dans **SEO > Réglages avancés**.
2. Ouvrez l’onglet **Avancé**.
3. Activez **Exposer les capacités via l’API REST**.
4. Enregistrez.

Une fois activées, les abilities deviennent accessibles sous l’espace de noms REST `/wp-abilities/v1/`, pour tout utilisateur déjà autorisé à effectuer l’action concernée.

> L’**AI Assistant** dans l’éditeur (SEOPress PRO) utilise ces abilities en interne et ne nécessite **pas** ce réglage. Il vous sert uniquement à connecter un agent **externe**.

## Rendre votre site « prêt pour les agents » (PRO)

SEOPress PRO peut exposer des signaux de découverte pour que les outils d’IA trouvent et comprennent votre contenu par eux-mêmes. Activez **Agent Readiness** (dans les fonctionnalités Techniques) pour publier une carte de serveur MCP (`/.well-known/mcp.json`), un fichier `llms.txt` et d’autres points d’accès `/.well-known/`.

## Connecter un agent IA (MCP)

1. Activez **Exposer les capacités via l’API REST** (et, sur PRO, **Agent Readiness**).
2. Créez un **mot de passe d’application** pour l’utilisateur WordPress sous l’identité duquel l’agent agira (**Comptes > Profil > Mots de passe d’application**).
3. Dans votre client compatible MCP, pointez-le vers votre site et authentifiez-vous avec cet identifiant et ce mot de passe d’application.
4. Le client découvre automatiquement les abilities disponibles et les exécute pour vous.

L’agent ne peut jamais faire plus que ce que cet utilisateur est autorisé à faire. Pour limiter sa portée, connectez-le avec un utilisateur au rôle restreint.

## Abilities disponibles

**Free (SEOPress)** — catégorie `seopress`

| Ability | Rôle | Capability |
| --- | --- | --- |
| `seopress/get-post-title-description` | Lire la balise titre et la méta description d’un article | `edit_post` |
| `seopress/update-post-title-description` | Définir ou effacer la balise titre et la méta description | `edit_post` |
| `seopress/get-post-robots-settings` | Lire les règles d’indexation (noindex, nofollow, canonical…) | `edit_post` |
| `seopress/update-post-robots-settings` | Mettre à jour les règles d’indexation | `edit_post` |
| `seopress/get-post-social-settings` | Lire les métadonnées sociales Facebook et X | `edit_post` |
| `seopress/update-post-social-settings` | Mettre à jour les métadonnées sociales | `edit_post` |
| `seopress/analyze-post-content` | Lancer l’analyse de contenu (score et vérifications) | `edit_post` |
| `seopress/get-global-titles-settings` | Lire les modèles de titres et métas du site | `manage_options` |

**SEOPress PRO** — même catégorie `seopress`

| Ability | Rôle | Capability |
| --- | --- | --- |
| `seopress/list-redirections` | Lister les redirections et les 404 détectées | `read_redirection` |
| `seopress/get-redirection` | Récupérer une redirection par son ID | `read_redirection` |
| `seopress/create-redirection` | Créer une redirection (301/302/307/410/451) | `publish_redirections` |
| `seopress/update-redirection` | Mettre à jour une redirection | `edit_redirection` |
| `seopress/delete-redirection` | Supprimer une redirection | `delete_redirection` |
| `seopress/get-post-schemas` | Lire les données structurées (schema) d’un article | `edit_post` |
| `seopress/update-post-schemas` | Remplacer les données structurées d’un article | `edit_post` |
| `seopress/update-target-keywords` | Définir les mots-clés cibles de l’analyse de contenu | `edit_post` |
| `seopress/generate-seo-title` | Générer une balise titre optimisée par l’IA | `edit_post` |
| `seopress/generate-meta-description` | Générer une méta description optimisée par l’IA | `edit_post` |
| `seopress/generate-alt-text` | Générer le texte alternatif d’une image par l’IA | `edit_post` |
| `seopress/upload-image` | Importer une image externe dans la médiathèque | `upload_files` |

> Les quatre abilities d’IA (`generate-*`) nécessitent un fournisseur d’IA configuré ou SEOPress AI Credits.

## Pour les développeurs

Trois routes REST sont disponibles :

- `GET /wp-json/wp-abilities/v1/abilities` — lister toutes les abilities
- `GET /wp-json/wp-abilities/v1/abilities/<name>` — la définition d’une ability
- `…/abilities/<name>/run` — exécuter une ability

WordPress impose la méthode HTTP à partir des annotations de l’ability :

- abilities **en lecture seule** → **GET** (passez l’entrée en paramètres d’URL)
- abilities **destructives et idempotentes** (mises à jour, suppressions) → **DELETE**
- tout le reste (création) → **POST**

L’endpoint de liste renvoie l’URL `run` exacte de chaque ability ; les clients MCP choisissent donc la bonne méthode automatiquement.

```
# Lister toutes les abilities
curl https://example.com/wp-json/wp-abilities/v1/abilities \
--user "IDENTIFIANT:MOT_DE_PASSE_APPLICATION"

# Lire la balise titre et la méta description d'un article (GET, lecture seule)
curl "https://example.com/wp-json/wp-abilities/v1/abilities/seopress/get-post-title-description/run?post_id=123" \
--user "IDENTIFIANT:MOT_DE_PASSE_APPLICATION"

# Créer une redirection (POST)
curl -X POST https://example.com/wp-json/wp-abilities/v1/abilities/seopress/create-redirection/run \
--user "IDENTIFIANT:MOT_DE_PASSE_APPLICATION" \
-H "Content-Type: application/json" \
-d '{"origin":"/ancienne-url/","destination":"/nouvelle-url/","type":"301"}'

# Supprimer une redirection (DELETE, destructive + idempotente)
curl -X DELETE https://example.com/wp-json/wp-abilities/v1/abilities/seopress/delete-redirection/run \
--user "IDENTIFIANT:MOT_DE_PASSE_APPLICATION" \
-H "Content-Type: application/json" \
-d '{"id":42}'
```

## Permissions et sécurité

- Les abilities sont **désactivées par défaut** ; vous les activez d’un simple interrupteur.
- Chaque appel s’exécute sous l’identité de l’**utilisateur authentifié** et revérifie ses capabilities WordPress. Un agent ne peut jamais les dépasser.
- Les abilities par article requièrent `edit_post` sur l’article ciblé ; les réglages globaux requièrent `manage_options`.
- Utilisez les **mots de passe d’application** et connectez les agents avec un **utilisateur au privilège minimal**.

## FAQ

**Ai-je besoin de SEOPress PRO ?** Non. La version gratuite expose déjà 8 abilities. PRO ajoute les redirections, les données structurées et la génération IA.

**Un agent va-t-il modifier des choses sans demander ?** Via REST, un agent autorisé exécute ce qu’on lui demande. Dans l’éditeur, l’**AI Assistant** propose les modifications pour validation avant de les appliquer.

**Une ability renvoie « not found ».** Vérifiez que **Exposer les capacités via l’API REST** est activé et que l’utilisateur connecté peut effectuer l’action.