Reconator é um framework automatizado de reconhecimento. Adicione um alvo — sozinho ou em lote — e o worker executa aproximadamente 17 módulos de reconhecimento contra ele (enumeração de subdomínios, dirbrute, mineração de JS/links, impressão digital de WAF, verificação de takeover, triagem GF e muito mais). O painel mostra a saída de cada módulo conforme ela chega.

Stack

Início rápido — Docker Compose

git clone https://github.com/gokulapap/Reconator
cd Reconator
cp .env.example .env       # opcional: adicione chaves do Telegram / webhook / chave de API
docker compose up --build

Início rápido — Heroku

Ou via CLI (usa o stack de contêineres heroku.yml — uma única imagem serve UI + API, o dyno worker executa a fila):

heroku create my-reconator --stack=container
heroku addons:create heroku-postgresql:essential-0
heroku config:set ADMIN_API_KEY=$(openssl rand -hex 32)   # recomendado
heroku config:set TELEGRAM_API_KEY=... TELEGRAM_CHAT_ID=...   # opcional
git push heroku master
heroku ps:scale web=1 worker=1

Desenvolvimento local

# api
cd backend && pip install -r requirements.txt
uvicorn app.main:app --reload

# worker (terminal separado)
python -m app.worker

# web (terminal separado)
cd frontend && npm install && npm run dev   # proxy /api → :8000

# testes + lint
cd backend && pytest && ruff check .

Funcionalidades

• Adição em lote — cole até 500 domínios; relatório de erro/conflito por linha
• Tags + filtragem — marque alvos com tags, filtre a listagem por tag
• Seleção de módulos — agende apenas os módulos desejados por alvo
• Cancelar + reescanear — pare um alvo em execução entre módulos; reescanee com um clique
• Resultados por módulo — a saída de cada verificação é sua própria linha, com status, tempo e erros
• Busca + destaque na saída — filtre grandes dumps de subdomínios no lugar
• Exportação CSV / JSON — baixe toda a fila pela API
• Painel ao vivo — contagens, duração média de varredura, atividade recente
• Autenticação opcional por chave de API — defina ADMIN_API_KEY, todas as mutações exigem X-API-Key
• Limitação de taxa — slowapi limita escritas (padrões: 20/min por alvo, 5/min em lote)
• Métricas Prometheus — taxa de requisições, latência, contagens de varredura, profundidade da fila
• Fan-out Telegram + webhook — abstração de notificador, ambos podem funcionar juntos
• Interface clara + escura — preferência armazenada por navegador

Superfície da API

OpenAPI em /docs.

Configuração

O que mudou desde v1

• Flask → FastAPI; vetores de injeção SQL removidos (SQLAlchemy parametrizado)
• HTML embutido → painel React + shadcn/ui
• Blob único base64 no BD → linhas por módulo com status / timestamps / erros
• Loop de polling cron.py → worker com bloqueio de linha, desligamento gracioso, cancelamento
• Buildpacks manuais Heroku → stack de contêineres via heroku.yml
• Adicionado: autenticação por chave de API, limitação de taxa, IDs de requisição, Prometheus, hook Sentry, importação em lote, tags, reescaneamento, cancelamento, notificador webhook, exportação CSV/JSON

Aviso

Apenas para testes autorizados. Use em sistemas que você possui ou tem permissão para avaliar. Lançado sob GPL-3.0.