API JSON admin endpoints SEO : votre score, votre cannibalisation et vos pondérations à la demande
API JSON admin endpoints SEO une fonctionnalité du module Plugins & API interne de Clustraly. Les endpoints SEO de l'API JSON admin exposent le score d'un article, un contrôle de cannibalisation de mot-clé et les dix pondérations du score.
Trois endpoints JSON lisent le même moteur de score que votre éditeur, repèrent les mots-clés en conflit et publient vos pondérations. L'IA propose, vous décidez de ce qui compte.
Le même score SEO que votre éditeur, en un appel
Interrogez GET /admin/api/seo/score/{articleId} et recevez le score calculé par SeoService::calculateScore, le moteur unifié. Il réutilise le titre, le contenu, le mot-clé focus, les mots-clés secondaires et lexicaux, le slug, la meta description et la cible de mots exactement les mêmes entrées que l'éditeur.
Résultat : aucun écart entre ce qu'un rédacteur voit à l'écran et ce que renvoie votre tableau de bord ou votre script.
- Score identique à celui de l'éditeur
- Réponse JSON prête à intégrer
- Recalcul à la demande sur n'importe quel article
Repérez deux articles qui visent le même mot-clé
Envoyez un mot-clé à POST /admin/api/seo/check-keyword : Clustraly cherche dans seo_meta tous les articles qui ciblent déjà ce même focus_keyword et vous renvoie la liste des conflits détectés. Excluez l'article en cours d'un simple id pour ne voir que les vrais doublons.
- Détecte les focus_keyword partagés
- Exclusion optionnelle de l'article courant
- Conflits renvoyés en clair, à vous d'arbitrer
Vos dix pondérations SEO, lisibles telles quelles
GET /admin/api/seo-weights renvoie les dix pondérations qui composent le score, lues depuis vos réglages avec des valeurs par défaut. Vos outils savent enfin pourquoi un score monte ou descend, et vous gardez la main sur l'importance de chaque critère.
- Dix pondérations exposées en JSON
- Lues depuis vos réglages, valeurs par défaut incluses
- Aligne vos outils sur votre barème réel
Branchez le SEO sur vos workflows, pas l'inverse
Trois endpoints, une même logique : lire, vérifier, mesurer. Déclenchez un contrôle de cannibalisation avant publication, affichez le score dans un tableau de bord externe, ou mesurez un article depuis un script d'intégration. Chaque réponse est un JSON propre, avec des codes HTTP adaptés (403, 404, 422, 500).
- Contrôle qualité avant publication
- Score exposé aux tableaux de bord et scripts
- Réponses JSON à codes HTTP clairs
Des endpoints d'administration, protégés comme tels
Les trois routes exigent la permission seo.view, et le POST de cannibalisation ajoute la protection CSRF. Elles vivent sous l'authentification de session admin et le seau de limitation de débit « api » commun à toute l'API JSON admin.
- Permission seo.view requise sur les trois routes
- CSRF sur le POST de cannibalisation
- Session admin + limitation de débit « api »
L'IA propose, vous décidez
Les endpoints SEO vous donnent le score, les conflits et les pondérations. Ils ne publient rien et ne réécrivent rien : ils éclairent vos décisions, vous gardez le dernier mot.
Questions fréquentes
Le score renvoyé par l'API est-il le même que dans l'éditeur ?
Comment fonctionne le contrôle de cannibalisation ?
Quelles permissions et protections s'appliquent à ces endpoints ?
Que contient l'endpoint des pondérations ?
Fonctionnalités liées
Découverte & liste des plugins
Scanner • Lister • Afficher statut • Afficher badges
DécouvrirValidation de manifeste & confinement de namespace
Valider • Confiner • Signaler erreurs
DécouvrirActivation & installation automatique
Activer • Installer • Migrer • Vérifier version CMS • Rejeter conflit • Journali
DécouvrirLe SEO de Clustraly, ouvert à vos outils
Score, cannibalisation, pondérations : trois endpoints JSON exposent le cœur SEO de Clustraly à vos scripts, vos tableaux de bord et vos contrôles avant publication avec le même moteur que l'éditeur et les mêmes garde-fous que le reste de l'API JSON admin.