Datos de ranking

Obtén los datos de búsqueda reales de tu sitio desde Google Search Console — OAuth gratis.

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.