O dirs é uma ferramenta focada em enumeração de diretórios e subdiretórios na web a partir de listas de palavras. O projeto permite identificar caminhos válidos em aplicações web de forma rápida e eficiente, utilizando buscas automatizadas baseadas em wordlists customizadas.
$ python dirs.py -u https://example.com -w wordlist.txt --mode all
[dirs] Alvo : https://example.com
[dirs] Wordlist: wordlist.txt (4729 entradas)
[dirs] Modo : all
────────────────────────────────────────────────
[200] https://example.com/admin
[200] https://example.com/login
[301] https://example.com/assets
[403] https://example.com/config
[200] https://example.com/api/v1
────────────────────────────────────────────────
[+] 5 caminhos encontrados em 12.4s
- 📂 Enumeração simultânea de diretórios e subdiretórios
- 🗂️ Modo seletivo — liste apenas diretórios ou apenas subdiretórios
- ⏱️ Delay configurável entre requisições para controle de taxa
Pré-requisitos: Python 3.8+
git clone https://github.com/mat7heus/dirs.git
cd dirs
pip install -r requirements.txtpython dirs.py -u <URL> -w <WORDLIST> --mode <MODO DE BUSCA>Scan básico:
python dirs.py -u https://example.com -w wordlists/common.txtListar apenas diretórios:
python dirs.py -u https://example.com -w <WORDLIST> --mode dirsListar apenas subdiretórios:
python dirs.py -u https://example.com -w <WORDLIST> --mode subdirsScan com delay de 1s entre requisições:
python dirs.py -u https://example.com -w <WORDLIST> --delay 1| Flag | Tipo | Padrão | Descrição |
|---|---|---|---|
-u, --url |
string |
— | URL alvo (obrigatório) |
-w, --wordlist |
path |
— | Caminho para a wordlist (obrigatório) |
--mode |
string |
— | Modo de listagem: all, dirs, subdirs (obrigatório) |
--delay |
float |
0 |
Intervalo em segundos entre requisições |
-h, --help |
— | — | Exibe esta mensagem de ajuda e sai |
- Enumeração de diretórios e subdiretórios via wordlist
- Modo seletivo (
dirs,subdirs,all) - Delay configurável entre requisições
- Suporte a exportação em JSON e CSV
- Opção de recursão em profundidade
- Suporte a autenticação (cookies / headers customizados)
- Relatório com estatísticas detalhadas
- Integração com proxies e Tor
Contribuições são bem-vindas! Sinta-se à vontade para abrir uma issue ou enviar um pull request.
- Faça um fork do projeto
- Crie uma branch (
git checkout -b feature/nova-funcionalidade) - Commit suas alterações (
git commit -m 'Adiciona nova funcionalidade') - Faça push (
git push origin feature/nova-funcionalidade) - Abra um Pull Request
Distribuído sob a licença MIT. Consulte o arquivo LICENSE para mais detalhes.
Aviso legal: esta ferramenta é destinada exclusivamente a testes de segurança autorizados. O uso em sistemas sem permissão explícita é ilegal e de responsabilidade exclusiva do usuário.