Python MIT

SearchPhone

Phone number OSINT toolkit with multi-API search (Google, GitHub, Numverify, Reddit, DuckDuckGo), Hudson Rock infostealer intelligence, and automatic report generation.

H

HackUnderway

Dernière activité 24 août 2026
HackUnderway/SearchPhone

2 k

étoiles

272

forks

1

issues ouvertes

api-scrapingcybersecuritygithub-searchhackunderwayhudsonrockinfosecosintosint-toolphone-numberphoneosintpythonsearchphone

Ce README est souvent en anglais.

SearchPhone 🕵🏽‍♂️

Is a comprehensive OSINT tool for looking up linked phone number information, using multiple APIs to gather information from various sources. Developed for use with Python from the terminal. 👁

SearchPhone

Python version License

✨ Features

  • 📱 Phone Number Validation - Validates and formats phone numbers using phonenumbers library
  • 🔍 Multiple Search Engines - Searches Google (via SerpAPI) and DuckDuckGo
  • 💻 Code Repository Search - Finds phone numbers in GitHub code
  • 📝 Social Media Search - Searches Reddit for mentions
  • 📊 Carrier Information - Gets operator and location data via Numverify API
  • 🛡️ Infostealer Intelligence - Checks if a phone number has been compromised by info-stealer malware via Hudson Rock Cavalier API (free, no API key required)
  • 📄 Automatic Reports - Generates JSON and PDF reports automatically
  • 🚀 Parallel Processing - Searches multiple sources simultaneously for speed
  • 🎨 Colorful Output - Easy to read terminal output with colors

🔑 API Keys Required

Get your API keys from the following services:

Service Purpose Link Plan Key
Numverify Phone number validation & carrier info numverify.com Free (100 requests/month) 🔑 (Necessary)
SerpAPI Google Search results serpapi.com Free (250 searches/month) 🔑 (Necessary)
GitHub Token GitHub code search GitHub Settings Free (5000 requests/hour) 🔑 (Necessary)
Hudson Rock Infostealer intelligence cavalier.hudsonrock.com Free (No API key required) ❌ No key needed

Configure your API keys:

The project includes an example.env file with the required variables. Follow these steps:

Step 1: Copy the example file
cp example.env .env
Step 2: Edit the .env file
nano .env

or

vim .env

or

code .env
Step 3: Add your API keys

Replace the placeholder values with your actual API keys:

# Required APIs
NUMVERIFY_KEY=your_numverify_api_key_here
SERPAPI_KEY=your_serpapi_key_here
GITHUB_TOKEN=your_github_token_here

Example

SearchPhone

SearchPhone

The project is open to partners.

SUPPORTED DISTRIBUTIONS

Distribution Verified version Supported Status
Kali Linux 2026.2 ✅ Working
Parrot Security OS 6.3 ✅ Working
Windows 11 ✅ Working
BackBox 9 ✅ Working
Arch Linux 2024.12.01 ✅ Working

USAGE

git clone https://github.com/HackUnderway/SearchPhone.git
cd SearchPhone
python3 search_phone.py

REQUIREMENTS

pip install -r requirements.txt

SUPPORT

Questions, bugs or suggestions to : info@hackunderway.com

LICENSE

  • SearchPhone is licensed.
  • See LICENSE for more information.

👨‍💻 Author


🕵️‍♂️ OSINT Platform

OSINT Platform

Automate OSINT processes
New Enterprise Mode – Maltego-inspired interface with visual graphs and professional workflows.
📢 See what's new

Patreon Web site Facebook YouTube Twitter/X Instagram TryHackMe

☕️ Support the project

If you like this tool, consider buying me a coffee:

Buy Me a Coffee

🌞 Subscriptions

Subscribe to: Jey Zeta

Kali Linux

from made in with by: Victor Bancayan

© 2026

Projets similaires

Information gathering framework for phone numbers

Goagregationfootprintinformation-gathering
Ssundowndev
18 k étoiles6 k

An OSINT tool for gathering information about phone numbers

Python
Sspider863644
884 étoiles112

List of API's for gathering information about phone numbers, addresses, domains etc

apiapi-restawesome
Ccipher387
2,6 k étoiles323