ddg 0.2.0

Install

pip install ddg

or from the source:

python setup.py install

Usage

www.duckduckgo.com zero-click api for your command-line [-h] [-b] [-d] [-j] [-l] [-s] [-u] [query [query …]]

positional arguments:

query the search query

optional arguments:

-h, --help

show this help message and exit

-b, --bang

prefix query with ! and launch the redirect url

-d, --define

attempt to return the definition

-j, --json

returns the raw json output

-l, --lucky

launch the first url found

-s, --search

launch a search on www.duckduckgo.com

-u, --url

return the url of the result found

Examples

Call ddg from your command line to access the Duck Duck Go Zero-Click Info API

$ ddg my ip
Your IP address is <ip> in <location>

$ ddg schnauzer
A schnauzer is a dog breed that originated in Germany in the 15th and 16th centuries.

Use the -u flag to return the url of the answer source.

$ ddg schnauzer -u
https://en.wikipedia.org/wiki/Schnauzer

You can get a definition using the -d flag

$ ddg catfish -d
catfish definition: any of an order (Siluriformes) of chiefly
freshwater stout-bodied scaleless bony fishes having long tactile barbels.

Combinining flags behaves as expected

$ ddg catfish -d -u
http://www.merriam-webster.com/dictionary/catfish

You can use the -b flag to launch a !Bang redirect in your browser

Launch a query on Wolfram Alpha

$ ddg wa integral of sin x / x from negative inf to inf -b

Launch a search on Stack Overflow

$ ddg so [c++11] lambda return values -b

Launch a search on Python for the webbrowser module

$ ddg py webbrowser -b

Feeling lucky? Launch the Python webbrowser documentation directly with -l

$ ddg python webbrowser -l

You can launch a search on Duck Duck Go with the -s flag

$ ddg Lord of the Rings -s

ddg plays nice with all the unix-like utilities you know and love

$ echo "shark" | ddg -d -l

Use -j to output the json response from the API

$ ddg simpsons characters -j >> file.txt

Attempt to print definition urls for all file and folder names in your current directory

$ ls | ddg -du

Thanks