SOCMIntelligence

멀티 플랫폼 SOCMINT / OSINT 웹 도구.
15개 소스 모듈, 크로스 플랫폼 신원 그래프, 동일인 점수 산정, 케이스 관리 및 변조 방지 보고서 — 단일 명령으로 시작되는 하나의 FastAPI 앱에서 제공됩니다.

개요

SOCMIntelligence는 여러 플랫폼에서 공개 데이터를 수집하여 각 결과를 차트, 발견 테이블, 관계 그래프로 변환하고, 모든 것을 하나의 크로스 플랫폼 신원 그래프로 병합합니다. 동일한 계정은 어디서나 같은 노드 ID를 부여받기 때문에, 서로 다른 두 스캔에서 나타난 이메일, 도메인 또는 사용자 이름이 자동으로 연결됩니다 — 이를 통해 여러 서비스에 걸쳐 누가 누구인지 파악할 수 있습니다.

모듈

각 모듈은 공개 데이터만 읽습니다 (또는 키가 제공된 경우 공식 API를 사용합니다). 비공개 계정에 대한 자격 증명/세션 스크래핑은 없습니다.

기능

• 관계 그래프 — 모든 성공적인 스캔을 병합하는 D3 포스 그래프. 크로스 플랫폼 매칭 (공유 이메일, 도메인, 사용자 이름), 피벗팅 (노드를 더블클릭하면 해당 모듈에서 스캔), 검색, 유형 필터, PNG/JSON 내보내기.
• 타임라인 — 모든 계정의 게시물, 댓글, 업로드 및 계정 생성 이벤트를 하나의 축에 표시하고, 시간대 중첩 히트맵과 시간 유사성 테이블을 제공합니다.
• 신원 매칭 — 각 계정 쌍에 대해 0–100 “동일인?” 점수를 근거와 함께 제공합니다 (인증/암호학적 연결, 공유 이메일, 사용자 이름 및 표시 이름 유사도, 공유 개인 도메인, 아바타 pHash, 활동 시간). 40점 이상인 쌍은 그래프에 표시됩니다.
• 비교 — 동일 모듈의 스캔된 계정 2개 이상을 나란히 배치합니다 (KPI 테이블 + 막대 차트, 최고값 강조).
• 분석가 표시 — 그래프 노드를 Verified / Suspicious / Dismissed로 표시하고, 메모를 추가하고, 수동 노드와 링크를 추가합니다. 모두 케이스에 저장됩니다.
• 케이스 관리 — 케이스를 생성하고 활성화하면 스캔/표시/메모가 자동으로 저장됩니다. .socmint 패키지를 가져오기/내보내기할 수 있습니다.
• 변경 추적 (모니터링) — 일정에 따라 대상을 재스캔하고 변경된 사항 (필드, 추가/제거된 링크)을 기록합니다.
• 증거 무결성 — 모든 스캔의 원시 데이터는 수집 시점에 해시됩니다 (정규화된 JSON에 대한 SHA-256). 검증 버튼으로 변조 여부를 확인할 수 있습니다.
• 내보내기 — HTML / PDF 보고서, Excel (.xlsx), GraphML (Gephi/yEd), GEXF (Gephi), Maltego CSV, JSON.
• 이중 언어 UI — 터키어 / 영어 토글 (기본 터키어). 보고서, 스프레드시트, 차트 레이블, 날짜 및 숫자 형식이 모두 선택한 언어를 따릅니다.
• 설정 페이지 — API 키, 프록시 / Tor / 프록시 목록 로테이션 및 속도 제한을 .env 대신 UI에서 관리합니다.

빠른 시작

python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
uvicorn server:app --host 0.0.0.0 --port 8000

그런 다음 http://localhost:8000 을 엽니다 — API 문서는 http://localhost:8000/docs 에 있습니다.

이후 실행에는 다음만 필요합니다:

source .venv/bin/activate && uvicorn server:app --port 8000

Docker: docker compose up --build (단일 서비스).

구성

모든 구성은 설정 페이지에 있습니다 (data/settings.json 에 저장되며, .env 도 여전히 읽히지만 설정이 우선합니다):

• API 키 — 서버 측에 저장되며 브라우저로 반환되지 않습니다 (“설정됨” + 마지막 4자만 표시).
  • YOUTUBE_API_KEY — YouTube 모듈에 필요합니다.
  • X_BEARER_TOKEN — X (Twitter) API v2. 이것이 없으면 X 모듈은 명확히 레이블이 지정된 샘플 데이터를 표시하므로 토큰을 추가하기 전에 출력을 미리 볼 수 있습니다.
  • STEAM_API_KEY, STACKEXCHANGE_KEY, GRAVATAR_API_KEY, GITLAB_TOKEN — 선택 사항이며 추가 데이터를 사용할 수 있습니다.
• 프록시 / Tor — 끄기, Tor, 단일 사용자 지정 프록시, 또는 스캔마다 라운드 로빈으로 로테이션되는 프록시 목록 (속도 제한을 분산).
• 속도 — 병렬 스캔 수와 요청 간 지연.

참고 사항

• X (Twitter): 무료 X 플랜은 매우 제한적입니다 — 토큰이 있어도 일부 플랜에서는 게시물 기록이 비어 있을 수 있으며, 모듈은 해당 경우를 레이블로 표시합니다.
• Telegram 은 공개 t.me/s/ 미리보기만 읽습니다 (로그인 없음).
• Gravatar 는 이메일의 MD5/SHA-256 해시만 수신하며, 이메일 자체는 전송되지 않습니다.
• TikTok 은 자주 속도 제한/봇 차단을 적용합니다. 모듈은 재시도하며 실제 “찾을 수 없음”과 일시적 차단을 구분합니다.
• 시간 분포는 UTC입니다. TikTok 팔로워 “증가”는 추정치이며 (그렇게 표시됨), 실제 기록이 아닙니다.
• backend/app/tools/youtube_osint.py 에는 하드코딩된 대체 API 키가 포함되어 있습니다 — 설정에서 자신의 키로 교체하고 해당 줄을 제거하세요.

라이선스

Apache License 2.0 — LICENSE 참조.