ABOUT:

ducky is ... well, the web's command line. not to be confused with what
inspired it, 'yubnub', the command line of the web. no, you don't have to
leave the command line for ducky.

ducky marries a bunch of web service APIs into one tool, conventiently
callable from the command line. search the web without using a browser.

i really like staying on the command line just to answer a few questions.

REQUIREMENTS:

	- python
	- web service API keys for many of the services used
	  http://www.google.com/apis/
	  http://technorati.com/developers/
	  http://www.amazon.com/gp/aws/landing.html
	  http://developer.yahoo.net/

	  stash these in your home dir, like this:
-rw-r--r--    1 jose  jose        33  7 Jul 23:45 .googlekey
-rw-r--r--    1 jose  jose        33  7 Jul 23:56 .technoratikey
-rw-r--r--    1 jose  jose        21  8 Jul 21:59 .amazonkey
-rw-r--r--    1 jose  jose        33  9 Jul 01:56 .flickrkey
	  just put the text of the key in the file, ducky will load it
	  automatically.

INSTALLATION:
	$ make
	# make install

COMMANDS:

	aadl:	search the ann arbor (mi) public library
	am:	search amazon by keyword
	asin:	search amazon by ASIN
	amuk:	search amazon UK by keyword
	ameu:	search amazon EU by keyword
	amjp:	search amazon japan by keyword
	bdig:	search Blogdigger
	blink:	search BlinkList
	cite:	search CiteULike by tag
	conn:	search Connotea by tag
	day:	search daypop
	del:	search del.icio.us by tag
        deluser: search del.icio.us by a username
	feed:	search feedster by keyword
	fin:	search findory's blog search engine
	fjobs:	search feedster jobs by keywords
	fl:	search flickr by tag
	g:	search google 
	gblog:	search google blogs by keywords
 	gnews:	search Google news by keywords
	ice:	search Ice Rocket blog search engine
	ind:	search for jobs via Indeed
	isbn:	search amazon by ISBN
	mp3:	search MP3 blogs
	msn:	search via the MSN engine
	noaa:	weather conditions by airport (US only)
	simp:	search for jobs on Simply Hired
	smug:	search SmugMug by keyword
	tag:	search the folksonomy (tag universe) via gataga
	tec:	search technorati
 	tectag:	search technorati by tag
	topix:	search topix
	tube:	search YourTube with tags
	ya:	search yahoo
	yblogs:	search yahoo blog search
	yfin:	search yahoo finance by ticker symbol
	yjobs:	search yahoo jobs
	ynews:	search yahoo news

usage is really simple: <command> <term1> <term2> ...

to search google for python web API:

	$ g python web API

etc etc etc

BUGS:
	i'm sure some exist ...

CONSIDER:
	Syndic8? 	http://www.syndic8.com/web_services/

	anything else to add?

DESIGN PRINCIPLES:
	modular code, easy to extend.
           see ducky.py:main() for how to add functionality
	get XML, not HTML we have to scrape. 
	web service preferred over RSS, HTML use discouraged.

TO DO FOR 1.0:
	setup.py - make it work
