Coeus CI 로고

Coeus CI

모든 것을 보는 경쟁 인텔리전스.

Coeus(SEE-us)라는 이름은 탐구하는 정신을 지닌 100개의 눈을 가진 그리스 티탄에서 유래했으며, 그 이름은 문자 그대로 "질문하기"라는 뜻입니다. 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

구성

기본 설정은 수정이 쉽도록 한 곳에 정의되어 있습니다:

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) — 실시간 스캔 진행 상황을 표시하는 대화형 브라우저 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

기본 웹 대시보드 포트를 변경하려면 어떻게 하나요?

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 데이터가 없을 수 있습니다 — 이는 정상적인 동작이지 오류가 아닙니다.

비영리 모듈이 때때로 잘못된 조직을 매칭하는 이유는 무엇인가요?

흔한 회사 이름(예: "Apple")은 비슷한 이름의 소규모 비영리 단체와 매칭될 수 있습니다. 퍼지 매칭이 오탐을 줄여 주지만, 매우 일반적인 이름은 본질적으로 모호합니다. --modules 플래그를 사용하면 관련 없는 모듈을 건너뛸 수 있습니다.

특정 모듈만 실행할 수 있나요?

네:

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

새 모듈을 추가하려면 어떻게 하나요?

coeus/modules/에 BaseModule을 상속하는 새 파일을 만듭니다.
execute(target, context) 메서드를 구현합니다.
coeus/modules/__init__.py에 등록합니다.

로드맵

v0.1 — 기반 (현재)

8개 모듈 인텔리전스 파이프라인 (whois, dns, headers, ssl, tech, edgar, nonprofit, dba)
6차원 점수 산정 엔진
터미널, JSON, HTML 출력
실시간 스캔 진행 상황을 표시하는 웹 대시보드
여러 대상에 대한 비교 모드
퍼지 회사 이름 매칭

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

인기