Rastrear Posiciones SEO Google Search Console | n8n

Este nodo es el punto de partida del workflow. Cuando haces clic en el botón "Test" o "Execute" en el editor de n8n, el Manual Trigger inicia la ejecución de toda la secuencia de automatización. Es el disparador más simple y útil para workflows que quieres ejecutar bajo demanda.

En un escenario de producción, podrías reemplazar este trigger por un Schedule Trigger (Cron) para que el workflow se ejecute automáticamente cada día a una hora específica, manteniendo tu tracking de posiciones siempre actualizado sin intervención manual.

💡 Consejo: Para automatizar completamente el tracking, sustituye este nodo por un Schedule Trigger configurado para ejecutarse diariamente a las 6:00 AM. Así tendrás datos frescos cada mañana antes de empezar a trabajar.

Este nodo conecta con tu hoja de Google Sheets donde tienes configuradas las palabras clave y países que quieres monitorear. Lee todas las filas de la pestaña de configuración para obtener la lista completa de combinaciones keyword-país que el workflow procesará.

La estructura de tu hoja de configuración debe incluir al menos dos columnas: una para la palabra clave exacta que quieres trackear, y otra para el código de país (por ejemplo, "fra" para Francia, "esp" para España, "usa" para Estados Unidos). Esto permite monitorear la misma keyword en diferentes mercados geográficos.

💡 Consejo: Organiza tu hoja de configuración con columnas claras: "keyword", "country_code", y opcionalmente "priority" o "category" para poder filtrar después en tus análisis.

Este segundo nodo de Google Sheets recupera las fechas para las cuales quieres obtener datos de posicionamiento. En tu hoja de seguimiento, tienes una columna con las fechas del histórico que quieres rellenar o actualizar con datos de Search Console.

El workflow recorre estas fechas una por una para consultar la API de Search Console y obtener la posición de tus keywords en cada día específico. Esto te permite construir un histórico completo de rankings, incluso rellenando datos de fechas pasadas si acabas de configurar el sistema.

💡 Consejo: Limita las fechas en tu hoja a los últimos 16 meses, que es el máximo que Search Console almacena. Para históricos más largos, tendrás que guardar los datos antes de que expiren de la API.

Este nodo divide los datos de entrada en lotes más pequeños para procesarlos de forma secuencial y controlada. Al configurarlo con un tamaño de lote de 1, cada fecha se procesa individualmente antes de pasar a la siguiente.

Este enfoque es crucial cuando trabajas con APIs que tienen límites de tasa (rate limits) como Google Search Console. Procesar las solicitudes una por una evita que la API te bloquee por exceso de peticiones simultáneas y garantiza que todos los datos se recuperen correctamente.

💡 Consejo: Si notas que el workflow es lento con muchas fechas, puedes aumentar el Batch Size a 2 o 3, pero vigila que no superes los límites de la API de Search Console (aproximadamente 1200 queries por minuto).

Este es el corazón del workflow. El nodo HTTP Request realiza una petición POST autenticada a la API de Google Search Console para obtener los datos de posición e impresiones de tus keywords. Envía un cuerpo JSON con los parámetros de búsqueda: rango de fechas, tipo de búsqueda, dimensiones y filtros.

La API devuelve la posición media y el número de impresiones para cada keyword que coincide con tus filtros. Los datos se estructuran en un array de resultados que luego procesaremos para actualizar tu hoja de seguimiento.

💡 Consejo: La expresión {{ $json['date_formated'] }} toma la fecha del nodo anterior. Asegúrate de que el formato sea YYYY-MM-DD (por ejemplo: 2024-01-15), que es el único formato que acepta la API de Search Console.

Este nodo condicional verifica si la API de Search Console devolvió datos de posición para la combinación de fecha, keyword y país consultada. No todas las consultas devuelven resultados — puede que la keyword no tenga impresiones en esa fecha específica o en ese país.

El nodo evalúa si el campo "position" existe en la respuesta. Si no existe, el workflow salta la actualización de esa fila y continúa con la siguiente fecha, evitando errores y asegurando que el proceso no se interrumpa por datos faltantes.

Lógica del nodo:

• Rama TRUE: No hay datos de posición → el workflow continúa sin actualizar
• Rama FALSE: Hay datos → el workflow procede a actualizar la hoja de Google Sheets

💡 Consejo: Esta verificación es esencial para la robustez del workflow. Sin ella, el sistema fallaría cada vez que una keyword no tenga datos para una fecha específica, algo muy común en keywords de bajo volumen. Si necesitas ayuda avanzada, nuestra agencia n8n puede asistirte.