🕷️ TGSpyder

TGSpyder는 Darksight Analytics의 오픈소스 텔레그램 OSINT CLI 도구입니다.

기능

• 공개 및 비공개 그룹의 멤버 목록을 CSV로 스크랩
• 공개 및 비공개 그룹의 채팅 메시지를 CSV로 스크랩
• 채팅 기록에서 t.me 초대 링크 추출 (공개 및 비공개 그룹)
• 사용자 이름 또는 (제한된) 숫자 ID로 텔레그램 사용자 조회
• 스티커 팩 생성자 ID 식별 (스티커 세트 ID를 통해 추론) 출처: https://hackernoon.com/whats-wrong-with-stickers-in-telegram-deanonymize-anonymous-channels-in-two-clicks
• 프록시 지원:
  • 프록시 저장 (--set-proxy)
  • 프록시 제거 (--remove-proxy)
  • 일회성 프록시 재정의 (--proxy)

요구 사항

• Python 3.10+

설치

git clone https://github.com/Darksight-Analytics/tgspyder.git
cd tgspyder
pip install -r requirements.txt
pip install -e .

🕷️ 소개

텔레그램 OSINT CLI 도구 수사관, 분석가, 저널리스트, 연구자를 위해 제작되었습니다.

TGSpyder는 텔레그램 데이터의 구조화된 수집 및 분석을 위한 커맨드라인 OSINT 도구입니다. 공개 및 비공개 텔레그램 그룹과 채널에서 멤버, 메시지, 초대 링크, 사용자 및 메타데이터를 스크랩하고, 모든 것을 수사에 적합한 CSV 파일로 내보냅니다.

기능

• 📋 멤버 목록 스크랩 (텔레그램이 허용하는 경우)
• 💬 채팅 메시지 크롤링
• 🔗 텔레그램 초대 링크 추출 및 중복 제거
• 🧍 ID 또는 사용자 이름으로 사용자 조회
• 🎭 스티커 팩 생성자 식별
• 🌐 SOCKS 프록시 지원(Tor / VPN)
• 📁 OSINT 워크플로우를 위한 깔끔한 CSV 출력
• 📦 출력 구조

TGSpyder Output/
├── members/
│   └── members_<target>_<timestamp>.csv
├── chats/
│   └── messages_<target>_<timestamp>.csv
└── crawled_links/
    └── crawled_links_<target>_<timestamp>.csv

🚀 빠른 시작

1️⃣ 저장소 클론

git clone https://github.com/Darksight-Analytics/tgspyder.git
cd tgspyder

2️⃣ 가상 환경 생성 및 활성화

python3 -m venv venv
source venv/bin/activate

3️⃣ 의존성 설치

pip install -r requirements.txt

4️⃣ TGSpyder를 CLI로 설치

pip install -e .

설치 확인:

tgspyder --help

🔑 텔레그램 API 자격 증명

• **https://my.telegram.org**로 이동하여 텔레그램 계정으로 로그인하세요.
• API 개발 도구로 이동하여 TGSpyder가 텔레그램에 인증하는 데 필요한 API ID와 API Hash를 생성하세요.

🧭 기본 사용법

멤버 및 채팅 스크랩

tgspyder https://t.me/examplegroup --members --chats

초대 링크만 추출

tgspyder https://t.me/examplegroup --crawl-invites

사용자 조회

tgspyder --user 123456789
tgspyder --user @username

스티커 팩 생성자 조회

tgspyder --sticker-pack https://t.me/addstickers/packname

🌐 프록시 지원

TGSpyder는 SOCKS 프록시(Tor / VPN 친화적)를 지원합니다.

일회성 프록시

tgspyder --proxy socks5://127.0.0.1:9050 <target> --chats

향후 실행을 위해 프록시 저장

tgspyder --set-proxy socks5://127.0.0.1:9050

저장된 프록시 제거

tgspyder --remove-proxy

🔐 인증 및 구성

첫 실행 시 TGSpyder는 다음을 입력하라는 메시지를 표시합니다.

• 텔레그램 API ID
• 텔레그램 API Hash
• 사용자 계정 또는 봇 토큰

자격 증명은 로컬에 저장됩니다: ~/.tgspyder.conf

세션 파일은 자동으로 재사용됩니다.

⚠️ 제한 사항

• 일부 그룹은 멤버 목록을 노출하지 않음
• 비공개 그룹은 유효한 초대 링크가 필요함
• 스티커 생성자 귀속이 항상 보장되지는 않음
• 텔레그램 API 제한의 적용을 받음

🧪 윤리적 사용 및 OSINT 고지

TGSpyder는 다음을 위해 제작되었습니다:

• OSINT 조사
• 학술 연구
• 저널리즘
• 위협 및 네트워크 분석

사용자는 다음 사항을 준수할 책임이 있습니다:

• 현지 법률
• 플랫폼 서비스 약관
• 윤리적 연구 기준

📄 라이선스

MIT 라이선스 자세한 내용은 LICENSE를 참조하세요.

🚀 데모

👤 작성자

• Valdemar Balle
• Darksight Analytics 설립자

⚖️ 고지 사항

TGSpyder는 오픈소스 인텔리전스(OSINT), 연구, 조사 및 교육 목적으로만 제공됩니다.

사용자는 이 도구의 사용이 다음 사항을 준수하는지 확인할 책임이 전적으로 있습니다:

• 적용 가능한 법률 및 규정
• 플랫폼 서비스 약관
• 윤리적 연구 및 조사 기준

작성자와 기여자는 이 도구의 오용 또는 사용으로 인해 발생하는 모든 결과에 대해 책임을 지지 않습니다.