dirsearch - Descoberta de Caminhos Web

Um brute-forcer avançado de caminhos web

dirsearch está sendo ativamente desenvolvido por @maurosoria e @shelld3v.

Junte-se ao servidor Discord para se comunicar com a equipe.

Início Rápido

dirsearch requer Python 3.11 ou superior.

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

Você também pode instalar a pilha Python mais recente diretamente do GitHub com pip:

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

O backend nativo Rust é opcional para instalações a partir da fonte; veja Instalação para as etapas de compilação nativa.

Binários PyInstaller pré-construídos e arquivos de pasta portáteis estão disponíveis na página de Releases.

Documentação

A documentação completa agora está em docs/:

• Instalação: plataformas suportadas, instalação Python, artefatos de release e Docker.
• Guia de Uso: varreduras comuns, recursão, filtros, proxies, requisições brutas, relatórios e dicas.
• Wordlists: %EXT%, categorias, templates, prefixos, sufixos e transformações.
• Opções de CLI: referência completa da linha de comando.
• Configuração: referência do config.ini.
• Sessões: salvar, listar e retomar sessões de varredura.
• API Python: exemplos de API importável.
• Compilação: PyInstaller, compilações portáteis, imagens Docker e GitHub Actions.
• Referências: tutoriais e artigos externos.

Exemplos 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

Use python3 dirsearch.py -h para obter a ajuda completa da CLI.

API Python

dirsearch também pode ser usado a partir de código Python para automação local, servidores MCP, wrappers REST e varreduras controladas por agente. A API importável mantém sua configuração em FuzzerConfig, então os chamadores não precisam analisar flags de CLI ou modificar globais da CLI.

Veja API Python para exemplos cobrindo templates, wordlists personalizadas, callbacks, sessões autenticadas e receitas de varredura orientadas a agente.

Contribuindo

Pull requests e solicitações de funcionalidades são bem-vindos. Veja CONTRIBUTORS.md para as pessoas que ajudaram a melhorar o dirsearch.

Licença

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

Licença: GNU General Public License, versão 2.