📞 Phone Number Information Tool

Welcome to the Phone Number Information Tool! This Python script allows you to validate, locate, and identify the carrier of phone numbers from around the world. Whether you need to check a single number or process multiple numbers at once, this tool has you covered! 🌍

🚀 Features

• Validate Phone Numbers: Check if a phone number is valid.
• Location: Retrieve the geographical location of the phone number (Country).
• Identify Carrier: Find out the carrier associated with the phone number.
• Determine NumberType: Classify the phone number as mobile, fixed line, toll-free, etc.
• Messenger OSINT: Generate direct chat links for WhatsApp, Telegram, Viber, and Skype.
• Terminal QR Codes: Generate an ASCII QR code with --qr for instant phone scanning.
• Granular Location: Offline mapping of US States and Indian Telecom Circles (e.g., "Mumbai", "California").
• Messy Text Scraper: Extract phone numbers from any messy text file (emails, logs, HTML) using --scrape.
• vCard Export: Generate a .vcf contact file to import OSINT data directly into your phone.
• Advanced Risk Analysis: Enhanced heuristics including entropy, palindromes, repetitive digits, and vanity patterns.
• Bulk Scan Summary: Get a statistical overview (Top carriers, validity rate) for large list scans.
• Expanded OSINT Dorks: Create search engine dorks for TrueCaller, Sync.me, WhitePages, and more.
• Map Visualization: Generate an HTML map to visualize the location of the phone numbers.
• Update Tool: Easily update to the latest version from the repository.

📦 Installation & Setup

To ensure a clean environment, it is recommended to use a virtual environment (venv).

1. Clone the Repository

git clone https://github.com/0warn/NUM-Info.git
cd NUM-Info

2. Create and Activate Virtual Environment

On Linux/macOS:

python3 -m venv venv
source venv/bin/activate

On Windows:

python -m venv venv
venv\Scripts\activate

3. Install Dependencies

pip install -r requirements.txt
pip install .

🛠️ Usage

Once the environment is activated, you can run the tool:

num-info -s "+14155552671" --qr

If you are not using the installed entry point, use:

python3 num_info.py -s "+14155552671" --qr

Scan a Single Phone Number

num-info -s "+1234567890" -r "US"

Scan Multiple Phone Numbers

num-info -n "+1234567890,+1987654321" -r "US"

Interactive mode

num-info --interactive --region india

Output of interactive mode

num-info --interactive --region india

[+] Interactive mode. Type a number, 'help' for options, 'quit' to exit.

 [num-info]> help
Commands:
  <number>    analyze one
  n1,n2,...   analyze multiple
  export      save last results.json
  quit/exit   leave

 [num-info]> 

📖 Arguments

• -s, --single: Scan a single phone number.
• -n, --multiple: Scan multiple phone numbers separated by commas.
• --region: Specify the region code (e.g., "US" for the United States).
• --json: This help to give you the json format result
• -f, --file: This only save a file of the scanned result
• --interactive: This is for interactive mode (Simple and powerfull)
• --open-dorks: Open the generated dork links in your web browser.
• --map: Generate an HTML map report to the specified path.

📝 Example Output

When you run the tool, you will see output similar to the following:

Phone Number: +1234567890
Location: United States
Carrier: Verizon Wireless
Phone number type: Mobile
----------------------------------------

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Thank you for using the Phone Number Information Tool! Happy Information gathering! 🎉