YourText.Guru Score
Le node YourText.Guru Score analyse un contenu par rapport à un guide YourText.Guru et retourne ses scores SEO (SOSEO) et de sur-optimisation (DSEO).
À quoi sert le node YourText.Guru Score ?
Le node YourText.Guru Score appelle le endpoint YourText.Guru guides/{guideId}/check pour évaluer un contenu par rapport à un guide existant. Il retourne le score SEO (SOSEO), le score de sur-optimisation (DSEO), les fourchettes cibles recommandées par YourText.Guru, ainsi qu’une analyse terme à terme de la couverture des mots du guide dans le texte.
Cas d’usage typiques :
- Auditer un article généré par un LLM avant de le publier sur un CMS.
- Itérer sur un brouillon jusqu’à ce que le SOSEO atteigne la fourchette cible tout en gardant un DSEO bas.
- Scorer plusieurs variantes d’un contenu en lot pour choisir la meilleure version.
Configuration rapide
Connecter une intégration YourText.Guru
Ouvrez les paramètres du node et sélectionnez une Intégration YourText.Guru existante, ou créez-en une depuis la page Intégrations avec votre clé API YourText.Guru.
Ajouter le node au canevas
Ouvrez la bibliothèque de nodes, naviguez dans Integrations > SEO Tools > YourText.Guru, puis glissez-déposez le node YourText.Guru Score sur votre workflow.
Fournir l’ID du guide et le contenu
Reliez les ports d’entrée Guide ID et Content à des nodes amont (par exemple un Text Input contenant l’ID du guide et un LLM produisant l’article).
Connecter la sortie
Reliez la sortie Score au node suivant (LLM, JSON Path Extractor, Sheets Writer) et créez-y un nom de variable pour exploiter le JSON.
Paramètres de configuration
Définissez comment le node s’authentifie et ce qu’il analyse.
Champs requis
Name string required default: YourText.Guru Score Nom du node — Permet d’identifier le node dans le canevas et dans les logs d’exécution (par exemple, Score article v3).
Description string required default: Analyze SEO Score and Danger with YourText.Guru Description du node — Phrase courte décrivant le rôle de cette instance.
Guide ID string required Identifiant du guide YourText.Guru — ID du guide servant de référence pour le score. Il doit provenir d’un guide créé au préalable sur YourText.Guru (typiquement renvoyé par le node YourText.Guru Keywords).
Content string required Texte à scorer — Article ou bloc de texte complet à évaluer. Le texte brut est attendu ; le HTML est accepté mais compte comme du contenu.
YourText.Guru Integration integration required Compte YourText.Guru — Intégration qui détient la clé API YourText.Guru utilisée pour l’appel. Requis pour authentifier la requête.
Réutilisez le même Guide ID sur plusieurs nodes Score pour comparer différentes versions d’un même article sans consommer un crédit de guide supplémentaire.
Que renvoie le node ?
Le node renvoie une chaîne JSON contenant les scores SOSEO et DSEO, les fourchettes cibles recommandées par le guide, et une ventilation terme à terme.
Comment récupérer l’output ?
- Tirez un lien depuis le port
Scorevers le node suivant. - Dans ce node, créez un nom de variable (par exemple,
score_json). - Utilisez un JSON Path Extractor ou un LLM en aval pour lire des champs comme
score,dangerouanalyze.
Score string Chaîne JSON contenant score (SOSEO), danger (DSEO), target_soseo_min, target_soseo_max, target_dseo_min, target_dseo_max, et analyze (objet de couverture terme à terme renvoyé par le guide).
Exemples d’utilisation
Cas 1 : Scorer un article généré par un LLM
Scorez un article produit par un LLM par rapport à un guide existant et n’envoyez le résultat au node suivant que si le SOSEO est suffisamment haut.
Configuration :
Guide ID=123456Content= sortie d’un node LLM amontYourText.Guru Integration= votre compte YourText.Guru
Sortie générée :
{
"score": 78,
"danger": 12,
"target_soseo_min": 70,
"target_soseo_max": 85,
"target_dseo_min": 0,
"target_dseo_max": 25,
"analyze": {
"content strategy": 3,
"audience": 2,
"keyword research": 1
}
}
Cas 2 : Itérer sur un brouillon jusqu’à atteindre la cible
Utilisez un node Conditional en aval pour boucler vers le LLM tant que score est sous target_soseo_min ou que danger dépasse target_dseo_max.
Configuration :
Guide ID=123456Content= brouillon courant- Le Conditional en aval lit
score_json.scoreetscore_json.dangeret décide s’il faut régénérer.
Ce schéma permet d’optimiser le contenu de manière itérative sans relecture manuelle.
Problèmes courants
YourText.Guru Score : Integration not configured
Cause : Aucune intégration YourText.Guru n’est sélectionnée sur le node.
Solution : Ouvrez les paramètres du node et choisissez une intégration valide dans le champ YourText.Guru Integration, ou créez-en une depuis la page Intégrations avec votre clé API YourText.Guru.
YourText.Guru Score : No guide ID
Cause : L’entrée Guide ID est vide.
Solution : Reliez un node amont qui produit l’ID du guide (par exemple le node YourText.Guru Keywords) ou collez un ID de guide valide.
YourText.Guru Score : No content
Cause : L’entrée Content est vide.
Solution : Reliez un node amont qui produit le texte à scorer (LLM, Text Input, HTML to Markdown).
YourText.Guru Score : Not enough tokens on your Text Guru account
Cause : Le compte YourText.Guru lié à l’intégration n’a plus de crédits (HTTP 550).
Solution : Rechargez votre compte YourText.Guru ou utilisez une autre intégration disposant de crédits.
YourText.Guru Score : Invalid metadata. Reconnect the YourText.Guru integration
Cause : L’enregistrement d’intégration existe mais la clé API est manquante ou invalide.
Solution : Ouvrez la page Intégrations et reconnectez l’intégration YourText.Guru avec une clé API à jour.
Bonnes pratiques et pièges à éviter
Associez ce node à YourText.Guru Keywords dans le même workflow : le node Keywords crée le guide et expose son ID, le node Score le consomme.
Chaque appel à ce node consomme un crédit YourText.Guru. Évitez de le placer dans une boucle serrée sans condition de sortie ; mettez en cache le résultat quand c’est possible.
Comment s’intègre-t-il dans un workflow ?
YourText.Guru Score se place typiquement entre un node de génération de contenu et un node de décision ou de stockage.
graph LR
Kw[YourText.Guru Keywords] --> LLM[LLM rédige l'article]
LLM --> Score[YourText.Guru Score]
Score --> Cond[Conditional vérifie le score]
Cond --> Sheets[Sheets Writer]
Nodes complémentaires
Génère le guide et le jeu de mots-clés utilisés en entrée du node Score.
Produit le texte de l’article à scorer, et reboucle si le score est trop bas.
Extrayez score, danger ou les valeurs terme à terme depuis le JSON renvoyé.
Branchez le workflow selon que le score atteint ou non la fourchette cible.