google-cse

A wee Google CSE client. Use it to easily query your custom search engine. Supports image search.

Installation

Add this line to your application's Gemfile:

gem 'google-cse'

And then execute:

$ bundle

Or install it yourself as:

$ gem install google-cse

Usage

Set it up:

    # you will need a Google API account and have CSE enabled.
require 'google_cse'
GoogleCSE::CX = '<your-cx>'
GoogleCSE::KEY = '<your-app-key>'

If you are on a rails app, you should stick the constants in an initializer

Run a search and visit the first result, 'feeling lucky' style (on a mac):

g = GoogleCSE.search('Ian Kilminster')
`open -a Safari #{g.fetch.results.first.link}`

Do the same for an image:

g = GoogleCSE.image_search('Ian Kilminster')
img = g.fetch.results.first.link
file = img.split('/').last
File.open(file,'w') {|f| f.write(open(img).read)} 
`open -a Preview #{file}`

Paginated access:

g = GoogleCSE.image_search('Ian Kilminster')
g.fetch.results.first.link # fetches first page, first result
#=> http://en.wikipedia.org/wiki/Lemmy

g.total # number of total results
#=> 5400000
g.per_page # number of results per page
#=> 10

g.previous? # is there a previous page?
#=> false
g.previous # what did I just say just now?
#=> nil

g.next? # is there a next page?
#=> true
g.next.results.first.link # fetches next page, first result
#=> http://www.discogs.com/artist/Ian+Fraser+Kilmister
g.page # the current page number
#=> 2
g.current_index # the current page's starting index / or rank :)
=> 11

g.previous?
#=> true
g.previous.results.first.link # ...and back to first page
#=> http://en.wikipedia.org/wiki/Lemmy
g.page
#=> 1

You can specify any extra parameters the API allows. View a complete list here

Example:

# Only return large jpegs, I can't enjoy such high art otherwise
g = GoogleCSE.image_search('Flight of Icarus Cover', :fileType => :jpg, :imgSize => :large)
#=> http://musictrajectory.com/wp-content/uploads/2011/08/iron-maiden-flight-of-icarus-single-cover.jpg

Contributing

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request