Skip to content
Simple Ruby script to make a Google web search query and return the top hit in various formats.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


lucky.rb outputs a link to the top hit on Google for a given search string. I wrote it to use in MacOS X with Automator + Services so that I could have a global keyboard shortcut that would replace a string with its "I'm Feeling Lucky" result-- handy for writing blog posts, comments, etc.

Usage: lucky.rb [options] query1 query2 ...
        --credentials FILE           A file containing a Google API key and referrer URL
    -f, --format FORMAT              The output format (url, html, or markdown)
    -k, --key KEY:URL                API key and referrer URL (overrides credentials file)
    -h, --help                       Display this screen

To use lucky.rb, you'll need to have an API key to use the AJAX API.
You can get one here:

By default, lucky.rb looks for your credentials in ~/.google_key in the following format:
line 1: API key
line 2: the "website URL" you entered when signing up

You can’t perform that action at this time.