Configuración de cookies

Las cookies necesarias mantienen el sitio funcionando. La analítica muestra qué páginas son útiles. Puedes cambiar tu elección en cualquier momento desde el pie de página.

Política de cookies de este sitio — todos los detalles: categorías de cookies, cómo guardamos tu elección en el navegador y cómo retirar el consentimiento.

Necesarias

Funciones básicas del sitio y tu elección de consentimiento. Siempre activas.

Analítica

Ayuda a entender cómo se usa el sitio. Se carga solo si lo permites.

GitHubDescargar ZIP

Integración con Google Search Console

Consulta Search Console, archiva sus datos en un archivo SQLite local y cruza esa información con las pruebas del rastreo por URL. El acceso es de solo lectura y usa tus propias credenciales de Google.

Ver en GitHubInicio rápido

Qué hace

  • SpiderHead en la terminal: seohead gsc-query

Conexión de solo lectura

SpiderHead usa únicamente el permiso de Search Console de solo lectura. Hay tres formas de dar acceso y tú eliges una. Después, provider-verify comprueba el acceso a la propiedad por separado, porque un inicio de sesión válido no demuestra que puedas leer un sitio concreto.

  • Consentimiento en el navegador con tu propio cliente OAuth de escritorio, mediante scripts/gsc_oauth_login.py. El token de actualización se guarda en tu carpeta de configuración local.
  • Una cuenta de servicio de Google que añades como usuario en la propiedad.
  • Un token de acceso ya generado en el ajuste GSC_ACCESS_TOKEN.

Historial local

gsc-archive pone en cola un intervalo de fechas y lo descarga en lotes pequeños y reanudables dentro de un archivo SQLite que indicas. sources-sync guarda el historial diario por proyecto y descarga solo los días que faltan. Nada se envía a un servicio alojado, y los archivos se crean con permisos solo para el propietario.

  • Las fechas incluyen los extremos y usan la hora del Pacífico.
  • Los distintos niveles de detalle (totales, páginas, consultas) son conjuntos de datos separados y nunca se suman.
  • Los archivos pueden contener consultas y URL, así que mantenlos fuera de los informes públicos y de Git.

Inspección de URL

gsc-query con el modo inspect_url devuelve el propio veredicto de indexación de Google para una URL. Va en una línea aparte, separada de las comprobaciones del rastreador. Dentro de sf run, --gsc-inspect inspecciona una muestra determinista de hasta 50 URL, con límites locales de 600 por minuto y 2000 por cada 24 horas.

  • Solo se puede inspeccionar la versión indexada de una página.
  • Los límites de Google por sitio se aplican además de los locales.
  • Las URL no inspeccionadas siguen en estado desconocido.

Tres pasos, un análisis guardado

  1. Conecta un permiso de solo lectura

    Conecta un permiso de Google de solo lectura para una propiedad que posees. Consulta su estado cuando quieras.

  2. Archívalo en local

    Pon en cola un intervalo de fechas y ejecútalo en lotes pequeños y acotados dentro de un archivo SQLite de tu equipo. Las nuevas ejecuciones solo descargan los días que faltan.

  3. Cruza con cada URL

    Los clics, las impresiones, la posición y el CTR se cruzan con las páginas del rastreo por URL. El veredicto de indexación de Google para una URL va en una línea aparte.

Un solo comando

bash
seohead gsc-query --site-url sc-domain:example.com --start-date 2026-09-01 --end-date 2026-09-30

Primero, instala SpiderHead: guía de instalación. Cada comando también funciona como herramienta MCP para agentes de IA.

Qué necesitas

  • Una propiedad de Search Console que posees o puedes leer (una propiedad de dominio o un prefijo de URL)
  • Una credencial: consentimiento OAuth, una cuenta de servicio o un token de acceso (todas de solo lectura)
  • Un intervalo de fechas, dentro de unos 16 meses
  • Opcional: un rastreo o un escaneo al que unir las filas

Límites

  • Google conserva unos 16 meses de datos.
  • Las consultas anonimizadas se omiten y las filas pueden tener un límite. Un trabajo con límite queda marcado y no es una exportación completa.
  • Los clics, las impresiones, el CTR y la posición no se suman entre niveles de detalle distintos.
  • El veredicto de indexación solo cubre las URL que inspeccionas.

Preguntas

¿Mis datos se envían a un servicio alojado?
No. Las peticiones salen de tu equipo directamente a la API de Google Search Console, con tu propio permiso. Los resultados se guardan en archivos SQLite locales con permisos solo para el propietario. Mantén esos archivos fuera de los informes públicos y de Git, porque pueden contener consultas y URL.
¿Puede modificar mi propiedad de Search Console?
No. El permiso es de solo lectura. La herramienta solo lee datos de analítica de búsqueda y resultados de inspección de URL.
¿Hasta qué fecha llegan los datos?
Unos 16 meses, que es el historial disponible en Google. Las fechas incluyen los extremos y usan la hora del Pacífico.
¿Por qué faltan algunas consultas?
Google omite las consultas anonimizadas y puede limitar el número de filas devueltas. Un trabajo limitado no es una exportación completa, y la herramienta lo marca así.
¿El veredicto de indexación de Google sustituye a las comprobaciones del rastreo?
No. El veredicto de Google para una URL procede de gsc-query en el modo inspect_url. Las comprobaciones propias del rastreador (metadatos, cabeceras, robots, redirecciones, datos estructurados, renderizado) se ejecutan con inspect-url. Los dos resultados se mantienen por separado.
¿Cuánto cuesta y qué se guarda en local?
La API es gratuita dentro de las cuotas de Google. SpiderHead guarda tu token de actualización o la ruta de la cuenta de servicio en tu carpeta de configuración local, y los archivos de archivado e historial en la ruta que indiques. Ningún token se escribe en los archivos de historial.

Sigue explorando

Del blog y el glosario

Google Search Console: guía completa 2026BlogGoogle Search Console (GSC)GlosarioIndexaciónGlosario

Más de este grupo · Fuentes de datos

Datos de GA4 y Yandex MetrikaFunciónIntegración con Yandex WebmasterFunciónInforme de Core Web Vitals de CrUXFunciónAnalizador de logs de servidorFunciónComprobador de backlinks para una lista de donantesFunciónHerramienta para crear el núcleo semánticoFunción

Pruébalo en tu propio sitio

Descargar ZIPTodas las funciones