Skip to content

Ninja-Yubaraj/FireFly-v2

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

2 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ”₯ FireFly v2- Phone Number Intelligence Lookup

Python License Platform Status

FireFly v2 is a lightweight and elegant phone number intelligence tool that leverages the NumVerify API to extract detailed information such as location, carrier, line type, and more! ⚑


✨ Features

  • πŸ” Get detailed phone number info:
    • Country & Country Code
    • Location
    • Carrier (Network Provider)
    • Line Type (Mobile/Landline/etc.)
  • βœ… Easy to Use CLI
  • 🧩 API-based Lookup
  • πŸ’‘ Educational & Research Purposes
  • πŸ“¦ Lightweight and Fast

πŸ› οΈ Setup Instructions

1. πŸ”‘ Get an API Key

  • Visit NumVerify.com
  • Sign up for a free account
  • Copy your API key

2. 🧩 Add Your API Key

Create a file named config.json in the root directory and paste your API key like this:

{
  "api_key": "your_api_key_here"
}

3. πŸ“¦ Install Dependencies

pip install -r requirements.txt

4. πŸš€ Run FireFly v2

python3 FireFly-v2.py <phone_number>

Example:

python3 FireFly-v2.py +13213707446

πŸ“ Example Output

[+] Phone number information gathering
 - Getting Country         [ OK ]
 - Getting Country Name    [ OK ]
 - Getting Location        [ OK ]
 - Getting Carrier         [ OK ]
 - Getting Device          [ OK ]

[+] Information Output
 - Phone Number: +13213707446
 - Country: US
 - Country Name: United States
 - Location: New York
 - Carrier: AT&T
 - Device: mobile

πŸ“‚ File Structure

FireFly-v2/
β”‚
β”œβ”€β”€ FireFly-v2.py          # Main script
β”œβ”€β”€ config.json         # Contains your API key
β”œβ”€β”€ requirements.txt    # Python dependencies
└── README.md           # This file

⚠️ Disclaimer

This tool is for educational and research purposes only.
I am not responsible for any misuse or damage caused by this tool.


πŸ‘¨β€πŸ’» Author


⭐ Support & Contributions

If you find this project useful, give it a ⭐ on GitHub!
Pull requests and suggestions are always welcome.

Contributors

Languages