dirsearch - Descubrimiento de rutas web

Un avanzado brute-forcer de rutas web

dirsearch está siendo desarrollado activamente por @maurosoria y @shelld3v.

Únete al servidor de Discord para comunicarte con el equipo.

Inicio rápido

dirsearch requiere Python 3.11 o superior.

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

También puedes instalar la pila Python más reciente directamente desde GitHub con pip:

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

El backend nativo de Rust es opcional para instalaciones desde el código fuente; consulta Instalación para los pasos de compilación nativa.

Los binarios precompilados de PyInstaller y los archivos de carpeta portátiles están disponibles en la página de lanzamientos.

Documentación

La documentación completa ahora se encuentra en docs/:

• Instalación: plataformas compatibles, instalación de Python, artefactos de lanzamiento y Docker.
• Guía de uso: escaneos comunes, recursión, filtros, proxies, solicitudes en bruto, informes y consejos.
• Listas de palabras: %EXT%, categorías, plantillas, prefijos, sufijos y transformaciones.
• Opciones de CLI: referencia completa de la línea de comandos.
• Configuración: referencia de config.ini.
• Sesiones: guardar, listar y reanudar sesiones de escaneo.
• API de Python: ejemplos de API importable.
• Compilación: PyInstaller, compilaciones portátiles, imágenes Docker y GitHub Actions.
• Referencias: tutoriales y artículos externos.

Ejemplos mínimos

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

Usa python3 dirsearch.py -h para la ayuda completa de la CLI.

API de Python

dirsearch también se puede utilizar desde código Python para automatización local, servidores MCP, envolturas REST y escaneos controlados por agentes. La API importable mantiene su configuración en FuzzerConfig, por lo que los llamadores no necesitan analizar banderas de CLI ni mutar globales de CLI.

Consulta API de Python para ejemplos que cubren plantillas, listas de palabras personalizadas, callbacks, sesiones autenticadas y recetas de escaneo orientadas a agentes.

Contribuciones

Las solicitudes de extracción y las solicitudes de características son bienvenidas. Consulta CONTRIBUTORS.md para las personas que han ayudado a mejorar dirsearch.

Licencia

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

Licencia: GNU General Public License, version 2.