Coeus CI ロゴ

Coeus CI

すべてを見通す競合インテリジェンス。

Coeus（シーアス）にちなんで名付けられました。Coeus は、探究心を持つ百眼のギリシャ神話のティタン神であり、その名は文字通り「問いかけること」を意味します。CIはCompetitive Intelligence（競合インテリジェンス）の略です。

無料の公開データソースから企業プロフィールを構築する、ビジネスインテリジェンスOSINTツールです。ドメインを与えると、安定性、成長性、技術成熟度、財務健全性、セキュリティ体制、透明性を網羅したスコアリングレポートが返ってきます。

クイックスタート

# 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

使用方法

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

使用例

# 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

設定

デフォルト設定は、簡単に変更できるように1箇所にまとめられています：

coeus/__init__.py

DEFAULT_WEB_PORT = 8147          # --port: web dashboard port
DEFAULT_TIMEOUT = 30             # --timeout: per-module timeout (seconds)
DEFAULT_HOST = "127.0.0.1"      # bind address for web dashboard

これらの値を変更することで、お使いの環境に合わせた新しいデフォルトを設定できます。CLIフラグ（--port、--timeout）は実行ごとにこれらの設定を上書きします。

データソース (v0.1)

すべてのモジュールは無料で、APIキーは不要です。

スコアリング

各ターゲットは6つの評価軸（0〜10）でスコアリングされます：

出力形式

ターミナル — 色付きバー、検出結果、モジュール詳細を含むリッチフォーマットのスコアカード
JSON (--json) — パイプ処理や統合に使える完全なPydanticモデルダンプ
HTML (--html) — ./reports/ に保存される自己完結型のダークテーマレポート
Webダッシュボード (--web) — ライブスキャンの進捗状況を表示するインタラクティブなブラウザUI

アーキテクチャ

coeus-ci/
├── coeus/
│   ├── __init__.py          # Version + configurable defaults (port, timeout, host)
│   ├── __main__.py          # python -m coeus entry
│   ├── cli.py               # Click CLI with comparison mode
│   ├── core.py              # Two-wave async orchestrator
│   ├── models.py            # Pydantic data models
│   ├── scorer.py            # Weighted scoring engine
│   ├── report.py            # Terminal, JSON, HTML formatters
│   ├── matching.py          # Fuzzy company name matching
│   ├── web.py               # aiohttp web dashboard server
│   └── modules/
│       ├── base.py          # ABC base class for modules
│       ├── whois_mod.py     # WHOIS lookup
│       ├── dns_mod.py       # DNS analysis
│       ├── headers.py       # HTTP header analysis
│       ├── ssl_mod.py       # TLS certificate inspection
│       ├── tech.py          # Tech stack detection
│       ├── edgar.py         # SEC EDGAR filings
│       ├── nonprofit.py     # 501(c)(3) / ProPublica
│       └── dba.py           # DBA / OpenCorporates
├── templates/
│   ├── dashboard.html       # Web dashboard SPA
│   └── report.html          # Jinja2 HTML report template
├── setup.sh                 # One-time setup script
├── pyproject.toml           # Python packaging
├── LICENSE                  # AGPL-3.0
└── README.md

動作の仕組み

Wave 1 — 会社名を特定するため、最初にWHOISとSSLを実行します
Wave 2 — Wave 1で取得した会社名を使用して、他のすべてのモジュールを並列実行します
スコアリング — 各モジュールが6つの評価軸に対して重み付けスコアを提供します
レポート — 結果が単一のスコアリングレポートに集約されます

FAQ

デフォルトのWebダッシュボードポートを変更するには？

coeus/__init__.py を編集して DEFAULT_WEB_PORT を変更するか、--port フラグを使用します：

coeus --web --port 9090

デフォルトのタイムアウトを変更するには？

coeus/__init__.py を編集して DEFAULT_TIMEOUT を変更するか、--timeout フラグを使用します：

coeus apple.com --timeout 60

APIキーは必要ですか？

いいえ。v0.1の全モジュールはAPIキーが不要な無料の公開データソースを使用します。

EDGARが一部の企業で0.0を表示するのはなぜですか？

EDGARモジュールはSEC登録済みの公開企業のデータのみを検索します。非公開企業、非営利団体、海外の事業体にはEDGARデータがありません — これは想定された動作であり、エラーではありません。

nonprofitモジュールが誤った組織にマッチすることがあるのはなぜですか？

「Apple」のような一般的な会社名は、類似した名前の小規模な非営利団体にマッチすることがあります。ファジーマッチングは誤検知を減らしますが、非常に一般的な名前は本質的に曖昧です。--modules フラグを使用すると、関連性のないモジュールをスキップできます。

特定のモジュールのみを実行できますか？

はい：

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

新しいモジュールを追加するには？

BaseModule を継承した新しいファイルを coeus/modules/ に作成します
execute(target, context) メソッドを実装します
coeus/modules/__init__.py に登録します

ロードマップ

v0.1 — 基盤（現在）

8モジュールのインテリジェンスパイプライン（whois、dns、headers、ssl、tech、edgar、nonprofit、dba）
6次元スコアリングエンジン
ターミナル、JSON、HTML出力
ライブスキャン進捗を備えたWebダッシュボード
複数ターゲットの比較モード
企業名のファジーマッチング

v0.2 — 拡張

キャッシュレイヤー（24時間以内の再フェッチを防ぐ）
バッチモード（coeus --file targets.txt）
レート制限とリトライロジック
プレミアムデータソース向けのAPIキー統合
Hunter.io、BuiltWith、Crunchbase、GitHub、Shodanモジュール

v0.3 — 仕上げ

PDFレポートのエクスポート
履歴トラッキング（時間の経過に伴うスキャンの比較）
コミュニティモジュール向けプラグインシステム
CI/CD統合（スコア閾値に基づく終了コード）

ライセンス

AGPL-3.0 — 詳細は LICENSE を参照してください。

`whois`	WHOISレコード	ドメインの経過年数、レジストラ、組織名、作成日/有効期限
`dns`	DNSクエリ	MX、NS、SPF、DMARC、メールプロバイダ、CDN検出
`headers`	HTTPヘッダー	サーバーテクノロジー、セキュリティヘッダー（HSTS、CSPなど）
`ssl`	TLS証明書	証明書の組織、CA、有効期限、SANs
`tech`	robots.txt、sitemap、HTML	CMS検出、フレームワークシグネチャ、security.txt
`edgar`	SEC EDGAR	公開提出書類、収益、純利益、資産、従業員数
`nonprofit`	ProPublica API	501(c)(3)ステータス、Form 990データ、収益、資産
`dba`	OpenCorporates	DBA/事業登録、事業体タイプ、申告ステータス

安定性	組織の確立度	whois, ssl, edgar
成長性	拡大シグナル	edgar, tech
技術成熟度	最新のインフラと技術スタック	dns, headers, tech
財務	財務健全性の指標	edgar, nonprofit
セキュリティ	セキュリティ体制と衛生状態	dns, headers, ssl, tech
透明性	情報公開と説明責任	edgar, nonprofit, whois

coeus-ci

人気