Skip to main content

ReClaimor

Advanced subdomain takeover scanner with 20+ provider fingerprints

PyPI version Python License

ReClaimor is a fast, accurate subdomain takeover detection tool with multi-tier analysis (DNS → HTTP → TLS → Fingerprinting) and support for 20+ cloud providers.

Only scan domains you own or have explicit authorization to test. Unauthorized scanning is illegal.

🚀 Quick Start

# Install
pip install reclaimor

# Scan single domain
reclaimor --url subdomain.example.com

# Scan from file
reclaimor --file targets.txt --output results.json

# Generate HTML report
reclaimor --file targets.txt --output report.html --format html

✨ Key Features

  • Multi-tier Detection - DNS, HTTP, TLS, and fingerprint analysis
  • 20+ Providers - GitHub Pages, Heroku, AWS S3, Azure, Netlify, Vercel, Fastly, and more
  • Fast Async Scanning - Concurrent scanning with rate limiting
  • Multiple Formats - JSON, CSV, HTML, and console output
  • Interactive TUI - Manual triage interface
  • Safe by Default - Detection-only mode (optional verification with explicit flags)

📋 Requirements

  • Python 3.10+
  • Internet connection

🔧 Basic Usage

# Verify installation
reclaimor --version
reclaimor --self-check

# Single domain
reclaimor --url subdomain.example.com

# Batch scanning
reclaimor --file targets.txt --concurrency 50

# With output
reclaimor --file targets.txt --output results.json --format json

# Interactive mode
reclaimor --file targets.txt --tui

# Pipe from other tools
subfinder -d example.com | reclaimor --stdin

📊 Supported Providers

GitHub Pages • Heroku • AWS S3 • AWS CloudFront • Azure Blob • Azure CDN • Netlify • Vercel • Fastly • Shopify • Tumblr • WordPress.com • Pantheon • Bitbucket • Ghost • Cargo • Feedpress • Surge.sh • Acquia • Kinsta

🔧 Configuration

Create ~/.reclaimor/config.yaml:

concurrency: 50
timeout: 15
safe_mode: true
rate_limit: 10

🐳 Docker

docker pull letchupkt/reclaimor:latest
docker run -v $(pwd)/targets.txt:/targets.txt letchupkt/reclaimor --file /targets.txt

🧪 Example Workflow

# 1. Enumerate subdomains
subfinder -d target.com -silent > subdomains.txt

# 2. Scan for takeovers
reclaimor --file subdomains.txt --output findings.json

# 3. Review findings
cat findings.json | jq '.results[] | select(.vulnerable==true)'

🛡️ Safety Features

  • Safe mode by default (detection only)
  • Explicit flags required for verification (--auto-exploit --aggressive)
  • Rate limiting to prevent DoS
  • Auto-cleanup after verification
  • Legal notice before scanning

📚 Documentation

🤝 Contributing

Contributions welcome! See CONTRIBUTING.md

📝 Responsible Disclosure

If you find vulnerabilities:

  1. Notify the asset owner privately
  2. Allow 90 days for remediation
  3. Follow responsible disclosure practices

📄 License

MIT License - Copyright (c) 2025 Lakshmikanthan (@letchupkt)

🙏 Credits

Built by @letchupkt for the security research community.


Use responsibly. Only scan authorized targets. 🔍

Metadata

Release files for reclaimor 0.1.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for reclaimor 0.1.4
File Size Uploaded Provenance Actions
reclaimor-0.1.4.tar.gz 25.6 kB Without provenance Details for reclaimor-0.1.4.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for reclaimor 0.1.4
File Interpreter ABI Platform Actions
reclaimor-0.1.4-py3-none-any.whl Python 3 none any Details for reclaimor-0.1.4-py3-none-any.whl

Total release size: 57.8 kB

Release files / reclaimor-0.1.4.tar.gz

Download URL reclaimor-0.1.4.tar.gz
Size 25.6 kB
Tags Source
SHA-256 checksum
How to use checksums
5cbd472a0e9ca026fce0506185fb0b0f70e70d2a70b75a79b36022babd5b9658
BLAKE2b-256 checksum
How to use checksums
ef0ae7d5638ee4dfe6accb348c284d5942acd2df60e3109123a5fe991d8cd239
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.0

Release files / reclaimor-0.1.4-py3-none-any.whl

Download URL reclaimor-0.1.4-py3-none-any.whl
Size 32.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
398f2fcf8b8c953b87afe86c19c2c0915b2676670044a753585909485b2686dd
BLAKE2b-256 checksum
How to use checksums
bc0d91e311cab56c27332bc10ae6951304f5e6ace97631c6443e990c69040213
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.0

Security for reclaimor 0.1.4

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page