Auditoría de Portafolio GSC
Responde "¿cómo va todo?" en cada propiedad de una cuenta de Search Console, que es la pregunta que las herramientas por sitio no pueden responder sin decenas de exportaciones manuales.
Configuración
Requiere un token de actualización OAuth con https://www.googleapis.com/auth/webmasters.readonly:
export GOOGLE_GSC_CLIENT_ID=... # o GOOGLE_CLIENT_ID
export GOOGLE_GSC_CLIENT_SECRET=... # o GOOGLE_CLIENT_SECRET
export GOOGLE_REFRESH_TOKEN=...
export GSC_EXCLUDE="olddomain.com" # opcional, separado por comas
pip install requests
El error de configuración más común es unauthorized_client al renovar el token. Significa que el token de actualización fue emitido para un cliente OAuth diferente al id/secret que emparejaste. Las cuentas que han agregado integraciones de Google con el tiempo suelen tener varios clientes; empareja el par que creó el token.
Cómo ejecutarlo
python3 scripts/audit_gsc.py # completo: clasificación + comparación de palabras clave para los 12 primeros
python3 scripts/audit_gsc.py portfolio # solo la tabla clasificatoria
python3 scripts/audit_gsc.py queries --site sc-domain:example.com
python3 scripts/audit_gsc.py --days 90 # trimestre contra trimestre
Banderas: --days (ventana, comparada con la ventana inmediatamente anterior), --site (repetible), --top, --limit, --min-clicks.
Secciones y qué significan
| Sección | Léelo como |
|---|---|
| NUEVO | consultas con cero clics en el período anterior. De dónde viene realmente el crecimiento. |
| SUBIENDO | subió ≥50%. Verifica si la posición también se movió — si no lo hizo, aumentó la demanda, no tu clasificación. |
| BAJANDO | bajó ≥40% desde una base real. La posición te dice de qué tipo: si cayó el rango = pérdida de clasificación; si el rango se mantuvo pero los clics colapsaron = algo tomó los clics arriba (AI Overview, una nueva característica SERP, o la consulta cambió de forma). |
| PERDIDO | antes clasificaba, ahora no hay datos. |
| BRECHA DE CTR | ≥1,500 impresiones, top 10, menos del 2% de CTR. Reescribir título y descripción, las victorias más baratas disponibles. |
Interpretación
- Reporta primero los clics, luego las impresiones. Una propiedad grande puede sesgar las impresiones del portafolio lo suficiente como para ocultar que todo lo demás creció.
- Separa marca de no marca. Un sitio cuyo conjunto completo de palabras clave es su propio nombre (o errores ortográficos de un competidor) no tiene motor de adquisición, por bueno que parezca el número de clics. Dilo claramente en el informe.
- Un colapso completo del sitio en su propio término de cabecera no suele ser SEO. Verifica la propiedad antes de diagnosticar clasificaciones:
whois <dominio> | grep -i "registrar\|updated date"más si todavía resuelve. Los dominios caducados, transferidos o en disputa producen un acantilado de clasificación de libro de texto que ningún trabajo SEO arreglará. - "nuevo" en la tabla del portafolio significa cero clics en la ventana anterior, que para un sitio recién lanzado es un lanzamiento, no un vacío de datos.
- No omitas consultas en idiomas que no puedas leer. En sitios multimercado, el crecimiento suele estar en cola larga no inglesa; traduce las interesantes en lugar de filtrarlas.
- Una propiedad que devuelve 403 está verificada para listado pero no para análisis de búsqueda. El script lo reporta en lugar de ocultarlo.
Notas
- Los datos de GSC se retrasan aproximadamente 3 días; el script lo compensa automáticamente.
- Ambos períodos se obtienen por propiedad en paralelo, por lo que una cuenta de 40 propiedades toma segundos.
- Las filas de consultas están limitadas a 25,000 por período, muy por encima de lo que cualquier sitio devuelve para una ventana de 28 días.