kevin-rs / duckduckgo

πŸ¦† A CLI and library for instant DuckDuckGo searches. (WIP)
https://docs.rs/duckduckgo
MIT License
1 stars 2 forks source link
api clap cli dorks duckduckgo duckduckgo-api rust

πŸ¦† 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

πŸš— Usage

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

Perform a basic search:

duckduckgo --query "rust lang"

Use search operators:

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

Enable safe search:

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 |

Set cookie for subsequent requests:

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.