Coeus CI

Inteligência Competitiva que vê tudo.

Nomeado em homenagem a Coeus (SEE-us), o Titã grego de cem olhos da mente inquisitiva — cujo nome significa literalmente "questionamento". CI significa Inteligência Competitiva.

Uma ferramenta OSINT de inteligência de negócios que constrói perfis de empresas a partir de fontes de dados públicas gratuitas. Forneça um domínio — receba um relatório pontuado cobrindo estabilidade, crescimento, maturidade tecnológica, saúde financeira, postura de segurança e transparência.

Início Rápido

# Clone and install
git clone https://github.com/Opfour/coeus-ci.git
cd coeus-ci
./setup.sh          # creates venv, installs everything

# Activate the environment
source venv/bin/activate

# Run a scan
coeus apple.com

# Compare companies
coeus apple.com microsoft.com

# Export HTML report
coeus apple.com --html

# Launch web dashboard
coeus --web

Uso

coeus [OPÇÕES] [ALVOS]...

Opções:
  --json                 Saída como JSON
  --html                 Salvar relatório HTML em ./reports/
  -m, --modules TEXTO    Lista de módulos separada por vírgulas (ex.: whois,dns,edgar)
  -t, --timeout INTEIRO  Tempo limite por módulo em segundos (padrão: 30)
  --web                  Iniciar painel web interativo
  --port INTEIRO         Porta do painel web (padrão: 8147)
  --help                 Mostrar esta mensagem e sair

Exemplos

# Single target
coeus acme.com

# JSON output (pipe to jq, save to file, etc.)
coeus acme.com --json

# Run only specific modules
coeus acme.com --modules whois,dns,ssl

# Side-by-side comparison
coeus apple.com microsoft.com

# HTML report saved to ./reports/
coeus apple.com --html

# Web dashboard on default port
coeus --web

# Web dashboard on custom port
coeus --web --port 9090

Configuração

As configurações padrão são definidas em um único local para fácil modificação:

coeus/__init__.py

DEFAULT_WEB_PORT = 8147          # --port: porta do painel web
DEFAULT_TIMEOUT = 30             # --timeout: tempo limite por módulo (segundos)
DEFAULT_HOST = "127.0.0.1"      # endereço de bind para o painel web

Altere esses valores para definir novos padrões para seu ambiente. As flags da CLI (--port, --timeout) substituem estes a cada execução.

Fontes de Dados (v0.1)

Todos os módulos são gratuitos, sem necessidade de chave de API.

Pontuação

Cada alvo é pontuado em seis dimensões (0-10):

Formatos de Saída

• Terminal — Cartão de pontuação formatado de forma rica com barras coloridas, descobertas, detalhes dos módulos
• JSON (--json) — Despejo completo do modelo Pydantic para pipe ou integração
• HTML (--html) — Relatório autossuficiente com tema escuro salvo em ./reports/
• Painel Web (--web) — Interface de navegador interativa com progresso da varredura em tempo real

Arquitetura

coeus-ci/
├── coeus/
│   ├── __init__.py          # Versão + padrões configuráveis (porta, timeout, host)
│   ├── __main__.py          # entry point python -m coeus
│   ├── cli.py               # CLI Click com modo de comparação
│   ├── core.py              # Orquestrador assíncrono de duas ondas
│   ├── models.py            # Modelos de dados Pydantic
│   ├── scorer.py            # Motor de pontuação ponderada
│   ├── report.py            # Formatadores Terminal, JSON, HTML
│   ├── matching.py          # Correspondência difusa de nomes de empresas
│   ├── web.py               # Servidor do painel web aiohttp
│   └── modules/
│       ├── base.py          # Classe base ABC para módulos
│       ├── whois_mod.py     # Consulta WHOIS
│       ├── dns_mod.py       # Análise DNS
│       ├── headers.py       # Análise de cabeçalhos HTTP
│       ├── ssl_mod.py       # Inspeção de certificado TLS
│       ├── tech.py          # Detecção de stack tecnológico
│       ├── edgar.py         # Arquivos SEC EDGAR
│       ├── nonprofit.py     # 501(c)(3) / ProPublica
│       └── dba.py           # DBA / OpenCorporates
├── templates/
│   ├── dashboard.html       # SPA do painel web
│   └── report.html          # Template de relatório HTML Jinja2
├── setup.sh                 # Script de configuração única
├── pyproject.toml           # Empacotamento Python
├── LICENSE                  # AGPL-3.0
└── README.md

Como funciona

1. Onda 1 — WHOIS e SSL são executados primeiro para identificar o nome da empresa
2. Onda 2 — Todos os outros módulos são executados em paralelo usando o nome da empresa da Onda 1
3. Pontuação — Cada módulo contribui com pontuações ponderadas para as seis dimensões
4. Relatório — Os resultados são agregados em um único relatório pontuado

Perguntas Frequentes

Como alterar a porta padrão do painel web?

Edite coeus/__init__.py e altere DEFAULT_WEB_PORT, ou use a flag --port:

coeus --web --port 9090

Como alterar o tempo limite padrão?

Edite coeus/__init__.py e altere DEFAULT_TIMEOUT, ou use a flag --timeout:

coeus apple.com --timeout 60

Preciso de chaves de API?

Não. Todos os módulos v0.1 usam fontes de dados públicas gratuitas, sem necessidade de chaves de API.

Por que o EDGAR mostra 0.0 para algumas empresas?

O módulo EDGAR só encontra dados para empresas públicas registradas na SEC. Empresas privadas, organizações sem fins lucrativos e entidades estrangeiras não terão dados EDGAR — isso é esperado, não um erro.

Por que o módulo de organizações sem fins lucrativos às vezes corresponde à organização errada?

Nomes de empresas comuns (como "Apple") podem corresponder a pequenas organizações sem fins lucrativos com nomes semelhantes. A correspondência difusa reduz falsos positivos, mas nomes muito genéricos são inerentemente ambíguos. A flag --modules permite pular módulos que não são relevantes.

Posso executar apenas módulos específicos?

Sim:

coeus apple.com --modules whois,dns,ssl

Como adicionar um novo módulo?

1. Crie um novo arquivo em coeus/modules/ estendendo BaseModule
2. Implemente o método execute(target, context)
3. Registre-o em coeus/modules/__init__.py

Roteiro

v0.1 — Fundação (atual)

• Pipeline de inteligência de 8 módulos (whois, dns, headers, ssl, tech, edgar, nonprofit, dba)
• Motor de pontuação de seis dimensões
• Saída em Terminal, JSON e HTML
• Painel web com progresso da varredura em tempo real
• Modo de comparação para múltiplos alvos
• Correspondência difusa de nomes de empresas

v0.2 — Expansão

• Camada de cache (não buscar novamente em 24h)
• Modo lote (coeus --file targets.txt)
• Limitação de taxa e lógica de repetição
• Integração de chave de API para fontes de dados premium
• Módulos Hunter.io, BuiltWith, Crunchbase, GitHub, Shodan

v0.3 — Polimento

• Exportação de relatório PDF
• Acompanhamento histórico (comparar varreduras ao longo do tempo)
• Sistema de plugins para módulos da comunidade
• Integração CI/CD (códigos de saída baseados em limites de pontuação)

Licença

AGPL-3.0 — veja LICENSE para detalhes.