Advanced information gathering & OSINT tool for phone numbers.
Go to file
Raphael Cerveaux d6abe580ff
[Docs] The project
2018-11-08 12:04:29 +01:00
data Data 2018-11-05 23:47:43 +01:00
tests Tests 2018-11-05 23:47:43 +01:00
.gitignore Ignore .idea 2018-11-04 21:30:06 +01:00
README.md [Docs] The project 2018-11-08 12:04:29 +01:00
phoneinfoga.py numverify scan 2018-11-05 23:47:43 +01:00
requirements.txt Requirements 2018-11-05 16:28:03 +01:00
secrets.py Secrets 2018-11-04 21:30:28 +01:00

README.md

PhoneInfoga

Advanced information gathering tool & OSINT reconnaissance for phone numbers.

The project

Building the most advanced tool to scan phone numbers using only free resources. The goal is to first identify basic informations such as country, area, carrier and line type on any international phone numbers with a very good accuracy, and then detect the VoIP provider or search for footprints on search engines to try identify the owner.

This tool requires python 2.x

Features

  • Check if phone number exists
  • Gather standard informations such as country, line type and carrier
  • Check several numbers at once
  • Set an output for result(s)
  • Check if number is from a VoIP provider
  • OSINT reconnaissance using external APIs, Google Hacking, phone books & search engines

Formats

The tool only accepts E164 and International formats as input.

  • E164: +3396360XXXX
  • International: +33 9 63 60 XX XX
  • National: 09 63 60 XX XX
  • RFC3966: tel:+33-9-63-60-XX-XX
  • Out-of-country format from US: 011 33 9 63 60 XX XX

Available scanners

Use any to disable this feature. Default value: all

  • numverify
  • ovh

Installation

git clone https://github.com/sundowndev/PhoneInfoga
cd ./PhoneInfoga
pip install -r requirements.txt
python ./phoneinfoga.py -h

Usage

usage: phoneinfoga.py -n <number> [options]

Advanced information gathering tool for phone numbers
(https://github.com/sundowndev/PhoneInfoga)

optional arguments:
  -h, --help            show this help message and exit
  -n number, --number number
                        The phone number to scan (E164 or International
                        format)
  -i input_file, --input input_file
                        Phone number list to scan (one per line)
  -o output_file, --output output_file
                        Output to save scan results
  -s scanner, --scanner scanner (any to skip, default: all)
                        The scanner to use
  --osint               Use OSINT reconnaissance
  -u, --update          Update the tool & databases

Example :

python phoneinfoga.py -n +42837544833

Check several numbers at once :

python ./phoneinfoga.py -i numbers.txt -o results.txt

Check for a number range on OVH (just put some zeros) :

python phoneinfoga.py -n +42837544833 -s ovh

Formatting

E.164 formatting for phone numbers entails the following:

  • A + (plus) sign
  • International Country Calling code
  • Local Area code
  • Local Phone number

For example, heres a US-based number in standard local formatting: (415) 555-2671

Heres the same phone number in E.164 formatting: +14155552671

In the UK, and many other countries internationally, local dialing may require the addition of a '0' in front of the subscriber number. With E.164 formatting, this '0' must usually be removed.

For example, heres a UK-based number in standard local formatting: 020 7183 8750

Heres the same phone number in E.164 formatting: +442071838750

License

This tool is MIT licensed.

Resources

Regular expression : ^[+]*[(]{0,1}[0-9]{1,4}[)]{0,1}[-\s\./0-9]*$

Docs

open data

Scanners

OSINT

Google dork requests

  • insubject:"+XXXXXXXXX" | insubject:"+XXXXX" | insubject:"XXXXX XXX XXX
  • insubject:"{number}" | intitle:"{number}"
  • intext:"{number}" ext:doc | ext:docx | ext:odt | ext:pdf | ext:rtf | ext:sxw | ext:psw | ext:ppt | ext:pptx | ext:pps | ext:csv | ext:txt | ext:html