SeoToolkit/agente-analise-web

Habilidade de Análise Web

Esta habilidade permite que o agente colete e analise dados de tráfego do Google e do Bing para fornecer insights profundos de SEO.

Preparação do Ambiente

Os scripts necessários estão localizados no diretório scripts/ relativo a este arquivo SKILL.md. Certifique-se de que as seguintes dependências estão instaladas:

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

Credenciais necessárias e como obtê-las

Antes de executar esta habilidade, certifique-se de que o ambiente está configurado. Se o usuário não tiver as credenciais necessárias, o Agente deve instruí-lo a obtê-las usando as seguintes etapas:

1. Segredo do cliente OAuth do Google (client_secret.json)

O agente requer um ID de cliente OAuth 2.0 para Desktop para acessar as APIs do Google. Instruções para o usuário:

1. Acesse o Google Cloud Console.
2. Crie um novo projeto ou selecione um existente.
3. Navegue até APIs & Services > Library e habilite Google Search Console API e Google Analytics Data API.
4. Navegue até APIs & Services > OAuth consent screen e configure (você pode definir o tipo de usuário como "External" e adicionar seu próprio e-mail como usuário de teste).
5. Navegue até APIs & Services > Credentials. Clique em Create Credentials > OAuth client ID.
6. Selecione Desktop app como tipo de aplicativo.
7. Clique em Criar e baixe o arquivo JSON. Renomeie-o para client_secret.json e coloque-o no diretório scripts/ desta habilidade.

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

Estes são gerados automaticamente pelo script.

• Instrução para o Agente: Se a saída do script disser Opening browser for authorization, informe ao usuário para verificar seu computador em busca de uma janela do navegador recém-aberta e concluir o login OAuth do Google. O script salvará automaticamente os tokens localmente após o login bem-sucedido.

3. Chave de API do Bing

Instruções para o usuário:

1. Acesse Bing Webmaster Tools.
2. Selecione seu site verificado.
3. Clique no ícone de engrenagem Configurações no canto superior direito.
4. Vá para API Access -> API Key.
5. Clique em Generate API Key (ou copie a chave existente).
6. Cole-a no arquivo .env como BING_API_KEY=sua_chave_aqui.

Etapas de Execução

1. Coletar dados do Google Search Console (GSC)

Execute o script de análise do GSC para obter cliques, impressões, CTR e posição média:

cd scripts && python3 analyze_gsc.py

2. Coletar dados do Google Analytics 4 (GA4)

Execute o script do GA4 para analisar sessões de usuários, fontes de tráfego e visualizações de página:

cd scripts && python3 ga4_both.py

3. Coletar dados do Bing Webmaster Tools

Execute o script do Bing para comparar o desempenho de pesquisa do Bing com o Google:

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

4. Sintetizar Insights

Analise a saída combinada e reporte:

1. Análise de Tendência: O tráfego geral está crescendo ou diminuindo com base na visão de 14 dias?
2. Proporção entre Plataformas: Qual é a proporção do tráfego do Bing em comparação com o Google?
3. Oportunidades de Palavras-chave e Páginas: Destaque palavras-chave com altas impressões, mas baixo CTR, ou páginas com bom desempenho no Bing, mas não no Google.

Forneça o resumo final ao usuário usando Markdown limpo.