Skip to content

Latest commit

 

History

History
156 lines (121 loc) · 6.32 KB

File metadata and controls

156 lines (121 loc) · 6.32 KB

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

🔗 Links

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