Skip to content

Latest commit

 

History

History
97 lines (74 loc) · 2.61 KB

README.md

File metadata and controls

97 lines (74 loc) · 2.61 KB
Raw

IPGeoLocation

A tool to retrieve IP Geolocation information

Powered by ip-api

Requirements

Python 3.x

Features

  • Define your own custom User Agent string.
  • Proxy support.
  • Get Geolocation for domain/hostname.
  • Pick a random User Agent string from a list in file (Every User Agent string in new line).
  • Call program with no arguments to get your ip geolocation.
  • Open IP geolocation in google maps using the default browser.
  • Export results to csv, xml and txt format.

Geolocation Information

  • ASN
  • City
  • Country
  • Country Code
  • ISP
  • Latitude
  • Longtitude
  • Organization
  • Region Code
  • Region Name
  • Timezone
  • Zip Code

Usage

$ ./ip2geolocation.py -h 
usage: ip2geolocation.py [-h] [-t Host] [-u User-Agent] [-r]
                         [-l User-Agent list] [-x Proxy] [-g] [--csv file]
                         [--xml file] [-e file]

IPGeoLocation 1.4
A tool to retrieve IP Geolocation information.
Powered by http://ip-api.com


optional arguments:
  -h, --help            show this help message and exit
  -t Host, --target Host
                        The IP Address or Domain to be analyzed.
  -u User-Agent, --useragent User-Agent
                        Set the User-Agent request header (default: IP2GeoLocation 1.4).
  -r                    Pick User Agent strings randomly.
  -l User-Agent list    A User-Agent list file. Each User-Agent string should be in a new line.
  -x Proxy, --proxy Proxy
                        Setup proxy server (example: http://127.0.0.1:8080).
  -g                    Open IP location in Google maps with default browser.
  --csv file            File to export results in CSV format.
  --xml file            File to export results in XML format.
  -e file, --txt file   File to export results.

Examples

Get your IP Geolocation

  • ./ip2geolocation.py

Get IP Geolocation

  • ./ip2geolocation.py -t x.x.x.x

Custom User Agent string

  • ./ip2geolocation.py -t x.x.x.x -u "Mozilla/5.0 (Windows NT 6.3; WOW64; Trident/7.0; rv:11.0) like Gecko"

Using Proxy

Pick User Agent string randomly

  • ./ip2geolocation.py -t x.x.x.x -l /path/to/user/agent/strings/filename.txt -r

Retrieve IP geolocation and open location in Google maps with default browser

  • ./ip2geolocation.py -t x.x.x.x -g

Export results to CSV file

  • ./ip2geolocation.py -t x.x.x.x --csv /path/to/file.csv

Export results to XML file

  • ./ip2geolocation.py -t x.x.x.x --xml /path/to/file.xml

Export results to TXT file

  • ./ip2geolocation.py -t x.x.x.x -e /path/to/file.txt