Noureddine RAMDI / FinalRecon: a unified Python CLI for comprehensive web reconnaissance and OSINT automation

Created Tue, 05 May 2026 13:37:39 +0000 Modified Sat, 23 May 2026 20:41:27 +0000

thewhiteh4t/FinalRecon

Every time you juggle a dozen standalone scripts to gather OSINT or perform web reconnaissance, FinalRecon is what you wish existed. It bundles multiple reconnaissance tasks into one Python CLI, simplifying and streamlining workflows that otherwise require chaining disparate tools.

what finalrecon does and how it is built

FinalRecon is a command-line tool written in Python that automates and consolidates common web reconnaissance and OSINT tasks into a single execution pipeline. Instead of running separate scripts for SSL checks, WHOIS lookups, DNS enumeration, port scanning, subdomain discovery, directory brute-forcing, and web crawling, FinalRecon integrates all these steps under one hood.

The architecture is modular, allowing users to enable or disable specific reconnaissance modules as needed. It supports more than 40 types of record queries and pulls data from over 10 reliable sources, enhancing accuracy and coverage. The core functionality includes header inspection, SSL and WHOIS data fetching, DNS and subdomain enumeration, brute force directory scanning, and top 1000 port scanning.

FinalRecon is designed primarily for penetration testers and security researchers working on Linux distributions geared toward security, such as Kali Linux, BlackArch, and SecBSD. The tool supports native installation via system package managers on these distros, as well as a Docker image for containerized usage.

Under the hood, it is built with Python 3, using libraries and modules suitable for handling network requests, threading, and DNS queries. It allows users to configure threading options, timeouts, and custom wordlists for brute forcing, giving flexibility for performance tuning and precision.

what sets finalrecon apart technically

What distinguishes FinalRecon is its consolidation of fragmented OSINT and web recon workflows into a single CLI with clear modularity and configurability. Most tools in this space offer single-purpose scripts or require stitching together various utilities manually. FinalRecon aims to replace that complexity by orchestrating multiple reconnaissance techniques in one pass.

Its support for over 40 record types and over 10 data sources is notable, especially given the integration of optional third-party APIs to enhance subdomain discovery. This API key modularity means users can plug in keys from popular services to improve results without bloating the core tool.

The codebase is surprisingly clean for a tool covering such a broad scope. The CLI interface is straightforward, with options to adjust threading and timeouts, which is important since network tasks like brute forcing and port scanning can be bottlenecks. The ability to customize wordlists also means users can tailor directory brute forcing to their target.

One tradeoff is that FinalRecon is opinionated toward Linux environments focused on security testing, which limits its out-of-the-box usability for Windows or macOS users. However, the Docker image alleviates this to some extent by providing an isolated container environment.

Another consideration is the reliance on API keys for some third-party services, which means users need to manage these keys separately to unlock full functionality. This is common among OSINT tools but worth noting.

Overall, FinalRecon balances breadth and usability, offering a comprehensive yet configurable solution without becoming an unwieldy monolith.

quick start

Installation is straightforward on supported Linux distributions and via Docker. Here are the commands as documented:

Kali Linux

sudo apt install finalrecon

BlackArch Linux

sudo pacman -S finalrecon

SecBSD

doas pkg_add finalrecon

Other Linux

git clone https://github.com/thewhiteh4t/FinalRecon.git
cd FinalRecon
pip3 install -r requirements.txt

Docker

docker pull thewhiteh4t/finalrecon
docker run -it --entrypoint /bin/sh thewhiteh4t/finalrecon

Docker users can also define an alias for easier CLI usage:

alias finalrecon="docker run -it --rm --name finalrecon  --entrypoint 'python3' thewhiteh4t/finalrecon finalrecon.py"

Then run finalrecon to start scanning.

Note that running Docker commands requires root privileges, and if you have API keys, you can commit the Docker image locally to embed them.

verdict

FinalRecon is a solid choice for penetration testers and security researchers who want to unify their web reconnaissance and OSINT workflows into a single tool. Its modular architecture, extensive data source integration, and configurable scanning options offer a practical balance between functionality and usability.

The tool is best suited for users comfortable with Linux security distros or those who can leverage its Docker image. The need to manage third-party API keys separately is a minor hurdle but standard in this domain.

If you find yourself frequently chaining multiple recon scripts or juggling different OSINT tools, FinalRecon can simplify your workflow significantly. It’s not a silver bullet—some specialized tasks may still require dedicated tools—but as a consolidated reconnaissance pipeline, it works well and is worth exploring.

For practitioners who appreciate configurable threading, custom wordlists, and integrated subdomain enumeration backed by multiple data sources, FinalRecon stands out as a practical, well-maintained option in an often fragmented tooling landscape.


→ GitHub Repo: thewhiteh4t/FinalRecon ⭐ 2,731 · Python