Skip to main content

Reconnaissance tool

Project description

PyPi License Documentation Status Known Vulnerabilities Donate Beerpay

Table of Contents


Project URL :

HackRecon was created to be used for OSCP certification. This tool (inspired by the "reconnoitre" tool: makes it possible to scan hosts finally to obtain a maximum of information on these. It is therefore a recognition tool. Its mechanism can be summarized as follows:

For each host:

  • Create the exploit, proof and scan folders required for OSCP certification
  • Determine open ports and related services
  • For each port:
    • List exploits related to the product using the port
    • Start scans according to the protocol
    • Suggest additional scans asking for human intervention or other exploits
  • Write an analysis report (HTML and XML format)


HackRecon run on Python 2.7 can't work correctly without the following tools

  • Nmap
  • smtp-user-enum
  • whatweb
  • nikto
  • dirb


sudo pip install hackrecon


Shortcut option Required Default Description
<ips> X The Ip(s) address of the host
-o --output . The output directory
-t --max_threads 5 The maximum number of host handled in the same time
--cache False Use cache
-a --all False Scan all ports
--css The CSS file to use into the HTML report
--javascript_header The javascript file to use into the header of the HTML report
--javascript_tail The javascript file to use into the end of the HTML report
--full Use all nmap nse scrip for the protocol. The value can be "all" or a list of protocol separated by ";"


The <ips> param can be

  • An IPv4 address (example:
  • An range of IPv4 addresses (example: or
  • A list of IPv4 address separated by ";" (example:;


  • hackrecon -o /root/,
  • hackrecon -o /root/
  • hackrecon -o /root/
  • hackrecon; -o /root/
  • hackrecon -o /root/ -t 5 --cache --all
  • hackrecon -o /root/ --javascript_header javascript_file.js --javascript_tail other_file.js --css shett.css
  • hackrecon -o /root/ -t 5 --cache --all --full all
  • hackrecon -o /root/ -t 5 --cache --all --full http;ssh;smb


Example of usage can be found in the "examples" directory

Issues management

For contributions or suggestions, please open an Issue and clearly explain, using an example or a use case if appropriate.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hackrecon-1.7.tar.gz (13.0 kB view hashes)

Uploaded source

Built Distribution

hackrecon-1.7-py2-none-any.whl (25.7 kB view hashes)

Uploaded py2

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page