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.

Depuis SEOPress 10.4, les abilities couvrent aussi les termes de taxonomie : catégories, étiquettes, catégories de produits WooCommerce et taxonomies personnalisées. Un agent peut lire et modifier leur balise titre, leur méta description, leurs réglages robots et sociaux, repérer les termes dont les métadonnées manquent et, avec SEOPress PRO, obtenir des suggestions IA pour eux.

Prérequis

• SEOPress (Free) 10.0 ou plus récent pour les abilities de base, 10.4 ou plus récent pour les abilities des termes de taxonomie.
• SEOPress PRO 10.0 ou plus récent pour les abilities PRO (redirections, données structurées, génération IA), 10.4 ou plus récent pour la génération IA sur les termes.
• SEOPress Insights 3.1 ou plus récent pour les abilities Insights (positions, concurrents, backlinks).
• 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. SEOPress Free et PRO partagent un interrupteur, SEOPress Insights a le sien. Activer l’un n’active pas l’autre.

SEOPress Free et PRO

1. Allez dans SEO > Réglages avancés.
2. Ouvrez l’onglet Avancé, puis la section Abilities API.
3. Activez Expose abilities to AI agents and external tools.
4. Enregistrez.

SEOPress Insights

Insights n’a pas encore d’interrupteur dans ses réglages. Activez ses abilities avec un filtre, dans le functions.php de votre thème ou dans une petite extension :

add_filter( 'seopress_insights_abilities_api_rest_enabled', '__return_true' );

Si vous utilisez uniquement Insights, sans SEOPress Free ni PRO, ce filtre suffit.

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.

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 Expose abilities to AI agents and external tools (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

Les trois abilities list-posts-* ne renvoient que les contenus que l’utilisateur connecté peut lire, 20 par page par défaut (per_page jusqu’à 100, page pour parcourir les résultats).

Free (SEOPress), termes de taxonomie : depuis SEOPress 10.4, même catégorie seopress

Les abilities des termes prennent un term_id et lisent ou écrivent les mêmes champs que la metabox SEO de l’écran de modification du terme. Elles fonctionnent sur toute taxonomie publique, sauf si Désactiver la metabox SEO est activé pour elle dans SEO > Titres & métas > Taxonomies. La liste ne renvoie que les termes des taxonomies que l’utilisateur connecté peut gérer, 20 par page par défaut (per_page jusqu’à 100).

SEOPress PRO : même catégorie seopress

SEOPress Insights : même catégorie seopress

Les capacités Insights sont les mêmes que celles qui pilotent l’accès aux écrans d’Insights. Consultez les capacités utilisateurs SEOPress & Insights pour les attribuer à un rôle.

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
• abilities destructives et idempotentes (mises à jour, suppressions) → DELETE
• tout le reste (création) → POST

L’entrée d’une ability se place toujours sous une clé input. En GET et en DELETE, passez-la en paramètres d’URL (?input[post_id]=123) ; en POST, envoyez-la dans un corps JSON ({"input": {…}}). 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 -g "https://example.com/wp-json/wp-abilities/v1/abilities/seopress/get-post-title-description/run?input[post_id]=123" \
--user "IDENTIFIANT:MOT_DE_PASSE_APPLICATION"

# Trouver les catégories de produits sans méta description (GET, lecture seule)
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 "IDENTIFIANT:MOT_DE_PASSE_APPLICATION"

# Définir la balise titre du terme 15 (DELETE, destructive + idempotente)
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]=Outils+de+jardin" \
--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 '{"input":{"origin":"/ancienne-url/","destination":"/nouvelle-url/","type":"301"}}'

# Supprimer une redirection (DELETE, destructive + idempotente)
curl -g -X DELETE "https://example.com/wp-json/wp-abilities/v1/abilities/seopress/delete-redirection/run?input[id]=42" \
--user "IDENTIFIANT:MOT_DE_PASSE_APPLICATION"

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 abilities par terme requièrent edit_term sur le terme ciblé ; les réglages globaux requièrent manage_options.
• Depuis SEOPress 10.4, les abilities qui modifient les réglages SEO d’un article ou d’un terme (update-post-*, update-term-*) refusent un rôle coché dans SEO > Réglages avancés > Sécurité > Metaboxes SEO : rôles bloqués, comme le faisaient déjà la metabox SEO et l’API REST. La lecture reste autorisée.
• Depuis SEOPress PRO 10.4, les abilities d’IA vérifient aussi les rôles de la section Génération IA du même onglet Sécurité.
• 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à 21 abilities, pour les articles, les termes de taxonomie et les réglages globaux. PRO ajoute les redirections, les données structurées, l’audit technique 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 Expose abilities to AI agents and external tools est activé et que l’utilisateur connecté peut effectuer l’action.

Une ability de terme indique que la taxonomie n’est pas prise en charge. La taxonomie n’est pas publique, ou Désactiver la metabox SEO est activé pour elle dans SEO > Titres & métas > Taxonomies. Les abilities des termes ne fonctionnent que là où la metabox SEO de l’écran de modification du terme est disponible.