SOCMIntelligence

멀티 플랫폼 SOCMINT / OSINT 웹 도구.

---

개요

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

모듈

그룹	모듈
소셜 네트워크	X (Twitter) · Instagram · Bluesky · LinkedIn · YouTube · TikTok · Twitch · Kick · Snapchat · Reddit · Mastodon · Telegram · Discord · Steam
개발자	GitHub · GitLab · Stack Exchange · Hacker News
신원 및 아카이브	Keybase · Gravatar · Wayback Machine
검색 및 지도	키워드 검색 (Bluesky · Reddit · Mastodon) · 해시태그 지도

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

기능

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

설치

pipx (Linux에서 권장)

pipx install socmintelligence
socmintelligence

또는 virtualenv 내에서 pip를 사용하는 경우:

pip install socmintelligence
socmintelligence

그런 다음 **http://localhost:8000**을 엽니다. 옵션: socmintelligence --host 0.0.0.0 --port 8000 --data-dir ~/socmint-data --no-browser. 데이터(케이스, 설정)는 --data-dir 또는 SOCMINT_DATA_DIR이 설정되지 않은 경우 ~/.local/share/socmintelligence에 저장됩니다.

GitHub에서 바로 설치: pipx install git+https://github.com/emrekybs/SOCMIntelligence

빠른 시작 (소스에서)

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

Then open http://localhost:8000 — API docs at http://localhost:8000/docs.

Next runs only need:

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

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

구성

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

• API 키 — 서버 측에 저장되며 브라우저로 절대 반환되지 않습니다(“설정됨” + 마지막 4자만 표시됨).
  • YOUTUBE_API_KEY — YouTube 모듈에 필요합니다.
  • HIKERAPI_TOKEN — Instagram (HikerAPI). 이것이 없으면 Instagram 모듈은 명확히 표시된 샘플 데이터를 보여줍니다.
  • 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 팔로워 “성장”은 실제 기록이 아닌 추정치입니다(그렇게 표시됨).

라이선스

Apache License 2.0 — LICENSE를 참조하세요.