Tracker Positions SEO Google Search Console | n8n

Ce nœud constitue le point d'entrée de votre workflow de suivi SEO. Le Manual Trigger permet de lancer l'exécution manuellement depuis l'éditeur n8n en cliquant sur le bouton "Test" ou "Execute". C'est idéal pour tester votre configuration avant de planifier une exécution automatique.

Dans un usage en production, vous remplacerez probablement ce déclencheur par un nœud Schedule Trigger pour automatiser l'exécution quotidienne ou hebdomadaire. Mais pour la mise en place et les tests, le déclenchement manuel est parfait.

💡 Astuce : Une fois votre workflow testé et validé, ajoutez un nœud Schedule Trigger en parallèle du Manual Trigger. Configurez-le pour s'exécuter chaque jour à 6h du matin par exemple, afin de récupérer automatiquement les données de la veille.

Ce premier nœud Google Sheets récupère votre configuration de tracking : la liste des mots-clés à suivre et les pays cibles pour chaque mot-clé. Cette approche vous permet de gérer facilement vos mots-clés directement dans Google Sheets, sans modifier le workflow à chaque ajout.

Créez un onglet "keyword & country" dans votre Google Sheets avec deux colonnes : une pour le mot-clé exact à tracker, et une pour le code pays (fra pour France, usa pour États-Unis, etc.). Le workflow lira automatiquement toutes les lignes de cet onglet.

💡 Astuce : Structurez votre onglet de configuration avec des colonnes claires : keyword, country_code, et éventuellement active (true/false) pour pouvoir désactiver temporairement certains mots-clés sans les supprimer.

Ce second nœud Google Sheets récupère la liste des dates pour lesquelles vous souhaitez collecter les données de positions. Cette approche permet de gérer l'historique de façon flexible : vous pouvez ajouter des dates passées pour rattraper un historique manquant, ou configurer uniquement les dates récentes.

L'onglet "Feuille 1" (ou celui que vous configurez) contient les dates au format attendu par l'API Search Console. Le workflow itérera ensuite sur chaque date pour interroger l'API.

💡 Astuce : L'API Google Search Console a généralement un délai de 2-3 jours. Ne cherchez pas à récupérer les données d'hier ou d'aujourd'hui, elles ne seront pas disponibles. Configurez vos dates à partir de J-3 minimum.

Le nœud Split In Batches découpe le flux de données pour traiter chaque date une par une. Cette approche séquentielle est cruciale pour éviter de surcharger l'API Google Search Console et pour gérer proprement les erreurs éventuelles sur certaines dates.

En traitant les dates par lots de 1, vous assurez un contrôle précis du flux d'exécution et facilitez le débogage si une date pose problème.

💡 Astuce : Si vous avez beaucoup de dates historiques à rattraper, vous pouvez augmenter temporairement le Batch Size à 5 ou 10 pour accélérer le traitement. Mais surveillez les limites de quota de l'API Search Console.

C'est le cœur du workflow : ce nœud HTTP Request interroge l'API Google Search Console pour récupérer les données de positions et d'impressions. La requête est construite dynamiquement avec la date en cours de traitement, et inclut les filtres pour le mot-clé et le pays configurés.

L'API retourne la position moyenne du mot-clé dans les résultats Google, ainsi que le nombre d'impressions (affichages) pour cette date. Ces données seront ensuite stockées dans votre Google Sheets.

Corps JSON de la requête :

{\n  \"startDate\": \"{{ $json['date_formated'] }}\",\n  \"endDate\": \"{{ $json['date_formated'] }}\",\n  \"searchType\": \"web\",\n  \"dimensions\": [\"query\"],\n  \"dimensionFilterGroups\": [...]\n}

💡 Astuce : L'expression {{ $json['date_formated'] }} récupère la date depuis le nœud précédent. Assurez-vous que vos dates sont au format YYYY-MM-DD (ex: 2024-01-15) car c'est le format attendu par l'API Search Console.

Ce nœud conditionnel vérifie si l'API a retourné des données de position pour la combinaison date/mot-clé/pays interrogée. Il arrive que certaines dates n'aient pas de données (mot-clé non apparu dans les résultats, pas d'impressions ce jour-là, etc.).

En vérifiant l'existence du champ position dans la réponse API, le workflow peut gérer proprement les cas où aucune donnée n'est disponible, évitant ainsi les erreurs et permettant de continuer le traitement des autres dates.

Logique de branchement :

• Si TRUE (position n'existe pas) : La date n'a pas de données → passer à la date suivante
• Si FALSE (position existe) : Des données sont disponibles → mettre à jour le Google Sheets

💡 Astuce : Cette condition est essentielle pour la robustesse de votre workflow. Sans elle, une date sans données générerait une erreur et bloquerait tout le traitement.