Giter Club home page Giter Club logo

recon88r's Introduction

Recon88r Script

This Python script automates the reconnaissance process for penetration testers and bug hunters. It is designed to streamline subdomain enumeration, port scanning, template-based scanning, XSS, JS file analysis, and searching for exposed panels. The script sends live results via Discord, eliminating the need to manually check logs. It can be run as a cron job or within a tmux session, allowing users to efficiently await results.

Prerequisites

Before using the script, ensure you have the following tools and dependencies installed:

Setup

  1. Clone the repository:

    git clone https://github.com/h0tak88r/Recon88r.git
  2. Navigate to the script directory:

    cd Recon88r
  3. Set up a virtual environment (optional but recommended):

    python -m venv venv
    source venv/bin/activate  # On Windows, use 'venv\Scripts\activate'
  4. Install the required prerequisites:

    bash install.sh
  5. Configure Discord Webhook URL in the Notify tool configuration file:

    nano $HOME/.config/notify/provider-config.yaml

Usage

Run the script with the desired options to perform reconnaissance tasks. Below are some examples:

python3 recon88r.py -d wurl.com -ps -ac -p -nt -nf -ep -js -xss -f -wh your_discord_webhook_url

Available Options:

  • -d, --domain: Target domain for reconnaissance (required).
  • -ps, --passive: Perform passive subdomain enumeration.
  • -ac --active : Active subdoamins enumeration
  • -p, --portscan: Perform port scanning.
  • -nt, --new-templates: Scan with newly added templates to the nuclei templates repo.
  • -nf, --nuclei-full: Perform a full nuclei scan.
  • -ep, --exposed-panels: Perform Panels dorking with nuclei templates.
  • -js, --js-exposures: Perform JS Exposures.
  • -sl, --subs-file: Path to the subdomains file(Sometimes you got the subdomains from other tools and wanna do just the other features only so pass the subs list and enjoy other features).
  • -xss, --xss-scan: Perform XSS scans.
  • -wh, --webhook: Webhook URL for Discord.
  • '-f, --fuzzing': Fuzzing with GET/POST using various techniques.

Workflow Mind-Map

url -> https://xmind.works/share/jhW6EyeZ Recon88r py Workflow-Map 1

Bash Version

  • Simply run it using command bash recon88r.sh

Contributing

If you encounter any issues or have suggestions for improvements, feel free to open an issue or submit a pull request. Collaboration is welcome, and don't hesitate to reach out for assistance.

recon88r's People

Contributors

h0tak88r avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar

recon88r's Issues

httpx command line could not be found , P.S: i have httpx and httpx-toolkit installed

[ETA 00:00:00] |██████████████████████████████████████| 14/14 rate: 14 qps (time: 00:00:00)

No valid domains remaining.
The httpx command line client could not run because the required dependencies were not installed.
Make sure you've installed everything with: pip install 'httpx[cli]'
{"type":0,"channel_id":"1236389806779404322","content":"","attachments":[{"id":"1236607005247017000","filename":"all_subs_filtered.txt","size":233,"url":"https://cdn.discordapp.com/attachments/1236389806779404322/1236607005247017000/all_subs_filtered.txt?ex=66389f85&is=66374e05&hm=c9c11c3572bb9450fde684bfd1ce53b96d5b7a447af4d32060f4ebb9fe5540c5&","proxy_url":"https://media.discordapp.net/attachments/1236389806779404322/1236607005247017000/all_subs_filtered.txt?ex=66389f85&is=66374e05&hm=c9c11c3572bb9450fde684bfd1ce53b96d5b7a447af4d32060f4ebb9fe5540c5&","content_type":"text/plain; charset=utf-8","content_scan_version":0}],"embeds":[],"timestamp":"2024-05-05T09:14:45.076000+00:00","edited_timestamp":null,"flags":0,"components":[],"id":"1236607005154869320","author":{"id":"1236390079409160202","username":"BBH-hook","avatar":null,"discriminator":"0000","public_flags":0,"flags":0,"bot":true,"global_name":null,"clan":null},"mentions":[],"mention_roles":[],"pinned":false,"mention_everyone":false,"tts":false,"webhook_id":"1236390079409160202"}
File 'subs/all_subs_filtered.txt' successfully sent to Discord.
Error: File 'subs/filtered_hosts.txt' not found.
[+] Scanning for XSS

         __  _ ___

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.