1.0.0 • Published 4 years ago
@mediacomem/ipgeolocation v1.0.0
ipgeolocation
Get the geolocation of IP addresses in a CSV file using https://ipgeolocation.io.
This tool expects a CSV file with IP addresses in the first column and a one-line header, for example:
IP Address,Whatever
100.101.102.103,foo
104.105.106.107,bar
200.201.202.203,baz
It will output a CSV file with geolocation data about each IP address. This is a simplified example of the output:
ip,type,result,country_code2,country_name,state_prov,city,...
100.101.102.103,ipv4,success,US,United States,New York,Syracuse,...
The description of all returned geolocation data can be found here: https://ipgeolocation.io/documentation/ip-geolocation-api.html
Requirements
- Node.js 12+
Installation
npm install --global @mediacomem/ipgeolocation
Or with npx:
npx @mediacomem/ipgeolocation --help
Usage
ipgeolocation [options...]
Options:
--version Show version number [boolean]
--apiKey, -k, --api-key Provide your ipgeolocation API key[string] [required]
--apiUrl, -u, --api-url Change the default ipgeolocation API URL
[string] [default: "https://api.ipgeolocation.io/ipgeo"]
--input, -i CSV input file (- for standard input)
[string] [default: "-"]
--output, -o CSV output file (standard output if not specified)
[string]
--help Show help [boolean]
Examples
Geolocate IP addresses in a CSV file and save the results to another file:
ipgeolocation -i input.csv -o output.csv --api-key CHANGEME
Geolocate IP adresses in CSV from standard input and print the results to standard output:
cat input.csv | ipgeolocation --api-key CHANGEME > output.csv
1.0.0
4 years ago