Expand description
§🦆 DuckDuckGo
██████╗ ██████╗ ██████╗
██╔══██╗██╔══██╗██╔════╝
██║ ██║██║ ██║██║ ███╗
██║ ██║██║ ██║██║ ██║
██████╔╝██████╔╝╚██████╔╝
╚═════╝ ╚═════╝ ╚═════╝
Search and advanced search in DuckDuckGo
========================================§📖 Table of Contents
§🚀 Installation
To install duckduckgo cli, use the following Cargo command:
cargo install --locked duckduckgo --all-features§✨ Features
- 🔍 Simple and advanced search: Perform DuckDuckGo searches using basic queries or advanced search operators.
- ⚙️ Search operators: Refine results using DuckDuckGo-compatible filters (e.g. site, filetype, intitle).
- 🛡️ Safe search toggle: Enable or disable family-friendly search filtering.
- 🖨️ Output formatting: Choose between list or detailed formats for displaying results.
- 🧮 Result limiting: Limit the number of results returned (default is 10).
- 🧭 Backend selection: Use
--backendto choose the search backend (Auto,HTML, orAPI). - 🌐 Custom user agent: Spoof or specify a user agent string for requests.
- 🧩 Cookie control: Enable or disable cookie handling for requests.
- 🕵️ Proxy support: Route requests through a custom HTTP or SOCKS proxy.
- 🐛 Verbose mode: Print debug information for troubleshooting.
- 🎨 ANSI-colored output: Enjoy beautiful, readable output right in your terminal.
§🚗 Usage
Learn how to use the duckduckgo and explore its features with the following examples:
§Perform a basic search:
ddg --query "rust lang"§Use search operators:
ddg --query "rust lang" --operators "+tutorial"§Enable safe search:
ddg --query "rust lang" --safe§Set the output format to detailed:
ddg --query "rust lang" --format§Limit the number of results to 3:
ddg --query "rust lang" --limit 3§Set user agent:
ddg --query "rust lang" --user-agent "chrome"§Set Different Backends:
# news
ddg --query "rust lang" --backend news
# images
ddg --query "rust lang" --backend images
# lite
ddg --query "rust lang" --backend liteAvailable Browsers/Agents
| Browser/Agent |
|---|
| abrowse |
| acoo browser |
| america online browser |
| amigavoyager |
| aol |
| arora |
| avant browser |
| beonex |
| bonecho |
| browzar |
| camino |
| charon |
| cheshire |
| chimera |
| chrome |
| chromeplus |
| classilla |
| cometbird |
| comodo_dragon |
| conkeror |
| crazy browser |
| cyberdog |
| deepnet explorer |
| deskbrowse |
| dillo |
| dooble |
| edge |
| element browser |
| elinks |
| enigma browser |
| enigmafox |
| epiphany |
| escape |
| firebird |
| firefox |
| fireweb navigator |
| flock |
| fluid |
| galaxy |
| galeon |
| granparadiso |
| greenbrowser |
| hana |
| hotjava |
| ibm webexplorer |
| ibrowse |
| icab |
| iceape |
| icecat |
| iceweasel |
| inet browser |
| internet explorer |
| irider |
| iron |
| k-meleon |
| k-ninja |
| kapiko |
| kazehakase |
| kindle browser |
| kkman |
| kmlite |
| konqueror |
| leechcraft |
| links |
| lobo |
| lolifox |
| lorentz |
| lunascape |
| lynx |
| madfox |
| maxthon |
| midori |
| minefield |
| mozilla |
| myibrow |
| myie2 |
| namoroka |
| navscape |
| ncsa_mosaic |
| netnewswire |
| netpositive |
| netscape |
| netsurf |
| omniweb |
| opera |
| orca |
| oregano |
| osb-browser |
| palemoon |
| phoenix |
| pogo |
| prism |
| qtweb internet browser |
| rekonq |
| retawq |
| rockmelt |
| safari |
| seamonkey |
| shiira |
| shiretoko |
| sleipnir |
| slimbrowser |
| stainless |
| sundance |
| sunrise |
| surf |
| sylera |
| tencent traveler |
| tenfourfox |
| theworld browser |
| uzbl |
| vimprobable |
| vonkeror |
| w3m |
| weltweitimnetzbrowser |
| worldwideweb |
| wyzo |
§Set cookie for subsequent requests:
ddg --query "rust lang" --cookie§Set proxy:
ddg --query "rust lang" --proxy "socks5://192.168.1.1:9000"§🎨 Options
| Option | Default Value | Description |
|---|---|---|
--query, -q | (required) | Set the search query. |
--operators, -o | "" | Set search operators (e.g., +site:rust-lang.org). |
--safe, -s | false | Enable safe search (family-friendly results). |
--format, -f | false | Output format: false = list, true = detailed. |
--limit, -l | 10 | Limit the number of search results. |
--user-agent, -u | firefox | Set a custom user agent for HTTP requests. |
--cookie, -c | true | Enable cookie handling for the HTTP client. |
--proxy, -p | "" | Set a proxy for requests (e.g., socks5://192.168.1.1:9000). |
--backend, -b | Auto | Choose backend: Auto, HTML, or API. |
--verbose, -v | false | Enable verbose (debug) mode. |
§🤝 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.