GhostTrack — 터미널에서 쓰는 Python OSINT 도구

보안 공부나 CTF 하다 보면 IP 추적, 전화번호 정보 조회, SNS 유저네임 검색 같은 작업이 자주 필요하다. GhostTrack은 이런 작업을 하나의 CLI 메뉴로 묶은 Python OSINT 도구다.

GitHub: [HunxByts/GhostTrack](https://github.com/HunxByts/GhostTrack)

---

## 기능 요약

메뉴 방식으로 동작하며 4가지 기능을 제공한다.

| 번호 | 기능 | 설명 |
|------|------|------|
| 1 | IP Tracker | IP 주소로 위치·ISP·타임존 등 조회 |
| 2 | Show Your IP | 현재 사용 중인 공인 IP 확인 |
| 3 | Phone Number Tracker | 국제 전화번호 분석 (통신사·위치·형식) |
| 4 | Username Tracker | 소셜미디어 24곳에서 유저네임 존재 여부 확인 |

---

## 설치

```bash
# Linux (Debian 계열)
sudo apt-get install git python3
git clone https://github.com/HunxByts/GhostTrack.git
cd GhostTrack
pip3 install -r requirements.txt
python3 GhostTR.py
```

```bash
# Termux (Android)
pkg install git python3
git clone https://github.com/HunxByts/GhostTrack.git
cd GhostTrack
pip3 install -r requirements.txt
python3 GhostTR.py
```

의존성은 `phonenumbers` 하나다. requests는 기본 설치돼 있는 경우가 많다.

---

## IP Tracker

```
Enter IP target : 8.8.8.8

============= SHOW INFORMATION IP ADDRESS =============
IP target       : 8.8.8.8
Type IP         : IPv4
Country         : United States
City            : Mountain View
Latitude        : 37
Longitude       : -122
Maps            : https://www.google.com/maps/@37,-122,8z
ASN             : AS15169
ORG             : Google LLC
ISP             : Google LLC
```

내부적으로 [ipwho.is](https://ipwho.is/) API를 무료로 사용한다. 키 발급 없이 바로 쓸 수 있다.

---

## Phone Number Tracker

```
Enter phone number target [+6281xxxxxxxxx] : +821012345678

========== SHOW INFORMATION PHONE NUMBERS ==========
Location             : South Korea
Region Code          : KR
Timezone             : Asia/Seoul
Operator             : SK Telecom
Valid number         : True
International format : +82 10-1234-5678
Type                 : This is a mobile number
```

내부적으로 Python `phonenumbers` 라이브러리를 사용한다. 통신사 정보, 국가 코드, E.164 형식 변환 등을 한 번에 뽑아준다.

번호 포맷은 `+국가코드번호` 형식으로 넣어야 한다. 예: `+821012345678` (한국 010 번호).

---

## Username Tracker

```
Enter Username : devpc

========== SHOW INFORMATION USERNAME ==========
[ + ] Facebook : https://www.facebook.com/devpc
[ + ] Twitter : https://www.twitter.com/devpc
[ + ] Instagram : Username not found !
...
```

Facebook, Twitter, Instagram, LinkedIn, GitHub, TikTok, Telegram 등 24개 플랫폼을 순서대로 HTTP 요청해서 200 응답 여부로 존재를 판단한다.

다만 일부 플랫폼은 존재하지 않는 계정에도 200을 반환하기 때문에 오탐이 있다. 참고용으로 활용하자.

---

## 코드 구조

```
GhostTrack/
├── GhostTR.py        # 메인 스크립트 (단일 파일)
├── requirements.txt  # phonenumbers, requests
└── asset/            # 배너 이미지
```

단일 파일 구성이라 코드 이해하기 쉽다. `phonenumbers`, `requests`, `json` 조합으로 간단하게 구현돼 있다.

---

## 주의할 점

- **교육·연구 목적 전용**이다. 타인의 정보를 무단으로 수집하는 데 쓰면 법적 문제가 생길 수 있다.
- Username Tracker는 단순 HTTP 상태 코드 확인이라 정확도가 낮다.
- Windows에서는 실행은 되지만 색상 출력이 안 될 수 있다 (ANSI 코드 이슈). WSL이나 Git Bash를 권장한다.
- Termux에서 쓰기 편하게 만들어졌다.

GhostTrack — 터미널에서 쓰는 Python OSINT 도구

// COMMENTS

ON THIS PAGE