# SEOnex — Plataforma de Processamento e Otimização de Conteúdo SEO

## O que é o SEOnex

SEOnex é uma plataforma independente de análise e otimização de conteúdo para SEO e para motores de IA generativa. Processa documentos (URL, HTML, PDF, DOCX, texto) por um pipeline NLP de 13 etapas e retorna relatórios estruturados.

## Produto

- **Endpoint público**: https://app.seonex.ia.br
- **API pública**: https://api.seonex.ia.br
- **Documentação**: https://seonex.ia.br

## Funcionalidades principais

- Score SEO geral (0-100) dividido por dimensões: técnico, conteúdo, estrutura, legibilidade
- Análise completa de meta tags (title, description, Open Graph, Twitter Card, canonical)
- Geração automática de Schema.org JSON-LD (Article, FAQ, BreadcrumbList, Product)
- Reconhecimento de entidades nomeadas (marcas, pessoas, locais, produtos) via spaCy pt_core_news_sm
- Análise de legibilidade Flesch-Kincaid adaptado para pt-BR
- Geração automática de FAQ estruturado (perguntas + respostas + JSON-LD)
- Clustering semântico e sugestões de estrutura em silo
- Sugestões de links internos com contexto
- Detecção de canibalização de conteúdo (similaridade TF-IDF)

## Score AEO (Answer Engine Optimization)

O Score AEO mede a prontidão do conteúdo para ser citado por motores de IA generativa (ChatGPT, Perplexity, Google SGE, Bing Copilot):

- **Componentes**: clareza de resposta, estrutura FAQ, dados estruturados, acesso de crawlers, profundidade factual
- **Verificações**: robots.txt (permissão para GPTBot, PerplexityBot, ClaudeBot, Googlebot-Extended), presença de llms.txt, qualidade das perguntas/respostas FAQ
- **Geração de llms.txt**: arquivo gerado automaticamente com metadados, tópicos e contexto para crawlers de IA

## Integrações

SEOnex funciona como motor NLP para o SEOFlow (https://seoflow.com.br), plataforma SaaS de relatórios SEO, via API REST autenticada com X-API-Key.

## Stack técnico

- Backend: FastAPI + Python 3.11 + spaCy + scikit-learn
- Fila de processamento: Redis + RQ (Redis Queue)
- Banco de dados: PostgreSQL 15
- Deploy: VPS Hostinger + Docker Compose
- Frontend: HTML/CSS/JS vanilla hospedado na Cloudflare Pages

## Contato

- Site: https://seonex.ia.br
- API: https://api.seonex.ia.br/docs
- Suporte: falecom@seonex.ia.br