🔍 Landing Page SEO Analyzer & Auto-Fixer

Um ecossistema robusto em Python para análise técnica, correção automatizada via IA e otimização estratégica de landing pages. Ideal para profissionais de marketing e desenvolvedores que buscam maximizar o desempenho orgânico e a conversão de páginas de vendas.

---

🌟 Destaques

• ⚡ 9 Módulos de Análise: De Meta Tags a CTAs, cobrindo todos os pilares do SEO moderno.
• 🤖 Auto-Fixer Inteligente: Aplica patches HTML cirúrgicos usando a API Gemini para corrigir problemas em massa.
• 📈 Comparativo de Performance: Analise múltiplas páginas e veja quem ganha no score geral.
• 🔗 Slug Analyzer: Sugestões estratégicas de URLs amigáveis baseadas no conteúdo real da página.
• 📊 Relatórios Visuais e JSON: Interface via terminal elegante (Rich) e exportação para processamento de dados.

---

🔄 Fluxo de Trabalho Completo

O projeto foi desenhado para ser um ciclo de otimização contínuo:

1. Análise Técnica (main.py)

Escaneia seus arquivos HTML em busca de falhas estruturais.

python main.py "../projeto/*.html" --compare --gemini

2. Correção Automática (auto_fixer.py)

Lê o relatório gerado e aplica correções automáticas (OG Tags, Alt Text, JSON-LD) sem quebrar o layout.

python auto_fixer.py relatorio.json

3. Otimização de Slugs (slug-analyzer.py)

Gera sugestões de URLs curtas e poderosas para melhorar o CTR.

python slug-analyzer.py "../projeto/oferta-1.html"

---

📦 Instalação e Configuração

Pré-requisitos

• Python 3.9 ou superior.

Setup

# Clone o repositório
git clone https://github.com/vitorkrewer/seo-analyzer.git
cd seo-analyzer

# Instale as dependências
pip install -r requirements.txt

Configuração da API Gemini (Recomendado)

Para usar o Auto-Fixer e insights de IA, você precisará de uma chave de API:

1. Obtenha sua chave em: Google AI Studio
2. Configure o ambiente:

copy .env.example .env
# Edite o .env e insira sua GEMINI_API_KEY

---

🛠️ Detalhamento dos Módulos

Módulo	Peso	O que verifica
Meta Tags	15%	Title, description, charset, viewport, lang, favicon.
Estrutura de Headings	10%	H1 único, hierarquia H2-H6, saltos de nível inconsistentes.
Qualidade de Conteúdo	15%	Densidade de texto, legibilidade Flesch, gatilhos de conversão.
Performance HTML	15%	Tamanho do arquivo, scripts bloqueantes, lazy-load, preconnect.
Crawlability	15%	Links internos/externos, anchors, atributo canonical.
Schema / OG / Twitter	10%	Presença de JSON-LD, Open Graph e Twitter Cards.
Imagens	10%	Atributos Alt (essencial para acessibilidade/SEO), WebP, Lazy-load.
Tracking & Scripts	5%	GTM, GA4, Facebook Pixel, Noindex/Nofollow.
CTAs e Conversão	5%	Botões de ação, urgência, prova social, widgets de WhatsApp.

---

🚀 Guia de Comandos (CLI)

Analisar uma ou mais páginas

# Simples
python main.py pagina.html

# Com IA e detalhes verbosos
python main.py pagina.html --gemini --verbose

# Comparar múltiplos arquivos salvando resultado em JSON
python main.py "paginas/*.html" --compare --output relatorio.json

Aplicar Correções por IA

# Corrige todas as páginas listadas no relatório
python auto_fixer.py relatorio.json

# Modo segurança (apenas visualiza o que seria alterado)
python auto_fixer.py relatorio.json --dry-run

As versões corrigidas são salvas em uma nova pasta: /pages_optimized.

---

📁 Estrutura do Projeto

seo-analyzer/
├── main.py           # Orquestrador de análise
├── auto_fixer.py     # Engine de correção via IA
├── slug-analyzer.py  # Sugestor de URLs estratégicas
├── analyzers.py      # Lógica central dos 9 módulos de SEO
├── gemini_advisor.py # IA Advisor (Insights estratégicos)
├── reporter.py       # Renderização de tabelas e logs (Rich)
├── config.py         # Pesos, limites e configurações centrais
├── .env.example      # Template de credenciais
└── requirements.txt  # Dependências do projeto

---

🎯 Sistema de Score

As páginas recebem uma pontuação de 0 a 100 com base nos pesos mencionados.

Score	Rating	Significado
90-100	🚀 Excelente	Página otimizada, pronta para escalar.
75-89	✅ Bom	Pequenos ajustes necessários.
55-74	⚠️ Regular	Problemas que podem afetar o ranqueamento.
0-54	❌ Crítico	Necessita intervenção imediata.

---

⚖️ Licença

Este projeto está sob a licença MIT.