Coeus CI

Renseignement concurrentiel qui voit tout.

Nommé d'après Coeus (SEE-us), le Titan grec aux cent yeux de l'esprit curieux — dont le nom signifie littéralement « interroger ». CI signifie Renseignement Concurrentiel (Competitive Intelligence).

Un outil OSINT de renseignement d'affaires qui construit des profils d'entreprise à partir de sources de données publiques gratuites. Donnez-lui un nom de domaine — récupérez un rapport noté couvrant la stabilité, la croissance, la maturité technologique, la santé financière, la posture de sécurité et la transparence.

Démarrage rapide

# Cloner et installer
git clone https://github.com/Opfour/coeus-ci.git
cd coeus-ci
./setup.sh          # crée un venv, installe tout

# Activer l'environnement
source venv/bin/activate

# Lancer une analyse
coeus apple.com

# Comparer des entreprises
coeus apple.com microsoft.com

# Exporter un rapport HTML
coeus apple.com --html

# Lancer le tableau de bord web
coeus --web

Utilisation

coeus [OPTIONS] [TARGETS]...

Options :
  --json                 Sortie au format JSON
  --html                 Enregistrer le rapport HTML dans ./reports/
  -m, --modules TEXT     Liste de modules séparés par des virgules (ex. whois,dns,edgar)
  -t, --timeout INTEGER  Délai d'attente par module en secondes (défaut : 30)
  --web                  Lancer le tableau de bord web interactif
  --port INTEGER         Port du tableau de bord web (défaut : 8147)
  --help                 Afficher ce message et quitter

Exemples

# Cible unique
coeus acme.com

# Sortie JSON (pipe vers jq, sauvegarde dans un fichier, etc.)
coeus acme.com --json

# Exécuter seulement certains modules
coeus acme.com --modules whois,dns,ssl

# Comparaison côte à côte
coeus apple.com microsoft.com

# Rapport HTML sauvegardé dans ./reports/
coeus apple.com --html

# Tableau de bord web sur le port par défaut
coeus --web

# Tableau de bord web sur un port personnalisé
coeus --web --port 9090

Configuration

Les paramètres par défaut sont définis en un seul endroit pour une modification facile :

coeus/__init__.py

DEFAULT_WEB_PORT = 8147          # --port : port du tableau de bord web
DEFAULT_TIMEOUT = 30             # --timeout : délai d'attente par module (secondes)
DEFAULT_HOST = "127.0.0.1"      # adresse de liaison pour le tableau de bord web

Modifiez ces valeurs pour définir de nouvelles valeurs par défaut pour votre environnement. Les indicateurs en ligne de commande (--port, --timeout) remplacent ceux-ci lors de chaque exécution.

Sources de données (v0.1)

Tous les modules sont gratuits, sans clé API requise.

Score

Chaque cible est notée sur six dimensions (0-10) :

Formats de sortie

• Terminal — Fiche de notation richement formatée avec barres colorées, résultats, détails des modules
• JSON (--json) — Dump complet du modèle Pydantic pour piping ou intégration
• HTML (--html) — Rapport autonome sur thème sombre sauvegardé dans ./reports/
• Tableau de bord Web (--web) — Interface utilisateur interactive dans le navigateur avec progression en direct de l'analyse

Architecture

coeus-ci/
├── coeus/
│   ├── __init__.py          # Version + valeurs par défaut configurables (port, délai, hôte)
│   ├── __main__.py          # Point d'entrée python -m coeus
│   ├── cli.py               # CLI Click avec mode comparaison
│   ├── core.py              # Orchestrateur asynchrone en deux vagues
│   ├── models.py            # Modèles de données Pydantic
│   ├── scorer.py            # Moteur de scoring pondéré
│   ├── report.py            # Formateurs Terminal, JSON, HTML
│   ├── matching.py          # Correspondance floue des noms d'entreprise
│   ├── web.py               # Serveur de tableau de bord web aiohttp
│   └── modules/
│       ├── base.py          # Classe de base ABC pour les modules
│       ├── whois_mod.py     # Recherche WHOIS
│       ├── dns_mod.py       # Analyse DNS
│       ├── headers.py       # Analyse des en-têtes HTTP
│       ├── ssl_mod.py       # Inspection des certificats TLS
│       ├── tech.py          # Détection de la pile technologique
│       ├── edgar.py         # Dépôts SEC EDGAR
│       ├── nonprofit.py     # 501(c)(3) / ProPublica
│       └── dba.py           # DBA / OpenCorporates
├── templates/
│   ├── dashboard.html       # SPA du tableau de bord web
│   └── report.html          # Modèle de rapport HTML Jinja2
├── setup.sh                 # Script d'installation unique
├── pyproject.toml           # Empaquetage Python
├── LICENSE                  # AGPL-3.0
└── README.md

Fonctionnement

1. Vague 1 — WHOIS et SSL s'exécutent en premier pour identifier le nom de l'entreprise
2. Vague 2 — Tous les autres modules s'exécutent en parallèle en utilisant le nom de l'entreprise de la Vague 1
3. Scoring — Chaque module contribue avec des scores pondérés aux six dimensions
4. Rapport — Les résultats sont agrégés en un seul rapport noté

FAQ

Comment modifier le port par défaut du tableau de bord web ?

Modifiez coeus/__init__.py et changez DEFAULT_WEB_PORT, ou utilisez l'option --port :

coeus --web --port 9090

Comment modifier le délai d'attente par défaut ?

Modifiez coeus/__init__.py et changez DEFAULT_TIMEOUT, ou utilisez l'option --timeout :

coeus apple.com --timeout 60

Ai-je besoin de clés API ?

Non. Tous les modules v0.1 utilisent des sources de données publiques gratuites sans nécessité de clés API.

Pourquoi EDGAR affiche 0.0 pour certaines entreprises ?

Le module EDGAR ne trouve des données que pour les entreprises publiques enregistrées auprès de la SEC. Les entreprises privées, les associations à but non lucratif et les entités étrangères n'auront pas de données EDGAR — c'est normal, pas une erreur.

Pourquoi le module nonprofit correspond-il parfois à une mauvaise organisation ?

Les noms d'entreprise courants (comme « Apple ») peuvent correspondre à de petites associations à but non lucratif avec des noms similaires. La correspondance floue réduit les faux positifs, mais les noms très génériques sont intrinsèquement ambigus. L'option --modules permet de sauter les modules qui ne sont pas pertinents.

Puis-je exécuter seulement certains modules ?

Oui :

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

Comment ajouter un nouveau module ?

1. Créez un nouveau fichier dans coeus/modules/ en étendant BaseModule
2. Implémentez la méthode execute(target, context)
3. Enregistrez-le dans coeus/modules/__init__.py

Feuille de route

v0.1 — Fondation (actuelle)

• Pipeline d'intelligence à 8 modules (whois, dns, headers, ssl, tech, edgar, nonprofit, dba)
• Moteur de scoring à six dimensions
• Sortie Terminal, JSON et HTML
• Tableau de bord web avec progression en direct de l'analyse
• Mode comparaison pour plusieurs cibles
• Correspondance floue des noms d'entreprise

v0.2 — Expansion

• Couche de cache (ne pas re-extraire dans les 24h)
• Mode batch (coeus --file targets.txt)
• Limitation de débit et logique de nouvelle tentative
• Intégration de clés API pour sources de données premium
• Modules Hunter.io, BuiltWith, Crunchbase, GitHub, Shodan

v0.3 — Polissage

• Export de rapport PDF
• Suivi historique (comparer les analyses dans le temps)
• Système de plugins pour modules communautaires
• Intégration CI/CD (codes de sortie basés sur des seuils de score)

Licence

AGPL-3.0 — voir LICENSE pour les détails.