Ouvrir le Studio

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

Node YourText Guru score calibre contenus francophones grille qualité française pipeline

À 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

Paramètres score YourText Guru rubriques pondération références corpus française benchmarking

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.

Tip

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 ?

  1. Tirez un lien depuis le port Score vers le node suivant.
  2. Dans ce node, créez un nom de variable (par exemple, score_json).
  3. Utilisez un JSON Path Extractor ou un LLM en aval pour lire des champs comme score, danger ou analyze.
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 = 123456
  • Content = sortie d’un node LLM amont
  • YourText.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 = 123456
  • Content = brouillon courant
  • Le Conditional en aval lit score_json.score et score_json.danger et 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

Tip

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.

Warning

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