OpenOSINT/OpenOSINT
AI-powered OSINT agent with interactive REPL, MCP server, and CLI. 20 tools. Works with Claude, GPT-4, or local models. For authorized security research only.
OpenOSINT – AI 기반 OSINT 어시스턴트
정의 – OpenOSINT는 셀프 호스팅, MIT 라이선스 Python 패키지로, 21개의 공개 출처 인텔리전스(OSINT) 유틸리티를 자연어 인터페이스 뒤에 래핑합니다. LLM(Claude, Ollama 또는 OpenAI 호환 모델)은 어떤 도구를 실행할지 결정하는 "에이전트" 역할을 하고, 도구를 실행하며, 결과를 간결한 조사 보고서로 연결합니다. 동일한 도구 세트는 다음을 통해 액세스할 수 있습니다:
- 대화형 REPL(
openosint), - CLI(
openosint email …), - 브라우저 기반 채팅 UI(
openosint web), 또는 - 모든 MCP 호환 클라이언트가 호출할 수 있는 Model Context Protocol(MCP) 서버.
주요 기능
| 기능 | 세부 사항 |
|---|---|
| AI 기반 도구 연결 | 대상자를 평이한 영어로 설명하면 LLM이 관련 OSINT 도구를 선택하고 실행하며 결과를 종합합니다. |
| 21개의 모듈식 도구 | 이메일, 사용자 이름, 유출, WHOIS, IP, 하위 도메인, DNS, dork, 라이브 dork 검색, paste-bin, 전화, Shodan, VirusTotal, Censys, IP2Location, AbuseIPDB, GitHub, RDAP, GDELT 지리 뉴스, URL 스크래핑, 발자국 추출. |
| 세 가지 AI 백엔드 | Anthropic Claude(기본), 로컬 Ollama, 또는 모든 OpenAI 호환 엔드포인트(LiteLLM, vLLM, LM Studio 등). |
| MCP 서버 | 오픈 소스 Model Context Protocol을 통해 수동적 도구(기본 20개)를 노출합니다. openosint-mcp로 시작할 수 있습니다. |
| 수동 기본 모드 | 제3자 API를 쿼리하거나 로컬에서 계산하는 도구만 제공됩니다. 대상자의 인프라에 접촉하는 "활성" 도구는 명시적으로 활성화하지 않는 한 숨겨집니다(--allow-active). |
| 병렬 실행 | --parallel은 asyncio.gather()를 사용하여 독립적인 도구를 동시에 실행합니다. |
| 자동 보고 | 각 조사 후 Markdown(및 선택적으로 PDF) 보고서가 reports/ 아래에 저장됩니다. |
| 세션 기록 | REPL 세션은 ~/.openosint/history/에 저장되며 openosint history로 나열할 수 있습니다. |
| 웹 UI | 스트리밍 LLM 출력, 도구 카드, 라이트/다크 테마를 갖춘 브라우저 기반 채팅. |
| 클라우드 옵션 | 동일한 도구가 종량제 Apify Actors로 제공됩니다. 라이브 데모는 https://demo.openosint.tech에서 사용할 수 있습니다. |
시작하기
# 패키지 설치(Python 3.9+)
pip install openosint
# 기본 AI REPL 시작(Anthropic 키가 있으면 Claude가 사용됨)
openosint
# 또는 웹 UI 시작
openosint web
# AI 없이 단일 도구 실행
openosint email target@example.com
사용하려는 서비스(예: HaveIBeenPwned, Shodan, VirusTotal, IP2Location, Bright Data 등)에 대한 API 키가 필요합니다. 키는 도구별 문서에 설명된 대로 환경 변수를 통해 전달됩니다.
도구 수준 개요(발췌)
search_email– holehe를 사용하여 이메일에 연결된 소셜 계정을 나열합니다(노이즈가 많으며 기본적으로 꺼짐).search_username– sherlock을 사용하여 400개 이상의 사이트에서 사용자 이름을 프로브합니다(노이즈가 많으며 기본적으로 꺼짐).search_breach– HaveIBeenPwned에 유출 노출을 쿼리합니다.search_whois–python-whois를 통해 WHOIS 데이터를 가져옵니다.search_ip– ipinfo.io를 통한 IP 지리적 위치.search_dns–dnspython을 사용한 DNS 레코드 조회. DKIM 프로빙은 활성 모드에서만 활성화됩니다.search_shodan,search_virustotal,search_censys,search_abuseipdb– 각각의 API에 대한 읽기 전용 조회.search_dorks_live/search_footprint– Bright Data를 통한 Google SERP 쿼리(수동적이지만 대상자의 쿼리가 Bright Data로 전송됨).scrape_url– Bright Data의 Web Unlocker를 통해 URL을 가져옵니다(대상자에게 접촉하므로 기본적으로 비활성화됨).
안전 및 제한
- 수동 모드는 의도치 않게 대상자의 서버에 접촉하지 않도록 보호합니다. 활성 도구는 명시적으로 활성화해야 합니다.
- 각 조사는 과도한 사용을 방지하기 위해 15회의 도구 호출(
investigate_multi의 경우 30회)로 제한됩니다. - 모든 제3자 API 호출은 해당 공급자에게 표시됩니다. README는 "수동이 개인 정보 보호를 의미하지는 않습니다"라고 강조합니다.
- 법적 고지: 권한이 있는 대상자에 대해서만 사용하십시오.
설치 및 라이선스
- PyPI를 통해 설치 가능(
pip install openosint). - MIT 라이선스(
LICENSE참조). - 프로젝트는 별도 설치 없이
uvx로 실행할 수 있는 MCP 서버 바이너리(openosint-mcp)도 게시합니다.
결론 – OpenOSINT는 보안 분석가가 자연어를 통해 공개 출처 도구 모음을 구동할 수 있는 진정한 오픈 소스 AI 증강 OSINT 플랫폼입니다. LLM 기반 오케스트레이션, 유연한 MCP API, 셀프 호스팅 및 클라우드 호스팅 실행 경로를 결합하여 자동화된 인텔리전스 워크플로를 위한 유용한 구성 요소가 됩니다.
관련
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트