bangsearch 🔎

Um menu rápido de linha de comando (TUI-lite) para pesquisar na web usando os bangs do DuckDuckGo via ddgr — sem precisar decorar !yt, !github, !cve etc. toda vez.

Escolhe o destino numa lista (com fuzzy finder se tiver fzf instalado), digita o termo, e pronto: a busca abre direto no terminal.

$ ./bangsearch.zsh
Buscar em > git
> GitHub
  GitLab

Buscar por: awesome-pentest

✨ Por quê

Usar ddgr no dia a dia é ótimo, mas ficar lembrando a sintaxe de cada bang (!so, !aur, !exploitdb...) quebra o fluxo. O bangsearch resolve isso com um menu simples e extensível.

📋 Requisitos

• zsh
• ddgr — obrigatório
• fzf — opcional (fallback automático pro select nativo do zsh se não estiver instalado)

Instalação dos requisitos (Arch/Manjaro)

yay -S ddgr fzf

Outras distros: consulte a documentação do ddgr e do fzf para o método de instalação.

🚀 Instalação

git clone https://github.com/darioomatos/bangsearch.git
cd bangsearch
chmod +x bangsearch.zsh

(Opcional) Alias global

Adicione ao seu ~/.zshrc:

alias bs='~/caminho/para/bangsearch.zsh'

Depois é só bs de qualquer lugar do terminal.

▶️ Uso

./bangsearch.zsh

1. Escolha o destino da busca (YouTube, GitHub, Stack Overflow, Exploit-DB, CVE/NVD etc.)
2. Digite o termo de busca
3. Os resultados aparecem direto no terminal via ddgr

🔧 Bangs incluídos por padrão

Destino	Bang
YouTube	!yt
GitHub	!github
GitLab	!gitlab
Stack Overflow	!so
Reddit	!reddit
Wikipedia (PT)	!wpt
Wikipedia (EN)	!w
Arch Wiki	!aw
AUR	!aur
Exploit-DB	!exploitdb
CVE / NVD	!cve
Hacker News	!hn
npm	!npm
PyPI	!pypi
crates.io	!crates
Imagens	!i
Notícias	!n
Mapas	!m
Sem bang (web geral)	—

➕ Como adicionar um novo destino

Edite bangsearch.zsh e adicione uma entrada no array associativo BANGS e o nome correspondente em ORDER:

BANGS=(
  # ...
  "Shodan"  "!shodan"
)

ORDER=(
  # ...
  "Shodan"
)

🗺️ Roadmap

• Histórico de buscas recentes
• Suporte a múltiplos bangs simultâneos
• Compatibilidade com bash puro (sem depender de array associativo do zsh)

🤝 Contribuindo

Pull requests são bem-vindos! Sinta-se à vontade para abrir uma issue com sugestões de novos bangs ou melhorias no menu.

📄 Licença

MIT