OSLookup

IP & phone number OSINT lookup tool. Command line interface with modular lookup classes.

Features

• IP geolocation, ASN, org lookup via IPinfo API

• Phone carrier, location, formatting, validation

• Mutually exclusive phone/IP CLI modes

• Token support for full IPinfo data

• Clean JSON output

git clone https://github.com/spacewaffle42/OSLookup.git
cd OSLookup
python3 -m venv venv
source venv/bin/activate  # linux/mac
# venv\Scripts\activate  # windows
pip install -r requirements.txt

IP lookup (free tier)

python main.py -i 8.8.8.8

IP lookup (full data):

python main.py -i 8.8.8.8 -a YOUR_IPINFO_access_TOKEN

Example output:

{
  'ip': '8.8.8.8',
  'hostname': 'dns.google',
  'city': 'Mountain View',
  'region': 'California',
  'country': 'US',
  'loc': '37.4056,-122.0775',
  'org': 'AS15169 Google LLC',
  'postal': '94043',
  'timezone': 'America/Los_Angeles',
  'anycast': True,
  'country_name': 'United States',
  'isEU': False,
  'country_flag_url': 'https://cdn.ipinfo.io/static/images/countries-flags/US.svg',
  'country_flag':
  {
    'emoji': '🇺🇸',
    'unicode': 'U+1F1FA U+1F1F8'
  },
    'country_currency': {'code': 'USD', 'symbol': '$'},
    'continent': {'code': 'NA', 'name': 'North America'},
    'latitude': '37.4056',
    'longitude': '-122.0775'
}

Phone lookup:

python main.py -p "PHONENUMBER"

Example output:

{
  'Phone Number':
    PhoneNumber(country_code=44, national_number=72123*****,extension=None, italian_leading_zero=None, number_of_leading_zeros=None, country_code_source=0, preferred_domestic_carrier_code=None),
    'Details':
      {
        'is_valid': True,
        'is_possible': True,
        'national_format': '07212 3*****',
        'international_format': '+44 7212 3*****',
        'carrier': '',
        'geo_location': 'United Kingdom',
        'time_zones': ('Europe/Guernsey','Europe/Isle_of_Man', 'Europe/Jersey', 'Europe/London')
      }
}