Metadata-Version: 2.4
Name: infradetective
Version: 0.1.5
Summary: Map the complete cloud footprint of any domain — provider fingerprinting, subdomain discovery, dangling CNAME detection, tech stack analysis, and visual infrastructure diagrams.
Project-URL: Homepage, https://github.com/Suriyakumarvijayanayagam/Infradetective-v1.0.0
Project-URL: Repository, https://github.com/Suriyakumarvijayanayagam/Infradetective-v1.0.0
Project-URL: Bug Tracker, https://github.com/Suriyakumarvijayanayagam/Infradetective-v1.0.0/issues
Project-URL: Documentation, https://github.com/Suriyakumarvijayanayagam/Infradetective-v1.0.0#readme
Author-email: Suriya kumarvijayanayagam <suriyakumar.vijayanayagam@gmail.com>
License: MIT
License-File: LICENSE
Keywords: cloud,devops,dns,fingerprinting,infrastructure,mermaid,security,subdomain,tech-stack,whois
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Security
Classifier: Topic :: System :: Networking
Requires-Python: >=3.11
Requires-Dist: beautifulsoup4>=4.12
Requires-Dist: dnspython>=2.6
Requires-Dist: httpx>=0.27
Requires-Dist: ipwhois>=1.3
Requires-Dist: lxml>=5.0
Requires-Dist: requests>=2.32
Requires-Dist: rich>=13.0
Requires-Dist: tldextract>=5.0
Requires-Dist: typer>=0.12
Requires-Dist: waybackpy>=3.0
Provides-Extra: all
Requires-Dist: faiss-cpu>=1.8; extra == 'all'
Requires-Dist: numpy>=1.26; extra == 'all'
Requires-Dist: redis>=5.0; extra == 'all'
Provides-Extra: cache
Requires-Dist: redis>=5.0; extra == 'cache'
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Provides-Extra: faiss
Requires-Dist: faiss-cpu>=1.8; extra == 'faiss'
Requires-Dist: numpy>=1.26; extra == 'faiss'
Description-Content-Type: text/markdown

# 🕵️‍♂️ InfraDetective

**InfraDetective** is a powerful infrastructure intelligence tool designed to map the cloud footprint, security posture, and tech stack of any domain or IP. It combines DNS analysis, fingerprinting, OSINT, and security auditing into a single, high-speed terminal dashboard.

[![PyPI version](https://img.shields.io/badge/pypi-v0.1.0-blue.svg)](https://pypi.org/project/infradetective/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

---

## 🚀 Key Features

### 🔍 Infrastructure Mapping
- **Provider Fingerprinting**: Detect hosting providers (AWS, Google, Hostinger, etc.) and CDN presence (Cloudflare, Akamai).
- **IP-to-ASN Matching**: Fast lookup of network ownership and geography.
- **Port Scanner**: Detect exposed services (SSH, Redis, MySQL, Postgres) with banner grabbing.

### 🛡️ Security & OSINT
- **Dangling CNAME Detection**: Find potential Subdomain Takeover vulnerabilities.
- **Phishing & Typosquatting**: Hunt for lookalike domains used for brand attacks.
- **Code Footprint (OSINT)**: Find GitHub repositories and leaked dev files (`/.env`, `composer.json`).

### ⚡ Intelligence & Scoring
- **Modernity Score**: Evaluates tech stack, security headers, and protocol versions.
- **GreenStack Score**: Estimates carbon intensity based on hosting provider.
- **AI-Ready Audit**: Checks if the site is optimized for AI agents and LLM scraping.

---

## 📦 Installation

```bash
pip install infradetective
```

*Note: For the caching layer, a running Redis instance is recommended but not required.*

---

## 🛠 Usage

### 1. Deep Domain Scan
Run a full investigation on any domain:
```bash
infradetective scan example.com
```

### 2. Hunting for Phishing Clones
Find lookalike domains used for phishing:
```bash
infradetective phish example.com
```

### 3. Code Footprint Analysis
Find source code links and exposed metadata:
```bash
infradetective osint example.com
```

### 4. Visual Infrastructure Map
Generate a Mermaid.js diagram of the infrastructure:
```bash
infradetective scan example.com --output mermaid
```

---

## 🏗 Architecture

InfraDetective is built with a modular "Detective" architecture:
- `core/`: Individual intelligence modules (DNS, Fingerprint, OSINT, etc.)
- `output/`: Presentation layers (Rich Terminal, Mermaid.js, JSON)
- `cache/`: Graceful Redis caching layer

---

## 📜 License
Distributed under the MIT License. See `LICENSE` for more information.

---

**Built with ❤️ for the DevOps & Security Community.**

🔗 **Source Code:** [https://github.com/Suriyakumarvijayanayagam/Infradetective-v1.0.0](https://github.com/Suriyakumarvijayanayagam/Infradetective-v1.0.0)
