Install

$ pip install ddg

or from the source:

$ python setup.py install

Usage

ddg [-h] [-b] [-d] [-j] [-l] [-s] [-u] [query [query ...]]

www.duckduckgo.com zero-click api for your command-line

positional arguments:

query the search query

optional arguments:

-h, --help

show this help message and exit

-b, --bang

open the !bang redirect url in a new browser tab

-d, --define

return the definition result

-j, --json

return the zero-click info api json response

-l, --lucky

open the result url in a new browser tab

-s, --search

launch a DuckDuckGo search in a new browser tab

-u, --url

return the result url

Examples

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

$ddg red-black tree
A red–black tree is a type of self-balancing binary search tree, a data structure
used in computer science, typically used to implement associative arrays.

Get the url of the answer source

$ ddg red-black tree -u
https://en.wikipedia.org/wiki/Red-black_tree

Combinining flags behaves as expected

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

Launch a !Bang redirect in your web browser with the -b flag

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 Duck Duck Go with -s

$ ddg Lord of the Rings -s

Launch the result url directly with -l

$ ddg python webbrowser -l

ddg plays nice with other utilities in your shell

$ echo "shark" | ddg -dl

$ ddg welsh corgi -u | pbcopy

$ ls | ddg -du

Use -j to output the json response from the API

$ ddg simpsons characters -j >> file.txt

Thanks

0.2.2 (2012-12-20)

• Fixed the error handling for printing results with special characters

0.2.1 (2012-12-18)

• When an exception is raised in the duckduckgo module, report the error and then return None. This allows ddg.py to continue to the next query rather than performing a sys.exit(1).

• Updated README

• Fixed formatting in LICENSE file

• Changed CHANGES to an rst file

• Updated the setup.py file

• Updated the help for all the input arguments

0.2.0 (2012-12-17)

• Changed the behavior of the -d flag. Rather than prefixing the query with define, now just prioritize the definition result when searching for an answer to the query.

• Updated README with more examples.

0.1.7 (2012-12-16)

• Added a new trove classifier and made code more PEP8 compliant

0.1.6 (2012-12-16)

• Fixed an issue with the -b prefix, please upgrade to the latest version with pip install –upgrade ddg

0.1.5 (2012-12-15)

• Updated license to MIT

0.1.4 (2012-12-15)

• Using webbrowser rather than os dependent Popen commands

0.1.1 (2012-12-15)

• First working version, initial release