How xploitoverload/nethound works
NetHound is a CLI threat-intelligence tool for collecting, archiving, searching, and summarizing newly registered domains. A user can fetch registrations by date and TLD: the CLI parses the date, dispatches to the .IN or WhoisDS fetcher, and either streams/formats results or saves them in the local archive. Users can also search archived records, including by regex and TLD/date filters, and view archive statistics. The source excerpts show these core paths; other documented capabilities are represented where supported, but no unsampled implementation details are assumed.
Main entry points: cli.py Command router · registry_in.py .IN fetcher · whoisds.py WhoisDS fetcher · search.py Domain search
Components 13
CLI workflows
- Command router
nethound/cli.py - Date parsing
nethound/config.py - Fetch output
nethound/cli.py
Domain collection
- .IN fetcher
nethound/fetchers/registry_in.py - Registry.in
- WhoisDS fetcher
nethound/fetchers/whoisds.py - WhoisDS service
- Archive extraction
nethound/fetchers/whoisds.py - PDF extraction
nethound/fetchers/registry_in.py
Local archive
- Domain archive
Archive analysis
- Domain search
nethound/search.py - Archive statistics
nethound/cli.py
Other components
- Security user
Connections 15
- Security user → Command router: runs commands
nethound/cli.py - Command router → Date parsing: parses dates
nethound/cli.py - Command router → .IN fetcher: dispatches .IN
nethound/cli.py - Command router → WhoisDS fetcher: dispatches WhoisDS
nethound/cli.py - .IN fetcher → Registry.in: downloads PDF
nethound/fetchers/registry_in.py - .IN fetcher → PDF extraction: extracts domains
nethound/fetchers/registry_in.py - PDF extraction → Domain archive: writes records
nethound/fetchers/registry_in.py - WhoisDS fetcher → WhoisDS service: downloads archive
nethound/fetchers/whoisds.py - WhoisDS fetcher → Archive extraction: extracts domains
nethound/fetchers/whoisds.py - Archive extraction → Domain archive: writes records
nethound/fetchers/whoisds.py - Command router → Fetch output: formats results
nethound/cli.py - Command router → Domain search: runs search
nethound/cli.py - Domain search → Domain archive: reads records
nethound/search.py - Command router → Archive statistics: runs stats
nethound/cli.py - Archive statistics → Domain archive: counts records
nethound/cli.py