SeoToolkit/web-analytics-agent-skill

Habilidad de Análisis Web

Esta habilidad permite al agente obtener y analizar datos de tráfico de Google y Bing para proporcionar información SEO profunda.

Preparación del Entorno

Los scripts necesarios se encuentran en el directorio scripts/ relativo a este archivo SKILL.md. Asegúrese de que las siguientes dependencias estén instaladas:

python3 -m pip install -r scripts/gsc-requirements.txt

Credenciales Requeridas y Cómo Obtenerlas

Antes de ejecutar esta habilidad, asegúrese de que el entorno esté configurado. Si el usuario no tiene las credenciales requeridas, el Agente debe indicarle que las obtenga siguiendo los siguientes pasos:

1. Secreto de Cliente OAuth de Google (client_secret.json)

El agente requiere un ID de Cliente OAuth 2.0 de escritorio para acceder a las APIs de Google. Instrucciones para el Usuario:

1. Vaya a Google Cloud Console.
2. Cree un nuevo proyecto o seleccione uno existente.
3. Navegue a APIs y Servicios > Biblioteca y habilite API de Google Search Console y API de Datos de Google Analytics.
4. Navegue a APIs y Servicios > Pantalla de consentimiento OAuth y configúrela (puede establecer el tipo de usuario como "Externo" y agregar su propio correo electrónico como usuario de prueba).
5. Navegue a APIs y Servicios > Credenciales. Haga clic en Crear Credenciales > ID de cliente OAuth.
6. Seleccione Aplicación de escritorio como tipo de aplicación.
7. Haga clic en Crear, luego descargue el archivo JSON. Cambie su nombre a client_secret.json y colóquelo en el directorio scripts/ de esta habilidad.

2. Tokens OAuth de Google (token.json, google_analytics_token.json)

Estos se generan automáticamente por el script.

• Instrucción para el Agente: Si la salida del script dice Abriendo navegador para autorización, dígale al usuario que revise su computadora para ver una nueva ventana del navegador y complete el inicio de sesión OAuth de Google. El script guardará automáticamente los tokens localmente una vez que el inicio de sesión sea exitoso.

3. Clave API de Bing

Instrucciones para el Usuario:

1. Vaya a Bing Webmaster Tools.
2. Seleccione su sitio web verificado.
3. Haga clic en el icono de engranaje Configuración en la esquina superior derecha.
4. Vaya a Acceso API -> Clave API.
5. Haga clic en Generar clave API (o copie la existente).
6. Péguela en el archivo .env como BING_API_KEY=su_clave_aqui.

Pasos de Ejecución

1. Recopilar Datos de Google Search Console (GSC)

Ejecute el script de análisis de GSC para obtener clics, impresiones, CTR y posición promedio:

cd scripts && python3 analyze_gsc.py

2. Recopilar Datos de Google Analytics 4 (GA4)

Ejecute el script de GA4 para analizar sesiones de usuarios, fuentes de tráfico y páginas vistas:

cd scripts && python3 ga4_both.py

3. Recopilar Datos de Bing Webmaster Tools

Ejecute el script de Bing para comparar el rendimiento de búsqueda de Bing con el de Google:

export BING_API_KEY=$(grep BING_API_KEY ../../.env | cut -d '=' -f2)
cd scripts && python3 bing_webmaster.py

4. Sintetizar Información

Analice la salida combinada y reporte:

1. Análisis de Tendencia: ¿El tráfico general está creciendo o disminuyendo según la vista de 14 días?
2. Proporción de Plataforma: ¿Cuál es la proporción de tráfico de Bing en comparación con Google?
3. Oportunidades de Palabras Clave y Páginas: Resalte las palabras clave con altas impresiones pero bajo CTR, o páginas que funcionan bien en Bing pero no en Google.

Proporcione el resumen final al usuario utilizando Markdown limpio.