Configuración
1. Verifica tu sitio en Google Search Console
Añade tu dominio en search.google.com/search-console. Verifica la propiedad (registro DNS TXT es lo más fácil para propiedades de dominio).
2. Crea credenciales OAuth
ZensInk necesita acceso API de solo lectura. Crea un cliente OAuth Desktop en Google Cloud Console, luego ejecuta el script de configuración única:
python3 -m zens_ink.setup_gsc
Abre un navegador para autorizar y guarda las credenciales en ~/.config/gcloud/application_default_credentials.json.
3. Configura la URL de tu sitio
En .env:
GSC_SITE_URL=sc-domain:example.com
Usa sc-domain: para propiedades de dominio, o https:// para propiedades de prefijo URL.
Uso
Top queries
Qué consultas de búsqueda te traen más impresiones:
python3 -m zens_ink.search_performance --queries
Top páginas
Qué páginas reciben más tráfico de búsqueda:
python3 -m zens_ink.search_performance --pages
Filtrar por ruta de página
Acércate a una sección específica:
python3 -m zens_ink.search_performance --page /blog/
Rango de fechas
python3 -m zens_ink.search_performance --start 2025-01-01 --end 2025-06-30
Desglose por país
python3 -m zens_ink.search_performance --country
Los datos tardan. Google indexa sitios nuevos lentamente. Si ves “No data yet”, tu sitio aún no fue rastreado o tiene tráfico de búsqueda cero. Es normal en sitios de menos de 3 meses.