Coeus CI

Competitive Intelligence, die alles sieht.

Benannt nach Coeus (SEE-us), dem 100‑augigen griechischen Titanen des wissbegierigen Geistes – dessen Name wörtlich „fragend“ bedeutet. CI steht für Competitive Intelligence.

Ein Business‑Intelligence-OSINT‑Tool, das Unternehmensprofile aus kostenlosen öffentlichen Datenquellen erstellt. Gib eine Domain ein – erhalte einen bewerteten Bericht mit Informationen zu Stabilität, Wachstum, Technologiereife, Finanzlage, Sicherheitslage und Transparenz.

Schnellstart

# Klonen und installieren
git clone https://github.com/Opfour/coeus-ci.git
cd coeus-ci
./setup.sh          # erstellt venv, installiert alles

# Umgebung aktivieren
source venv/bin/activate

# Scan ausführen
coeus apple.com

# Unternehmen vergleichen
coeus apple.com microsoft.com

# HTML-Bericht exportieren
coeus apple.com --html

# Web‑Dashboard starten
coeus --web

Verwendung

coeus [OPTIONS] [TARGETS]...

Options:
  --json                 Output as JSON
  --html                 Save HTML report to ./reports/
  -m, --modules TEXT     Comma-separated module list (e.g., whois,dns,edgar)
  -t, --timeout INTEGER  Per-module timeout in seconds (default: 30)
  --web                  Launch interactive web dashboard
  --port INTEGER         Web dashboard port (default: 8147)
  --help                 Show this message and exit

Beispiele

# Einzelnes Ziel
coeus acme.com

# JSON-Ausgabe (an jq weiterleiten, in Datei speichern usw.)
coeus acme.com --json

# Nur bestimmte Module ausführen
coeus acme.com --modules whois,dns,ssl

# Direkter Vergleich
coeus apple.com microsoft.com

# HTML-Bericht in ./reports/ speichern
coeus apple.com --html

# Web‑Dashboard auf Standardport
coeus --web

# Web‑Dashboard auf benutzerdefiniertem Port
coeus --web --port 9090

Konfiguration

Die Standardeinstellungen sind an einer Stelle für einfache Änderungen definiert:

coeus/__init__.py

DEFAULT_WEB_PORT = 8147          # --port: Web‑Dashboard‑Port
DEFAULT_TIMEOUT = 30             # --timeout: Timeout pro Modul (Sekunden)
DEFAULT_HOST = "127.0.0.1"      # Bindungsadresse für das Web‑Dashboard

Ändere diese Werte, um neue Standardwerte für deine Umgebung festzulegen. CLI‑Flags (--port, --timeout) überschreiben diese pro Durchlauf.

Datenquellen (v0.1)

Alle Module sind kostenlos und benötigen keinen API‑Key.

Bewertung

Jedes Ziel wird in sechs Dimensionen bewertet (0-10):

Ausgabeformate

• Terminal – Reich formatiertes Bewertungsdiagramm mit farbigen Balken, Ergebnissen, Moduldetails
• JSON (--json) – Vollständiger Pydantic‑Model‑Dump zum Weiterleiten oder zur Integration
• HTML (--html) – In sich geschlossener Bericht im dunklen Design, gespeichert in ./reports/
• Web‑Dashboard (--web) – Interaktive Browser‑UI mit Live‑Scan‑Fortschritt

Architektur

coeus-ci/
├── coeus/
│   ├── __init__.py          # Version + konfigurierbare Standardwerte (Port, Timeout, Host)
│   ├── __main__.py          # python -m coeus Einstiegspunkt
│   ├── cli.py               # Click‑CLI mit Vergleichsmodus
│   ├── core.py              # Asynchroner Orchestrator mit zwei Wellen
│   ├── models.py            # Pydantic‑Datenmodelle
│   ├── scorer.py            # Gewichtete Bewertungsengine
│   ├── report.py            # Terminal‑, JSON‑ und HTML‑Formatierer
│   ├── matching.py          # Fuzzy‑Unternehmensnamensabgleich
│   ├── web.py               # aiohttp‑Web‑Dashboard‑Server
│   └── modules/
│       ├── base.py          # ABC‑Basisklasse für Module
│       ├── whois_mod.py     # WHOIS‑Lookup
│       ├── dns_mod.py       # DNS‑Analyse
│       ├── headers.py       # HTTP‑Header‑Analyse
│       ├── ssl_mod.py       # TLS‑Zertifikatsprüfung
│       ├── tech.py          # Technologie‑Stack‑Erkennung
│       ├── edgar.py         # SEC EDGAR‑Einreichungen
│       ├── nonprofit.py     # 501(c)(3) / ProPublica
│       └── dba.py           # DBA / OpenCorporates
├── templates/
│   ├── dashboard.html       # Web‑Dashboard‑SPA
│   └── report.html          # Jinja2‑HTML‑Berichtsvorlage
├── setup.sh                 # Einmaliges Einrichtungsskript
├── pyproject.toml           # Python‑Paketierung
├── LICENSE                  # AGPL-3.0
└── README.md

Funktionsweise

1. Welle 1 – WHOIS und SSL laufen zuerst, um den Unternehmensnamen zu identifizieren
2. Welle 2 – Alle anderen Module laufen parallel unter Verwendung des Firmennamens aus Welle 1
3. Bewertung – Jedes Modul liefert gewichtete Bewertungen zu den sechs Dimensionen
4. Bericht – Die Ergebnisse werden in einem einzigen bewerteten Bericht zusammengefasst

FAQ

Wie ändere ich den Standardport des Web‑Dashboards?

Bearbeite coeus/__init__.py und ändere DEFAULT_WEB_PORT, oder verwende das Flag --port:

coeus --web --port 9090

Wie ändere ich das Standard‑Timeout?

Bearbeite coeus/__init__.py und ändere DEFAULT_TIMEOUT, oder verwende das Flag --timeout:

coeus apple.com --timeout 60

Brauche ich API‑Keys?

Nein. Alle Module von v0.1 verwenden kostenlose öffentliche Datenquellen ohne API‑Keys.

Warum zeigt EDGAR für manche Unternehmen 0,0?

Das EDGAR‑Modul findet nur Daten für bei der SEC registrierte börsennotierte Unternehmen. Private Unternehmen, Non‑Profits und ausländische Unternehmen haben keine EDGAR‑Daten – das ist erwartet, kein Fehler.

Warum findet das Non‑Profit‑Modul manchmal die falsche Organisation?

Häufige Firmennamen (wie „Apple“) können kleine Non‑Profits mit ähnlichen Namen treffen. Fuzzy‑Matching reduziert Fehlalarme, aber sehr allgemeine Namen sind von Natur aus mehrdeutig. Mit dem Flag --modules kannst du Module überspringen, die nicht relevant sind.

Kann ich nur bestimmte Module ausführen?

Ja:

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

Wie füge ich ein neues Modul hinzu?

1. Erstelle eine neue Datei in coeus/modules/, die BaseModule erweitert
2. Implementiere die Methode execute(target, context)
3. Registriere es in coeus/modules/__init__.py

Fahrplan

v0.1 – Grundlage (aktuell)

• 8‑Modul‑Intelligenz‑Pipeline (whois, dns, headers, ssl, tech, edgar, nonprofit, dba)
• Bewertungsengine mit sechs Dimensionen
• Terminal‑, JSON‑ und HTML‑Ausgabe
• Web‑Dashboard mit Live‑Scan‑Fortschritt
• Vergleichsmodus für mehrere Ziele
• Fuzzy‑Unternehmensnamensabgleich

v0.2 – Erweiterung

• Cache‑Schicht (kein erneuter Abruf innerhalb von 24h)
• Batch‑Modus (coeus --file targets.txt)
• Ratenbegrenzung und Wiederholungslogik
• API‑Key‑Integration für Premium‑Datenquellen
• Hunter.io, BuiltWith, Crunchbase, GitHub, Shodan‑Module

v0.3 – Verfeinerung

• PDF‑Berichtsexport
• Historische Nachverfolgung (Scans im Zeitverlauf vergleichen)
• Plugin‑System für Community‑Module
• CI/CD‑Integration (Exit‑Codes basierend auf Bewertungsschwellen)

Lizenz

AGPL-3.0 – siehe LICENSE für Details.