https://github.com/shazeus/ipgeo-cli
IP geolocation and intelligence tool — geolocate IPs, bulk lookup, reverse DNS, CIDR calc, VPN detection.
https://github.com/shazeus/ipgeo-cli
cidr cli geoip geolocation ip-address networking python reverse-dns terminal-tool vpn-detection
Last synced: 6 days ago
JSON representation
IP geolocation and intelligence tool — geolocate IPs, bulk lookup, reverse DNS, CIDR calc, VPN detection.
- Host: GitHub
- URL: https://github.com/shazeus/ipgeo-cli
- Owner: shazeus
- License: mit
- Created: 2026-05-20T06:10:52.000Z (26 days ago)
- Default Branch: master
- Last Pushed: 2026-05-20T06:14:01.000Z (26 days ago)
- Last Synced: 2026-05-20T09:54:34.435Z (26 days ago)
- Topics: cidr, cli, geoip, geolocation, ip-address, networking, python, reverse-dns, terminal-tool, vpn-detection
- Language: Python
- Size: 8.79 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
ipgeo
IP geolocation and intelligence tool for the terminal.
---
**ipgeo** is a fast, feature-rich CLI for IP geolocation and network intelligence. Geolocate single IPs or hostnames, run bulk lookups from a file, perform reverse DNS, calculate CIDR networks, check VPN/proxy reputation, and validate IP addresses — all with beautiful rich-powered terminal output.
- **Geolocation** — Country, region, city, coordinates, timezone, ISP, ASN from any IP or hostname
- **Bulk Lookup** — Process hundreds of IPs from a file with progress tracking; export to JSON or CSV
- **Reverse DNS** — PTR record lookups for one or many IPs in a single command
- **CIDR Calculator** — Network address, broadcast, netmask, usable hosts, first/last host
- **IP Range to CIDR** — Summarize any arbitrary IP range into minimal CIDR blocks
- **Reputation Check** — Proxy/VPN/hosting detection and risk scoring
- **IP Validation** — Classify IPs as private/public/loopback/multicast, IPv4 vs IPv6
- **Your IP** — Instantly see your own public IP and geolocation
## Installation
```bash
pip install ipgeo-cli
```
## Usage
```bash
# Look up any IP or hostname
ipgeo lookup 8.8.8.8
ipgeo lookup github.com
# Show your own public IP
ipgeo myip
# Bulk lookup from a file
ipgeo bulk ips.txt
ipgeo bulk ips.txt --csv > results.csv
ipgeo bulk ips.txt --json > results.json
# Reverse DNS
ipgeo rdns 8.8.8.8 1.1.1.1
# CIDR network info
ipgeo cidr 192.168.1.0/24
ipgeo cidr 10.0.0.0/8
# IP range to CIDR blocks
ipgeo range 10.0.0.1 10.0.0.100
# Reputation / VPN / proxy check
ipgeo rep 1.2.3.4
# Validate IP addresses
ipgeo validate 192.168.1.1 ::1 256.0.0.1
```
## Commands
| Command | Description |
|---------|-------------|
| `lookup ` | Geolocate a single IP address or hostname |
| `myip` | Show your public IP and geolocation |
| `bulk ` | Bulk geolocate IPs from a text file (one per line) |
| `rdns …` | Reverse DNS (PTR) lookup for one or more IPs |
| `cidr ` | Network details for a CIDR block |
| `range ` | Summarize an IP range into CIDR blocks |
| `rep ` | Reputation check — proxy/VPN/hosting/risk level |
| `validate …` | Validate and classify IP addresses |
All commands support `--json` for machine-readable output.
## Configuration
No API key required. ipgeo uses the free [ip-api.com](http://ip-api.com) service.
For bulk lookups, requests are automatically batched (100 per request) to stay within rate limits.
## License
MIT © [shazeus](https://github.com/shazeus)