https://github.com/ef1500/phonebrute
Generate Valid Phone Numbers With The NPA-NXX Database
https://github.com/ef1500/phonebrute
osint osint-python osint-tool phone-number
Last synced: 3 months ago
JSON representation
Generate Valid Phone Numbers With The NPA-NXX Database
- Host: GitHub
- URL: https://github.com/ef1500/phonebrute
- Owner: ef1500
- Created: 2023-01-12T22:08:00.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2023-05-13T21:01:19.000Z (over 2 years ago)
- Last Synced: 2024-07-30T19:47:36.644Z (over 1 year ago)
- Topics: osint, osint-python, osint-tool, phone-number
- Language: Python
- Homepage:
- Size: 28.3 KB
- Stars: 12
- Watchers: 1
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
# Phonebrute
After Martin Virgo's [Phonerator](https://www.martinvigo.com/tools/phonerator) went down, I decided to write my own implementation.
This tool generates valid phone numbers using the NPA-NXX Databases from the US Government. Therefore, this tool will only work with US Numbers only.
## Usage & Installation
To get started, simply clone the repository and run
`pip install -r requirements.txt`
After that finishes, go ahead and run
`python phonebrute.py -h` to show all of the options.
```
>python phonebrute.py -h
usage: Phonebrute [-h] [-nP] [-iC] [-rC RATECENTER] [-c CARRIER] [-o OUTPUT] NUM
Generate valid phone numbers with NPA-NXX databases
positional arguments:
NUM Phone number to search for in the database
optional arguments:
-h, --help show this help message and exit
-nP, --noprint Don't print the results in a table
-iC, --include_contaminated
Include Contaminated Entries
-rC RATECENTER, --ratecenter RATECENTER
Search For a certain rate center
-c CARRIER, --carrier CARRIER
Search for a certain carrier
-s STATE, --state STATE
Search for numbers from a specific state by their abbreviation
-o OUTPUT, --output OUTPUT
Output file, csv or json, defaults to json
```
Example:
## Features
- Filter by Rate Center (use the -rC option)
- Filter by Carrier (use the -c option)
- Filter by State (use the -s option)
- Output to a csv or json file (use the -o option)
- Include contaminated Entries (use the -iC option)
- Don't print to the terminal (use the -nP option)