dirsearch - Découverte de chemins web

Un outil avancé de brute-force de chemins web

dirsearch est activement développé par @maurosoria et @shelld3v.

Rejoignez le serveur Discord pour communiquer avec l'équipe.

Quick Start

dirsearch nécessite Python 3.11 ou supérieur.

git clone https://github.com/maurosoria/dirsearch.git --depth 1
cd dirsearch
python3 dirsearch.py -u https://example.com -e php,html,js

Vous pouvez également installer la dernière pile Python directement depuis GitHub avec pip :

pip3 install git+https://github.com/maurosoria/dirsearch.git
dirsearch -u https://example.com -e php,html,js

Le backend natif Rust est facultatif pour les installations à partir des sources ; voir Installation pour les étapes de construction native.

Les binaires PyInstaller pré-construits et les archives de dossiers portables sont disponibles sur la page des versions.

Documentation

La documentation complète se trouve maintenant dans docs/ :

• Installation : plateformes supportées, installation Python, artefacts de version et Docker.
• Guide d'utilisation : scans courants, récursivité, filtres, proxies, requêtes brutes, rapports et astuces.
• Listes de mots : %EXT%, catégories, modèles, préfixes, suffixes et transformations.
• Options CLI : référence complète de la ligne de commande.
• Configuration : référence config.ini.
• Sessions : sauvegarder, lister et reprendre des sessions de scan.
• API Python : exemples d'API importable.
• Construction : PyInstaller, constructions portables, images Docker et GitHub Actions.
• Références : tutoriels et articles externes.

Exemples minimaux

python3 dirsearch.py -u https://target
python3 dirsearch.py -u https://target -e php,html,js
python3 dirsearch.py -u https://target -e php,html,js -w /path/to/wordlist
python3 dirsearch.py -u https://target -r --max-recursion-depth 3

Utilisez python3 dirsearch.py -h pour l'aide complète de la CLI.

API Python

dirsearch peut également être utilisé depuis du code Python pour l'automatisation locale, les serveurs MCP, les wrappers REST et les scans contrôlés par des agents. L'API importable conserve sa configuration dans FuzzerConfig, de sorte que les appelants n'ont pas besoin d'analyser les indicateurs CLI ou de modifier les variables globales de la CLI.

Voir API Python pour des exemples couvrant les modèles, les listes de mots personnalisées, les rappels, les sessions authentifiées et les recettes de scan orientées agents.

Contribuer

Les pull requests et les demandes de fonctionnalités sont les bienvenues. Voir CONTRIBUTORS.md pour les personnes qui ont aidé à améliorer dirsearch.

Licence

Copyright (C) Mauro Soria ([email protected])

Licence : GNU General Public License, version 2.