Google Search Console
Le node Google Search Console récupère les données de performance de recherche — requêtes, clics, impressions, CTR et position — ventilées selon les dimensions choisies.
À quoi sert le node Google Search Console ?
Le node Google Search Console se connecte à une propriété GSC vérifiée et récupère les métriques de performance de recherche — clics, impressions, CTR et position moyenne — regroupées selon les dimensions choisies (query, page, country, device, date). Vous pouvez filtrer par URLs ou mots-clés, choisir une plage de dates prédéfinie ou personnalisée, trier et limiter la taille du résultat.
Cas d’usage typiques :
- Suivre l’évolution des positions de mots-clés dans le temps et envoyer les données à un LLM pour résumer les variations.
- Repérer des opportunités de contenu en faisant remonter les requêtes à position basse mais à forte impression.
- Surveiller les baisses de CTR sur certaines pages après une refonte ou une mise à jour de contenu.
- Construire des dashboards de performance SEO en exportant les données GSC vers BigQuery, Google Sheets ou une base de données.
- Lancer des flux batch sur plusieurs propriétés en externalisant l’intégration et le Site URL via des variables d’entrée.
Configuration rapide
Connectez un compte Google
Ouvrez Settings > Integrations, ajoutez une connexion Google et accordez le scope Search Console. La même connexion est réutilisée par tous les nodes Google Search Console de votre workspace.
Ajoutez le node sur le canvas
Dans la bibliothèque de nodes, allez dans Integrations > Google > Search Console et glissez le node sur le canvas.
Choisissez la propriété et la plage de dates
Dans les paramètres du node, sélectionnez l’Intégration Google, puis choisissez une Site URL (Property) vérifiée dans la liste déroulante de recherche. Choisissez une Date Range (par exemple last_28_days) ou personalized pour fixer explicitement les dates de début et de fin.
Choisissez les dimensions et le tri
Sélectionnez une ou plusieurs Dimensions (query, page, country, device, date). Définissez optionnellement une Sort column (clicks, impressions, ctr, position) et un Sort order. Limitez la sortie via Row limit (1 à 25 000).
Connectez les entrées et la sortie
Connectez soit une entrée Url(s) soit Keyword(s) (pas les deux — elles sont mutuellement exclusives). Connectez le port de sortie au node suivant. Définissez un nom de variable dans ce node suivant pour consommer le payload JSON.
Paramètres de configuration
Champs obligatoires
integration_id integration required Intégration Google — Connexion Google utilisée pour authentifier l’appel API. À choisir inline ou à externaliser via Use a variable for integration (fournie par un input integration_id en amont).
site_url string required Site URL (Property) — Propriété GSC vérifiée. Soit une propriété domain (sc-domain:example.com), soit une propriété URL-prefix (https://example.com/). À choisir dans la liste déroulante alimentée par votre intégration, ou à externaliser via Use variable (fournie par un input site_url en amont).
date_range string required default: last_28_days Date Range — Fenêtre prédéfinie. Une valeur parmi : last_available_day, last_7_days, last_28_days, last_3_months, last_6_months, last_12_months, last_16_months, personalized. Les données GSC sont disponibles à partir d’aujourd’hui moins 2 jours ; les données récentes peuvent être indisponibles à cause des délais de traitement de l’API.
dimensions array required default: query,page Dimensions — Une ou plusieurs valeurs parmi : query, page, country, device, date. Chaque ligne de la réponse est indexée par la combinaison de dimensions choisie.
row_limit number required default: 1000 Row limit — Nombre maximum de lignes renvoyées (1 à 25 000).
sort_order string required default: desc Sort order — asc ou desc.
Champs optionnels
start_date string Start date — Requis uniquement quand Date Range vaut personalized. Format YYYY-MM-DD. Externalisable via Use variable for start date (devient {{startDate}}, fourni au runtime par un input en amont).
end_date string End date — Requis uniquement quand Date Range vaut personalized. Format YYYY-MM-DD. Doit être supérieur ou égal à start_date. Externalisable via Use variable for end date ({{endDate}}).
sort_column string Sort column — Une valeur parmi : clicks, impressions, ctr, position. Si vide, le node renvoie les lignes dans l’ordre fourni par Google.
url multiline Url(s) — Entrée optionnelle. Une URL par ligne, ou une chaîne JSON de tableau. Filtre le rapport sur les pages listées. Mutuellement exclusif avec Keyword(s).
keywords multiline Keyword(s) — Entrée optionnelle. Un mot-clé par ligne, ou une chaîne JSON de tableau. Filtre le rapport sur les requêtes listées. Mutuellement exclusif avec Url(s).
use_site_url_variable boolean default: false Use variable (Site URL) — Externalise le Site URL : la valeur provient d’un handle d’entrée en amont au lieu d’être choisie dans le panel. Forcé ON automatiquement quand Use a variable for integration est activé.
use_integration_variable boolean default: false Use a variable for integration — Externalise l’intégration. Force use_site_url_variable à ON, car sans intégration concrète les propriétés GSC ne peuvent pas être chargées dans le panel de settings. Requis pour les flux batch où un node d’entrée en amont fournit integration_id et site_url.
Associez ce node au node d’entrée Google Search Property lorsque vous devez changer de propriété au runtime ou exécuter le même workflow sur plusieurs propriétés en batch.
Que produit le node en sortie ?
Le node produit une chaîne unique nommée search_data contenant un payload JSON. Chaque ligne reflète la combinaison de dimensions choisie et les quatre métriques renvoyées par l’API GSC.
{
"rows": [
{
"query": "best seo tools",
"page": "https://example.com/blog/best-seo-tools",
"clicks": 150,
"impressions": 5000,
"ctr": 0.03,
"position": 4.2
},
{
"query": "seo strategy",
"page": "https://example.com/blog/seo-strategy-2025",
"clicks": 92,
"impressions": 3100,
"ctr": 0.0297,
"position": 6.8
}
]
}search_data string Chaîne JSON contenant un tableau rows. Chaque ligne contient les valeurs pour les dimensions sélectionnées (par exemple query, page, device, country, date) ainsi que les métriques clicks, impressions, ctr et position.
Exemples d’utilisation
Exemple 1 : Faire remonter les requêtes à position basse et fortes impressions
Vous voulez identifier les requêtes où votre site apparaît souvent mais se classe mal — territoire classique des opportunités de contenu.
Configuration :
- Site URL :
sc-domain:example.com - Date Range :
last_28_days - Dimensions :
query - Sort column :
impressions - Sort order :
desc - Row limit :
1000
Envoyez search_data vers un JSON Path Extractor pour ne garder que les lignes avec position > 10, puis envoyez la liste filtrée à un node LLM pour proposer des actions de contenu par requête.
Exemple 2 : Suivre le CTR par page après un refresh de contenu
Vous avez rafraîchi un lot de pages et voulez une comparaison de CTR par page sur les 3 derniers mois.
Configuration :
- Site URL :
https://example.com/ - Date Range :
last_3_months - Dimensions :
page,date - Sort column :
clicks - Url(s) input : la liste des URLs rafraîchies (une par ligne)
Connectez la sortie à un Data Analyzer ou à un node d’écriture en base de données pour tracer le CTR hebdomadaire par page.
Exemple 3 : Reporting batch sur plusieurs propriétés
Vous gérez dix propriétés et voulez un rapport par propriété sans dupliquer les nodes.
Configuration :
- Activez Use a variable for integration (force Use variable sur Site URL).
- Câblez le node d’entrée Google Search Property sur les handles
integration_idetsite_url. - Encapsulez le node GSC dans un node Loop itérant sur votre liste de propriétés.
Le runner attend un objet JSON sur le handle site_url ({output, integration_id}) — il sépare automatiquement les deux valeurs. C’est la forme batch supportée.
Problèmes courants
La liste déroulante Site URL reste vide après avoir choisi un compte Google
Cause : Le token de l’intégration n’a pas le scope GSC, ou le compte connecté n’a aucune propriété vérifiée.
Solution : Dans Settings > Integrations, reconnectez le compte Google et assurez-vous que le scope Search Console est accordé. Vérifiez ensuite dans https://search.google.com/search-console que le compte possède au moins une propriété vérifiée.
Erreur : Missing Google Search Console Integration
Cause : L’intégration a été supprimée ou révoquée, ou le node d’entrée en amont n’a pas fourni integration_id alors que Use a variable for integration est activé.
Solution : Si vous utilisez la sélection inline, choisissez une intégration valide dans la liste déroulante. Si vous l’avez externalisée, vérifiez que le node en amont produit bien integration_id (ou un objet JSON le contenant).
Le node renvoie zéro ligne alors que ma propriété a du trafic
Cause : Plage de dates trop récente — GSC n’expose les données que jusqu’à aujourd’hui moins deux jours — ou le filtre URL/mot-clé ne correspond à rien sur la période.
Solution : Choisissez last_28_days d’abord pour confirmer que les données sont accessibles, puis resserrez la plage. Si vous avez fourni des URLs ou des mots-clés, retirez-les temporairement et relancez.
Erreur de validation : You can connect either URLs or Keywords, but not both
Cause : Les deux handles d’entrée Url(s) et Keyword(s) sont câblés. Le node impose qu’ils soient mutuellement exclusifs.
Solution : Déconnectez l’une des deux entrées. Utilisez Url(s) pour filtrer au niveau page, Keyword(s) pour filtrer au niveau requête.
La plage de dates personnalisée échoue avec une erreur de validation
Cause : start_date est après end_date, ou l’un des deux manque alors que Date Range vaut personalized.
Solution : Renseignez les deux champs, vérifiez que start_date <= end_date, et rappelez-vous que la end_date valide la plus récente est deux jours avant aujourd’hui. Si vous externalisez les dates, vérifiez que les inputs en amont fournissent des chaînes YYYY-MM-DD valides.
Bonnes pratiques
Choisissez le plus petit ensemble de dimensions nécessaire. Moins de dimensions = moins de lignes et un appel API plus rapide et moins coûteux. N’ajoutez date que si vous avez réellement besoin d’une série temporelle.
Bornez row_limit à ce que vous allez réellement consommer. Demander 25 000 lignes alors que votre rapport n’en affiche que 200 gaspille du runtime et des tokens LLM en aval.
Ne câblez jamais Url(s) et Keyword(s) en même temps. Le node refuse de s’exécuter avec les deux connectés. Si vous avez besoin des deux filtres, exécutez le node deux fois et fusionnez les sorties avec un Merge.
Le mode variable nécessite le node d’entrée Search Property quand vous voulez externaliser à la fois l’intégration et le Site URL. Des variables texte simples qui ne portent pas d’integration_id échoueront avec une erreur d’intégration manquante.
Nodes associés
Sélecteur runtime de la propriété GSC pour alimenter ce node — requis pour les flux batch sur plusieurs propriétés.
Générer des insights, résumés ou recommandations à partir des données de performance renvoyées par GSC.
Filtrer ou extraire des lignes et champs spécifiques du payload JSON avant traitement en aval.
Itérer sur une liste de propriétés ou d’URLs pour exécuter le node GSC une fois par élément en flux batch.
Transformer les lignes GSC en table CSV pour graphiques, pivots et reporting en aval.