Maigret

English · 简体中文

Maigret는 사용자 이름만으로 개인에 대한 정보 파일을 수집하여, 수많은 사이트에서 계정을 확인하고 웹 페이지에서 얻을 수 있는 모든 정보를 수집합니다. API 키가 필요 없습니다. AI 프로파일링 (데모).

스폰서

IPcook은 온라인 조사, 사용자 이름 검색, 공개 데이터 수집 워크플로우를 위한 안정적인 리지덴셜 프록시를 제공합니다. 높은 성공률 • 99.99% 가동 시간 • 0.5초 미만의 응답 시간 • 월간 및 종량제 • 만료되지 않는 트래픽 • 팀 협업을 위한 최대 10개의 무료 하위 계정 • GB당 $0.3–$3.2의 리지덴셜 프록시.
특별 혜택: 무료 100MB 체험판 제공. 코드 WELCOME20 사용 시 20% 할인.

RapidProxy는 Twitter 스크래핑, Selenium 자동화, 웹 데이터 추출을 위한 고성능 리지덴셜 프록시를 제공합니다. 9천만 개 이상의 IP • 스마트 로테이션 • 차단 방지 • 만료되지 않는 트래픽.
특별 혜택: 무료 체험 — GB당 $0.65부터. 코드 RAPID10 사용 시 10% 할인.

1분 안에

Python 3.10 이상이 설치되어 있는지 확인하세요.

pip install maigret
maigret YOUR_USERNAME

설치가 필요 없나요? 커뮤니티 Telegram 봇 또는 Cloud Shell을 사용해 보세요.

웹 UI를 원하시나요? 실행 방법을 확인하세요.

참고: 빠른 시작.

주요 기능

3,000개 이상의 사이트 지원 (전체 목록 보기). 기본 실행은 트래픽 기준 상위 500개 사이트를 확인합니다. 전체 검색은 -a를, 카테고리/국가별 필터링은 --tags를 사용하세요.
Python 프로젝트에 내장 가능 — maigret을 import하여 프로그래밍 방식으로 검색 실행 (라이브러리 사용법 참조: library usage).
프로필 페이지와 사이트 API에서 계정 소유자에 대한 모든 사용 가능한 정보를 추출하며, 다른 계정 링크도 포함합니다.
발견된 사용자 이름과 기타 ID를 사용하여 재귀 검색을 수행합니다.
태그(사이트 카테고리, 국가)별 필터링을 지원합니다.
차단, 검열, CAPTCHA를 감지하고 부분적으로 우회합니다.
실행 시마다 GitHub에서 자동 업데이트되는 사이트 데이터베이스를 가져오며(24시간마다 1회), 오프라인일 경우 내장 데이터베이스로 대체합니다.
Tor 및 I2P 웹사이트에서 작동하며, 도메인 확인이 가능합니다.
결과를 그래프로 탐색하고 단일 페이지에서 모든 형식의 보고서를 다운로드할 수 있는 웹 인터페이스가 포함되어 있습니다.
선택적 AI 분석 모드 (--ai) — OpenAI 호환 API를 사용하여 원시 결과를 짧은 조사 요약으로 변환합니다.

전체 기능 목록은 기능 문서를 참조하세요.

사용처

Maigret 기반으로 구축된 전문 OSINT 및 소셜 미디어 분석 도구:

데모

비디오

보고서

PDF 보고서, HTML 보고서

HTML 보고서 스크린샷

XMind 8 보고서 스크린샷

전체 콘솔 출력

설치

이미 1분 안에 단계를 실행했나요? 준비 완료입니다. 아래는 대체 방법입니다.

아무것도 설치하고 싶지 않나요? 커뮤니티 Telegram 봇을 사용하세요.

Windows

Releases에서 maigret_standalone.exe를 다운로드하세요. 두 가지 방법으로 실행할 수 있습니다:

더블 클릭 — Maigret이 사용자 이름을 묻고 기본 검색을 실행한 후, 보고서 링크가 보이도록 마지막에 대기합니다.
터미널에서 실행 — 명령 프롬프트(Win+R 누르고 cmd 입력 후 Enter) 또는 PowerShell을 열어 추가 옵션을 전달하세요:

cd %USERPROFILE%\Downloads
maigret_standalone.exe USERNAME
maigret_standalone.exe USERNAME --html       :: HTML 보고서도 저장
maigret_standalone.exe --help                :: 모든 옵션 나열

비디오 가이드: https://youtu.be/qIgwTZOmMmM.

Cloud Shell

클라우드 셸 또는 Jupyter 노트북을 통해 브라우저에서 Maigret을 실행하세요:

로컬 설치 (pip)

# pypi에서 설치
pip3 install maigret

# 사용법
maigret username

소스에서

# 또는 클론하여 수동 설치
git clone https://github.com/soxoj/maigret && cd maigret

# 빌드 및 설치
pip3 install .

# 사용법
maigret username

Docker

두 가지 이미지 변형이 게시됩니다:

soxoj/maigret:latest — CLI 모드 (기본값)
soxoj/maigret:web — 웹 인터페이스 자동 실행

# 공식 이미지 (CLI)
docker pull soxoj/maigret

# CLI 사용법
docker run -v /mydir:/app/reports soxoj/maigret:latest username --html

# 웹 UI (http://localhost:5000 열기)
docker run -p 5000:5000 soxoj/maigret:web

# 사용자 지정 포트의 웹 UI
docker run -e PORT=8080 -p 8080:8080 soxoj/maigret:web

# 수동 빌드
docker build -t maigret .                  # CLI 이미지 (기본 타겟)
docker build --target web -t maigret-web . # 웹 UI 이미지

문제 해결

빌드 오류가 발생하나요? 문제 해결 가이드를 참조하세요.

PDF 보고서(--pdf)는 선택적 추가 기능입니다 — pip install 'maigret[pdf]'로 설치하세요. Linux/macOS에서는 시스템 수준 그래픽 라이브러리가 필요합니다. OS별 설치 단계는 PDF 보고서 섹션을 참조하세요.

사용법

예시

# HTML, PDF, XMind 보고서 생성
maigret user --html
maigret user --pdf
maigret user --xmind # XMind 2022+ 리더용 매니페스트가 포함된 레거시 XML

# 기계 판독 가능 내보내기
maigret user --json ndjson   # 줄바꿈 구분 JSON (대안: --json simple)
maigret user --csv
maigret user --txt
maigret user --graph         # 대화형 D3 그래프 (HTML)
maigret user --neo4j         # Neo4j Cypher 스크립트 (그래프 데이터베이스)

# photo 및 dating 태그가 있는 사이트 검색
maigret user --tags photo,dating

# us 태그가 있는 사이트 검색
maigret user --tags us

# 페이지에 특정 키워드도 언급하는 사이트 강조 표시
maigret user --keywords python rust
# 키워드 일치 사이트는 밝은 녹색으로 "[++]" 표시

# 모든 사용 가능한 사이트에서 세 개의 사용자 이름 검색
maigret user1 user2 user3 -a

# AI 지원 조사 요약 (OPENAI_API_KEY 필요)
maigret user --ai

--neo4j는 결과 그래프의 *_neo4j.cypher 스크립트를 작성합니다. cypher-shell -u neo4j -p <password> < report_user_neo4j.cypher로 가져오거나 Neo4j Browser에 붙여넣으세요. 재가져오기는 멱등적입니다. Neo4j 내보내기 문서를 참조하세요.

모든 옵션은 maigret --help를 실행하세요. 문서: CLI 옵션, 추가 예시. 403 오류나 시간 초과가 발생하나요? TROUBLESHOOTING.md를 참조하세요.

웹 인터페이스

Maigret에는 결과 그래프와 다운로드 가능한 보고서가 포함된 내장 웹 UI가 있습니다.

직접 실행하고 싶지 않나요? 게시된 soxoj/maigret:web Docker 이미지를 한 번의 클릭으로 호스팅 앱으로 배포하세요:

Render의 무료 티어에서 실행됩니다(15분 유휴 후 종료, 다음 요청 시 다시 시작). 인스턴스에 로그인이 설정되어 있지 않으므로 URL이 있는 사람은 누구나 사용할 수 있습니다.

웹 인터페이스 스크린샷

웹 인터페이스: 시작 방법

웹 인터페이스: 결과

maigret --web 5000

http://127.0.0.1:5000을 열고 사용자 이름을 입력한 후 결과를 확인하세요.

Python 라이브러리

Maigret은 자신의 Python 프로젝트에 내장할 수 있습니다. CLI는 직접 호출할 수 있는 비동기 함수의 얇은 래퍼입니다 — 사용자 지정 파이프라인을 구축하고, 결과를 자체 도구에 공급하거나, 더 큰 OSINT 워크플로우 내에서 실행할 수 있습니다.

작동 예시, 비동기 패턴, 태그별 사이트 필터링 방법은 전체 라이브러리 사용 가이드를 참조하세요.

유용한 CLI 플래그

--parse URL — 프로필 페이지를 파싱하고, ID/사용자 이름을 추출하여 재귀 검색을 시작하는 데 사용합니다.
--permute — 두 개 이상의 입력에서 가능한 사용자 이름 변형을 생성하고(예: john doe → johndoe, j.doe, …) 모두 검색합니다.
--self-check [--auto-disable] — 데이터베이스를 감사하는 관리자를 위해 라이브 사이트에서 usernameClaimed / usernameUnclaimed 쌍을 검증합니다.
--ai / --ai-model — 검색 결과에 대해 AI 분석을 실행하고 짧은 조사 요약을 터미널로 스트리밍합니다.

AI 분석

--ai는 검색 결과를 수집하고 내부 Markdown 보고서를 작성한 후 OpenAI 호환 채팅 완료 엔드포인트로 전송하여 짧고 중립적인 조사 요약(추정 실명, 위치, 직업, 관심사, 언어, 신뢰도, 후속 단서)을 생성합니다. 사이트별 진행 상황은 표시되지 않으며 모델의 출력은 stdout으로 스트리밍됩니다.

export OPENAI_API_KEY=sk-...
maigret user --ai

# 다른 모델 선택
maigret user --ai --ai-model gpt-4o-mini

키는 settings.json의 openai_api_key로도 설정할 수 있습니다. 엔드포인트는 기본적으로 https://api.openai.com/v1이지만, settings.json의 openai_api_base_url은 모든 OpenAI 호환 API(Azure OpenAI, OpenRouter, 로컬 서버 등)를 가리킬 수 있습니다. 전체 옵션 목록은 설정 문서를 참조하세요.

Tor / I2P / 프록시

Maigret은 프록시, Tor 또는 I2P를 통해 확인을 라우팅할 수 있습니다 — .onion / .i2p 사이트와 데이터센터 IP를 차단하는 WAF를 우회하는 데 유용합니다.

# 모든 HTTP/SOCKS 프록시
maigret user --proxy socks5://127.0.0.1:1080

# Tor (기본 게이트웨이 socks5://127.0.0.1:9050)
maigret user --tor-proxy socks5://127.0.0.1:9050

# I2P (기본 게이트웨이 http://127.0.0.1:4444)
maigret user --i2p-proxy http://127.0.0.1:4444

명령을 실행하기 전에 Tor / I2P 데몬을 시작하세요 — Maigret은 이러한 게이트웨이를 관리하지 않습니다.

Cloudflare 우회

실험적. Cloudflare 웹게이트는 활발히 개발 중입니다. 구성 스키마, CLI 동작, 라우팅되는 사이트 집합은 이전 버전과의 호환성 보장 없이 변경될 수 있습니다.

데이터베이스의 일부 사이트는 JavaScript 챌린지를 해결하기 위해 실제 브라우저가 필요합니다. Maigret은 이러한 확인을 로컬 FlareSolverr 인스턴스로 오프로드할 수 있습니다:

docker run -d -p 8191:8191 --name flaresolverr ghcr.io/flaresolverr/flaresolverr:latest
maigret --cloudflare-bypass <username>

우회는 선택 사항이며(--cloudflare-bypass 또는 settings.json의 cloudflare_bypass.enabled), protection 필드가 일치하는 사이트에 대해서만 작동합니다. 백엔드 옵션 및 구성은 기능 문서를 참조하세요.

기여

data.json에서 새 사이트를 정밀하게 추가하거나 수정하고(json.load/json.dump 사용 금지), ./utils/update_site_data.py를 실행하여 sites.md와 데이터베이스 메타데이터를 재생성한 후 풀 리퀘스트를 여세요. 자세한 내용은 CONTRIBUTING 가이드와 개발 문서를 참조하세요. 릴리스 기록: CHANGELOG.md.

상업적 사용

오픈소스 Maigret은 MIT 라이선스로 제한 없이 상업적 사용이 무료입니다 — 그러나 사이트 확인은 시간이 지나면서 깨지며 적극적인 유지 관리가 필요합니다.

심각한 상업적 사용 — 매일 업데이트되는 사이트 데이터베이스 또는 사용자 이름 확인 API — 의 경우 연락하세요: 📧 [email protected]

비공개 사이트 데이터베이스 — 5,000개 이상의 사이트, 매일 업데이트(공개 오픈소스 데이터베이스와 별개)
사용자 이름 확인 API — Maigret을 제품에 통합

정보

면책 조항

교육 및 합법적 목적으로만 사용하세요. 귀하의 관할권에서 적용되는 모든 법률(GDPR, CCPA 등)을 준수할 책임은 귀하에게 있습니다. 저자는 오용에 대해 책임을 지지 않습니다.

인기

maigret