Ouvrir le Studio

Semrush Keyword Overview

Le node Semrush Keyword Overview récupère le volume, le CPC, la concurrence, le nombre de résultats et la difficulté pour un ou plusieurs mots-clés via un compte Semrush connecté.

Node Semrush aperçu mot-clé difficulté volume intention pays device française tableau

À quoi sert le node Semrush Keyword Overview ?

Le node Semrush Keyword Overview interroge l’API Semrush pour retourner les métriques SEO clés d’un ou plusieurs mots-clés sur la base de données pays choisie. Pour chaque mot-clé soumis, il retourne une ligne contenant les colonnes sélectionnées (volume, CPC, concurrence, nombre de résultats, difficulté).

Cas d’usage typiques :

  • Qualifier une liste de mots-clés générée par un LLM avant de l’utiliser dans un brief de contenu.
  • Scorer un pool de mots-clés existant pour ne garder que les termes à fort volume et difficulté acceptable.
  • Comparer le potentiel SEO d’un même mot-clé sur plusieurs bases pays (FR, US, UK).

Configuration rapide

Suivez ces étapes pour ajouter et configurer le node Semrush Keyword Overview dans votre workflow :

Ajouter le node au canevas

Ouvrez la bibliothèque de nodes, allez dans Integrations > SEO Tools > Semrush, puis glissez-déposez le node Semrush Keyword Overview sur votre espace de travail.

Connecter une intégration Semrush

Dans les paramètres du node, sélectionnez l’Intégration Semrush à utiliser. Si aucune intégration n’est encore connectée, ajoutez-la depuis la page Integrations pour que le node puisse s’authentifier auprès de votre compte Semrush.

Fournir les mots-clés

Tapez un mot-clé par ligne dans le champ Keyword(s), ou reliez le port d’entrée à un node amont (LLM, Input texte, JSON Path Extractor) qui produit une liste de mots-clés.

Choisir la base et les colonnes

Sélectionnez la Database (Country) correspondant au domaine Google à analyser, puis cochez les Export Columns à inclure dans la réponse.

Connecter la sortie

Reliez le port de sortie au node suivant et créez une variable (par exemple keywords_data) qui recevra la réponse brute.

Paramètres de configuration

Paramètres Semrush vue mot-clé device pays fenêtre historique quotas API française

Configurer le node consiste à choisir le compte Semrush à utiliser, les mots-clés à analyser et les métriques à récupérer.

Champs requis

Name string required default: Semrush Keyword Overview

Nom du node — Utile pour identifier ce node dans un workflow qui contient plusieurs appels Semrush (ex: Semrush FR pre-check).

Description string required default: Retrieves keyword overview information via Semrush, including volume, CPC, competition, and number of results.

Description du node — Une courte phrase décrivant le rôle de cet appel Semrush.

Semrush Integration integration required

Intégration Semrush — Le compte Semrush connecté qui authentifie l’appel API. Le node échoue avec Semrush: API key not configured. Please add integration in settings. si aucune intégration n’est sélectionnée.

Database (Country) string required default: fr

Base de données pays — Base Google à interroger. Valeurs disponibles : fr (France), us (États-Unis), uk (Royaume-Uni), de (Allemagne), es (Espagne), it (Italie), nl (Pays-Bas), ca (Canada), au (Australie), br (Brésil).

Export Columns string required default: Ph,Nq,Cp,Co,Nr,Kd

Colonnes à exporter — Codes de colonnes Semrush séparés par une virgule. Codes disponibles : Ph (mot-clé), Nq (volume de recherche), Cp (CPC), Co (concurrence), Nr (nombre de résultats), Kd (difficulté du mot-clé).

Champs optionnels

Keyword(s) multilines

Mots-clés à analyser — Un mot-clé par ligne, un tableau JSON, ou une liste fournie par un node amont. Le node les joint avec ; avant d’appeler Semrush. Obligatoire en paramètre ou via le port d’entrée : le node lève Keywords are required si les deux sont vides.

Tip

Chaque mot-clé consomme entre 10 et 40 unités d’API Semrush selon les colonnes sélectionnées. Limitez Export Columns aux métriques réellement nécessaires pour maîtriser la consommation de crédits.

Que renvoie le node ?

Le node renvoie une chaîne JSON contenant les lignes retournées par Semrush. Chaque ligne associe les codes de colonnes demandés à leurs valeurs pour un mot-clé.

Comment récupérer l’output ?

  1. Tirez un lien depuis le port de sortie Keywords Data.
  2. Connectez-le au node suivant et créez une variable (par exemple keywords_data).
  3. Utilisez un JSON Path Extractor ou un LLM en aval pour parser et exploiter les métriques.
Keywords Data string

Chaîne JSON contenant les lignes Semrush, une par mot-clé, avec les colonnes définies dans Export Columns.

Exemples d’utilisation

Cas 1 : Qualifier une liste de mots-clés générée par un LLM

Vous demandez à un LLM de brainstormer 20 idées de mots-clés autour de content marketing, puis vous ne gardez que ceux au volume mensuel suffisant.

Configuration :

  • Database (Country) : us
  • Export Columns : Ph,Nq,Kd
  • Keyword(s) : connecté à la sortie du LLM

Sortie typique (parsée) :

[
  { "Ph": "content marketing", "Nq": 22000, "Kd": 72 },
  { "Ph": "content strategy", "Nq": 9900, "Kd": 65 },
  { "Ph": "content marketing tools", "Nq": 1900, "Kd": 48 }
]

Un node Filter List en aval ne garde alors que les lignes où Nq >= 1000 et Kd <= 60.

Cas 2 : Comparer un mot-clé sur plusieurs pays

Vous voulez savoir si seo audit mérite d’être ciblé en France et aux États-Unis.

Mise en place :

  • Deux nodes Semrush Keyword Overview, l’un avec Database = fr, l’autre avec Database = us.
  • Keyword(s) identique : la valeur unique seo audit dans les deux nodes.
  • Export Columns : Ph,Nq,Cp,Co.

Un node LLM en aval lit les deux sorties et recommande le marché à prioriser.

Problèmes courants

Le node échoue avec 'Semrush: API key not configured'

Cause : Aucune intégration Semrush n’est sélectionnée dans les paramètres du node.

Solution : Ouvrez Integrations dans Draft & Goal, connectez un compte Semrush, puis sélectionnez-le dans le champ Semrush Integration du node.

Le node échoue avec 'Keywords are required'

Cause : Ni le champ Keyword(s) ni le port d’entrée n’ont fourni de valeur à l’exécution.

Solution : Saisissez au moins un mot-clé dans le champ, ou vérifiez que le node amont est bien connecté au port d’entrée et émet une valeur non vide.

La sortie semble vide pour certains mots-clés

Cause : Semrush n’a pas de données pour ce mot-clé sur la base pays choisie (mot-clé très long-tail ou récent).

Solution : Relancez le node sur une autre base (par exemple us au lieu de fr), ou reformulez le mot-clé.

Bonnes pratiques et pièges à éviter

Tip

Associez ce node à un node Filter List pour ne garder que les mots-clés qui respectent vos seuils de volume et de difficulté avant de les transmettre à un générateur de brief.

Warning

Surveillez votre quota Semrush. Chaque mot-clé peut coûter jusqu’à 40 unités d’API. Lors de l’itération sur un workflow, testez sur une liste courte (3 à 5 mots-clés) avant de lancer sur des centaines.

Comment s’intègre-t-il dans un workflow ?

Semrush Keyword Overview se place typiquement entre la génération de mots-clés et la production de contenu : il ajoute les métriques SEO pour que les nodes en aval puissent prioriser, filtrer ou enrichir la liste.

graph LR
    LLM[LLM brainstorm mots-clés] --> SK[Semrush Keyword Overview]
    SK --> JPE[JSON Path Extractor]
    JPE --> FL[Filter List
<br/>seuils volume + difficulté]
    FL --> Brief[LLM rédacteur de brief]

Nodes complémentaires