#search #command-line-tool #cli #cookies #api #dorks

bin+lib duckduckgo

🦆 A CLI and library for colorful DuckDuckGo searches

3 releases

0.1.2 Dec 27, 2023
0.1.1 Dec 27, 2023
0.1.0 Dec 26, 2023

#2544 in Command line utilities

22 downloads per month

MIT license

54KB
614 lines

🦆 DuckDuckGo

Crates.io docs License

duckduckgo 0.1.2

▓█████▄  █    ██  ▄████▄   ██ ▄█▀▓█████▄  █    ██  ▄████▄   ██ ▄█▀  ▄████  ▒█████  
▒██▀ ██▌ ██  ▓██▒▒██▀ ▀█   ██▄█▒ ▒██▀ ██▌ ██  ▓██▒▒██▀ ▀█   ██▄█▒  ██▒ ▀█▒▒██▒  ██▒
░██   █▌▓██  ▒██░▒▓█    ▄ ▓███▄░ ░██   █▌▓██  ▒██░▒▓█    ▄ ▓███▄░ ▒██░▄▄▄░▒██░  ██▒
░▓█▄   ▌▓▓█  ░██░▒▓▓▄ ▄██▒▓██ █▄ ░▓█▄   ▌▓▓█  ░██░▒▓▓▄ ▄██▒▓██ █▄ ░▓█  ██▓▒██   ██░
░▒████▓ ▒▒█████▓ ▒ ▓███▀ ░▒██▒ █▄░▒████▓ ▒▒█████▓ ▒ ▓███▀ ░▒██▒ █▄░▒▓███▀▒░ ████▓▒░
 ▒▒▓  ▒ ░▒▓▒ ▒ ▒ ░ ░▒ ▒  ░▒ ▒▒ ▓▒ ▒▒▓  ▒ ░▒▓▒ ▒ ▒ ░ ░▒ ▒  ░▒ ▒▒ ▓▒ ░▒   ▒ ░ ▒░▒░▒░ 
  ▒  ▒ ░░▒░ ░ ░   ░  ▒   ░ ░▒ ▒░ ░ ▒  ▒ ░░▒░ ░ ░   ░  ▒   ░ ░▒ ▒░  ░   ░   ░ ▒ ▒░ 
  ░  ░  ░░░ ░ ░ ░        ░ ░░ ░  ░ ░  ░  ░░░ ░ ░ ░        ░ ░░ ░ ░ ░   ░ ░ ░ ░ ▒  
          ░     ░ ░      ░  ░      ░       ░     ░ ░      ░  ░         ░     ░ ░  
                ░                ░               ░
  Search and advanced search in DuckDuckGo 
  ========================================

  Perform searches and advanced searches on DuckDuckGo from the command line.

🚀 duckduckgo: A powerful Rust-based command-line tool for seamless DuckDuckGo searches.

📖 Table of Contents

🚀 Installation

To install duckduckgo, use the following Cargo command:

cargo install --locked duckduckgo

✨ Features

  • Perform DuckDuckGo searches with or without operators.
  • Customizable user agent, proxy, and cookie support.
  • Beautiful ANSI-colored output.

🚗 Usage

Learn how to use the duckduckgo and explore its features with the following examples:

duckduckgo --query "rust lang"

Use search operators:

duckduckgo --query "rust lang" --operators "+tutorial"
duckduckgo --query "rust lang" --safe

Set the output format to detailed:

duckduckgo --query "rust lang" --format

Limit the number of results to 3:

duckduckgo --query "rust lang" --limit 3

Set user agent:

duckduckgo --query "rust lang" --user-agent "chrome"
Available Browsers/Agents
Browser/Agent
firefox
chrome
edge
safari
opera
ie11
android
ios
edge_android
opera_mini
uc_browser
blackberry
mozilla
bingbot
yahoo_slurp
duckduckgo
baiduspider
yandexbot
ahrefsbot
mj12bot
semrushbot
sogou_spider
exabot
dotbot
facebook
pinterest
slackbot
discord
zoom
whatsapp
applebot
flipboard
outlook
linux_firefox
linux_firefox_alternative
windows_firefox
older_windows_firefox
linux_chrome
macos_safari
android_chrome
ios_chrome
linux_opera
macos_edge
windows_edge
android_samsung_browser
ios_samsung_browser
linux_brave
windows_brave
android_brave
ios_brave
linux_firefox_new
linux_chrome_new
macos_safari_new
windows_ie_new
android_chrome_new
ios_chrome_new
linux_opera_new
macos_edge_new
android_samsung_browser_new
ios_samsung_browser_new
linux_brave_new
windows_brave_new
android_brave_new
ios_brave_new
linux_firefox_alternative_new
windows_firefox_new
linux_chrome_alternative_new
macos_safari_alternative_new
windows_ie_alternative_new
android_chrome_alternative_new
ios_chrome_alternative_new
linux_opera_alternative_new
macos_edge_alternative_new
windows_edge_alternative_new
android_samsung_browser_alternative_new
ios_samsung_browser_alternative_new
linux_brave_alternative_new
windows_brave_alternative_new
android_brave_alternative_new
ios_brave_alternative_new
duckduckgo --query "rust lang" --cookie

Set proxy:

duckduckgo --query "rust lang" --proxy "socks5://192.168.1.1:9000"

🎨 Options

Option Default Value Description
--safe false Enable safe search.
--proxy "" Set a proxy for the search (e.g., "socks5://192.168.1.1:9000").
--user-agent firefox Set a custom user agent for the search.
--cookie true Set a cookie for the search.
--format false Set the output format (false for list or true for detailed).
--limit 10 Limit the number of results (default is 10).

🤝 Contributing

Contributions and feedback are welcome! If you'd like to contribute, report an issue, or suggest an enhancement, please engage with the project on GitHub. Your contributions help improve this CLI for the community.

📄 License

This project is licensed under the MIT License.

Dependencies

~7–19MB
~277K SLoC