Skip to content

A comprehensive IP address analysis tool that provides detailed information about any IP address, including geolocation, DNS records, WHOIS information, and security checks.

License

Notifications You must be signed in to change notification settings

Hamed233/Advanced-IP-Analyzer-Tool

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Advanced IP Analyzer Tool 🔍

A powerful, asynchronous IP analysis tool that provides comprehensive information about IP addresses, including geolocation, DNS records, WHOIS data, and security intelligence from multiple sources.

Python Version License Author

Features 🚀

  • 📍 Geolocation Analysis: Country, city, region, timezone, and coordinates
  • 🔍 DNS Record Retrieval: A, AAAA, MX, NS, TXT, PTR, and SOA records
  • 📋 WHOIS Information: Registration details, nameservers, and organization info
  • 🛡️ Security Checks: Integration with AbuseIPDB, VirusTotal, and Shodan
  • 📊 Rich Console Output: Beautiful, formatted console display
  • 📑 Multiple Export Formats: JSON, CSV, and HTML reports
  • Asynchronous Operations: Fast, concurrent data gathering
  • 🎯 Detailed Reporting: Comprehensive analysis with visualizations

Installation 📦

  1. Clone the repository:
git clone https://github.com/Hamed233/Advanced-IP-Analyzer-Tool.git
cd Advanced-IP-Analyzer-Tool
  1. Install required packages:
pip install -r requirements.txt
  1. Create a .env file from the template:
cp .env.example .env
  1. Add your API keys to the .env file:
ABUSEIPDB_API_KEY=your_key_here
VIRUSTOTAL_API_KEY=your_key_here
SHODAN_API_KEY=your_key_here

Usage 💻

Basic Usage

python ip_analyzer.py 8.8.8.8

With Verbose Output and HTML Report

python ip_analyzer.py 8.8.8.8 -v -r -e html

Command Line Options

  • -v, --verbose: Enable verbose output
  • -r, --report: Generate detailed report
  • -e, --export {json,csv,html}: Export results in specified format

Example Output 📝

Here's an example analysis of an IP address:

IP Analysis Report
==================================================

Basic Information
┏━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ Property  ┃ Value                          ┃
┡━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ IP        │ 197.46.103.160                 │
│ Hostname  │ host-197.46.103.160.tedata.net │
│ Timestamp │ 2024-12-04 22:54:19            │
└───────────┴────────────────────────────────┘

Geolocation Information
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━┓
┃ Property     ┃ Value             ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━┩
│ Country      │ Egypt             │
│ City         │ Cairo             │
│ Region       │ Cairo Governorate │
│ ISP          │ TE Data           │
│ Timezone     │ Africa/Cairo      │
│ Coordinates  │ 30.0588, 31.2268  │
│ Organization │ TE-AS             │
│ AS           │ AS8452            │
└──────────────┴───────────────────┘

WHOIS Information
┏━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ Property        ┃ Value                                ┃
┡━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ Registrar       │ GoDaddy.com, LLC                     │
│ Name Servers    │ ['NS1.TEDATA.NET', 'NS2.TEDATA.NET'] │
│ Organization    │ Domains By Proxy, LLC                │
│ Emails          │ abuse@godaddy.com                    │
└─────────────────┴──────────────────────────────────────┘

Dependencies 📚

Core dependencies:

  • requests: HTTP requests
  • python-whois: WHOIS lookups
  • dnspython: DNS queries
  • aiohttp: Async HTTP
  • rich: Console formatting
  • See requirements.txt for full list

API Keys 🔑

For full functionality, obtain API keys from:

Contributing 🤝

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Author 👨‍💻

Hamed Esam

License 📄

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments 🙏

  • Thanks to all the API providers
  • Community contributors and feedback
  • Python async community

About

A comprehensive IP address analysis tool that provides detailed information about any IP address, including geolocation, DNS records, WHOIS information, and security checks.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages