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. 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

SEOPress PRO — même catégorie seopress

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.