Dirsearch Command Guide

Dirsearch is a mature, command-line web path scanner (brute-forcer) written in Python. It's known for its colorful output and smart heuristic detection.

Top 10 Useful Commands

1. Basic Scan

python3 dirsearch.py -u http://target.com

Explanation: Default scan using the built-in dictionary.

2. Custom Extensions

dirsearch -u http://target.com -e php,html,js

Explanation: Scans for specific extensions (-e).

3. Specific Wordlist

dirsearch -u http://target.com -w /path/to/wordlist.txt

Explanation: Uses a custom wordlist (-w).

4. Exclude Status Codes

dirsearch -u http://target.com -x 403,404,500

Explanation: Excludes specific HTTP status codes (-x) from the output.

5. Recursive Scan

dirsearch -u http://target.com -r --deep-recursive

Explanation: recursively scans found directories.

6. Threads

dirsearch -u http://target.com -t 50

Explanation: Increases threads (-t) to 50 for speed.

7. Random User Agent

dirsearch -u http://target.com --random-agent

Explanation: Randomizes the User-Agent header to evade WAFs.

8. Cookie/Auth

dirsearch -u http://target.com --cookie "SessionId=123"

Explanation: Scans as an authenticated user.

9. Simple Report

dirsearch -u http://target.com --simple-report=report.txt

Explanation: Saves a simplified text report.

10. Subdirs

dirsearch -u http://target.com --subdirs admin/,backup/

Explanation: Forces scanning specific subdirectories.

The Most Powerful Command

dirsearch -u http://target.com -e php,html,js -x 400,403,404,500 -t 50 --random-agent -o report.json

Explanation: A fast, evasive, and clean scan that ignores error pages and output JSON.