Conectar Google Search Console al proyecto

Cómo conectar Google Search Console al proyecto y leer la página de Datos GSC — tarjetas de métricas con series de gráfico activables, 6 pestañas (Consultas, Páginas, Países, Dispositivos, Fechas, Apariencia), filtros de periodo y sincronización manual.

Conectar Google Search Console es opcional pero muy recomendable. Te da acceso a los datos reales de Google sobre tus impresiones, clics y CTR — información que Miraqo usa para:

• Mostrar el tráfico orgánico estimado de cada keyword
• Sugerir nuevas keywords (consultas que ya generan impresiones pero aún no están rastreadas, ver Keywords del proyecto)
• Distinguir la “posición media” que muestra Google del ranking puro

GSC mide cómo ve Google tu sitio (impresiones, clics, posición). Para el tráfico real en el sitio (sesiones, usuarios, conversiones) hay una integración separada y complementaria: Google Analytics 4 o Matomo.

Requisitos previos

• Sitio ya verificado en Google Search Console (con la cuenta de Google que usarás para la conexión)
• Permiso de acceso a los datos de GSC del sitio (propietario o usuario delegado)

Si el sitio aún no está verificado en GSC, haz ese paso primero en el portal de Google. Miraqo no puede añadir ni verificar un sitio nuevo en GSC — solo puede leer datos de sitios ya verificados.

Procedimiento de conexión

1. Abre el proyecto → Configuración → General. En la rejilla, la primera fila contiene la tarjeta 🔍 Google Search Console.
2. Haz clic en Conectar con Google.
3. Se te redirige a Google: elige la cuenta con acceso a GSC y haz clic en Continuar.
4. Concede los permisos solicitados (solo lectura: Miraqo no escribe nada en GSC).
5. Vuelves a Miraqo con el mensaje “¡Google Search Console conectado! Se han encontrado N propiedades”. Si el dominio del proyecto coincide con una sola propiedad GSC, se selecciona automáticamente. En caso contrario, elige la correcta en el desplegable Propiedad GSC utilizada (https://example.com/ frente a sc-domain:example.com) y haz clic en Guardar.

La primera sincronización empieza automáticamente e importa los últimos 90 días de datos. En proyectos con muchas consultas puede tardar 1-2 minutos. Debajo del desplegable, la tarjeta indica la fecha y hora de la última sincronización.

Cambiar de propiedad tras conectar: desde la misma tarjeta de Configuración, si tienes varias propiedades disponibles en la cuenta, puedes cambiar la propiedad usada desde el desplegable sin necesidad de reconectar. El botón 📊 Ver Datos lleva directamente a la página de Datos GSC.

La página de Datos GSC

Accede desde el menú lateral del proyecto → Google Search Console.

Cabecera y acciones

• Título “Google Search Console” + dominio del proyecto
• Botón 🔄 Sincronizar — fuerza una nueva obtención de datos (para roles con permiso de sincronización)
• Selector de periodo — chips 7d / 28d / 90d para elegir el intervalo; cambia toda la página y las tablas

Posibles estados antes de los datos

• GSC no conectado — estado vacío con botón “Ir a Configuración”
• Conectado pero sin propiedad seleccionada — banner ⚠️ con botón de Configuración
• Sin datos sincronizados — estado vacío con botón ”🔄 Sincronizar ahora” (ocurre justo después de la primera conexión)

Las 4 tarjetas de métricas

Clicables como interruptores: activan/desactivan la serie correspondiente en el gráfico de abajo. Para cada métrica ves el valor total del periodo + la variación porcentual (cuando es comparable):

• Clics totales (activa por defecto)
• Impresiones totales (activa por defecto)
• CTR medio (desactivada por defecto)
• Posición media (desactivada por defecto)

El gráfico debajo de las tarjetas muestra la tendencia diaria de las series activas, con el eje de los clics a la izquierda y el de las impresiones a la derecha.

Las 6 pestañas

Debajo del gráfico, pestañas para explorar los datos de GSC desde distintos ángulos. Las pestañas Consultas, Páginas y Países muestran entre paréntesis cuántas filas contienen. Todas las tablas son ordenables al hacer clic en el encabezado de columna.

🔎 Consultas

Tabla de consultas con Clics, Impr., CTR y Pos. Las celdas de CTR y Pos. tienen colores para señalar valores “buenos” frente a “mejorables”.

📄 Páginas

Tabla de las URL del sitio que posicionan, con las mismas 4 métricas. Las páginas son enlaces (se abren en una nueva pestaña).

🌍 Países

Distribución del tráfico orgánico por país (con código ISO).

📱 Dispositivos

Tarjetas resumen para Escritorio, Tablet y Móvil, cada una con los 4 indicadores en una rejilla 2×2.

📅 Fechas

Tabla día a día (útil para exportación manual o para investigar días concretos).

✨ Apariencia

Distribución por tipo de resultado enriquecido (Rich Results, Vídeo, Imágenes, FAQ, Reseña, Product Snippets, …), una tarjeta por tipo con los mismos 4 indicadores. Ve qué funciones usa Google para mostrar tu sitio en los SERP.

Sincronización

Miraqo actualiza los datos de GSC automáticamente cada día sobre la ventana completa de 90 días. También puedes forzar una sincronización manual con el botón 🔄 Sincronizar de la cabecera (consumo: 1 llamada a la API de GSC al día, sin límite dedicado del plan).

Aviso de caída de tráfico. Tras cada sincronización Miraqo compara los clics de los últimos 7 días disponibles con los 7 anteriores: si caen al menos un 30% y la semana de comparación tenía al menos 50 clics, quien tenga activada la casilla Caídas en las notificaciones del proyecto recibe un correo, como máximo uno a la semana.

Frescura de los datos de Google. Search Console consolida los datos con un retraso de 2-3 días. Para evitar mostrar caídas ficticias, los gráficos sparkline y las variaciones porcentuales del Dashboard se detienen en el límite de frescura (aproximadamente hoy − 2 días): el último 1-2 días aún no definitivos se excluyen de las comparaciones. Es normal que el Dashboard no muestre “ayer”.

Desconexión

Configuración → General → 🔍 Google Search Console → Desconectar. Requiere confirmación. El histórico de datos ya importados sigue visible en la página de Datos GSC, pero no recibirás nuevas actualizaciones hasta que vuelvas a conectar.

También puedes revocar el acceso desde el lado de Google: Cuenta de Google → Seguridad → Apps de terceros. Tras la revocación, la próxima sincronización fallará con invalid_grant (ver abajo).

Errores habituales

• “invalid_grant” durante la sincronización — el token ha sido revocado (cambio de contraseña de Google, expiración, acceso revocado manualmente o app eliminada de la cuenta de Google). Ve a Configuración → General, haz clic en Desconectar y vuelve a conectar.
• No aparecen propiedades en el selector — la cuenta de Google elegida no tiene acceso a ninguna propiedad GSC. Verifica que has iniciado sesión con la cuenta correcta y, si hace falta, pide al propietario del sitio que te añada como usuario en GSC.
• Propiedades listadas pero sin datos — la propiedad lleva verificada menos de 24-72h. Google tarda 1-3 días en poblar datos de propiedades nuevas.
• Sincronización correcta pero tablas vacías en una pestaña concreta (p. ej. Países/Apariencia) — tu sitio aún no ha recibido tráfico/impresiones de ese tipo, o GSC no ha agregado suficientes datos. No es un fallo de la herramienta.

Qué cambia en otros sitios tras conectar

• Resumen del proyecto — la tarjeta “Métricas clave” muestra datos enriquecidos y el widget de Analytics correlaciona mejor
• Dashboard de triage — aparece la columna ∆ Impresiones GSC y la tendencia de clics de 30 días en la fila del proyecto
• Keywords del proyecto — en Configuración → Keywords aparece el panel ”💡 Sugeridas por Google Search Console” con consultas entrantes para añadir al rastreo (clics e impresiones de los últimos 28 días, botón + Añadir por fila)
• Prompts de IA — en Configuración → Prompt AI aparece un panel similar con consultas de varias palabras de GSC como prompts candidatos

Configuración inicial completa. Ahora puedes:

• Conectar Google Analytics 4 o Matomo →
• Ejecutar tu primer SEO audit →
• Configurar el mapa de ranking local →
• Añadir prompts de Visibilidad en IA →

Última actualización: 5 de septiembre de 2026