mikedemers / rbing
watch download tarball
public
Forks3Right
Watchers10Right
Description: a Ruby library for Microsoft's Bing search API
Homepage: http://9astronauts.com/code/ruby/rbing
Clone URL: git://github.com/mikedemers/rbing.git
rbing /
name age
history
message
file .gitignore Thu Nov 05 09:17:40 -0800 2009 updated gitignore rules [mikedemers]
file LICENSE Mon Jun 08 18:05:29 -0700 2009 Initial Commit [mikedemers]
file README.rdoc Tue Oct 27 14:07:13 -0700 2009 Fixed typo in README example code [johngibbs]
file Rakefile Thu Nov 05 09:26:31 -0800 2009 Moving gem from github to gemcutter... Bumped v... [mikedemers]
file TODO Mon Jun 08 18:05:29 -0700 2009 Initial Commit [mikedemers]
directory bin/ Mon Jun 08 18:05:29 -0700 2009 Initial Commit [mikedemers]
directory lib/ Mon Jun 08 20:19:36 -0700 2009 Now prefixing query keyword to every parameter ... [mikedemers]
file rbing.gemspec Thu Nov 05 09:26:31 -0800 2009 Moving gem from github to gemcutter... Bumped v... [mikedemers]
directory script/ Mon Jun 08 18:05:29 -0700 2009 Initial Commit [mikedemers]
directory spec/ Mon Jun 08 18:05:29 -0700 2009 Initial Commit [mikedemers]
README.rdoc

RBing

A gem that provides an interface to Microsoft’s Bing search API.

Usage

Get a App ID at: <www.bing.com/developers/createapp.aspx> 

  require 'rubygems'
  require 'rbing'
  bing = RBing.new("YOURAPPID")

  rsp = bing.web("ruby")
  puts rsp.web.results[0].title
  => "Ruby (programming language) - Wikipedia, the free encyclopedia"

  rsp = bing.web("ruby", :site => "github.com")
  puts rsp.web.results[0].url
  => "http://github.com/vim-ruby/vim-ruby/tree/master"

  rsp = bing.web("ruby", :site => ["github.com", "rubyforge.org"])
  puts rsp.web.results[0].url
  => "http://rubyforge.org/"

  rsp = bing.news("search engines")
  puts rsp.news.results[0].title
  => "Microsoft Bing more popular than Yahoo"

  rsp = bing.spell("coincidance")
  puts rsp.spell.results[0].value
  => "coincidence"

  rsp = bing.instant_answer("How many rods in a furlong?")
  puts rsp.instant_answer.results[0].instant_answer_specific_data.encarta.value
  => "1 furlong = 40 rods"

Command Line Utility

RBing also has a simple command line interface.

Put your App Id into $HOME/.rbing_app_id and you can use rbing: 

  $> rbing "ruby gems"
  [{"Url"=>"http://rubygems.org/",
    "Title"=>"RubyGems Manuals",
    "CacheUrl"=>
     "http://cc.bingj.com/cache.aspx?q=ruby+gems&d=76167709461212&w=39b024d8,55a87382",
    "DisplayUrl"=>"rubygems.org",
    "DateTime"=>Wed Jun 03 11:25:29 UTC 2009,
    "Description"=>
     "The Gem::Specification object controls the data..."},
   ...
  ]

The default source is "web" but you can specify another: 

  $> rbing news "revolutionary technology"
  [{"BreakingNews"=>0,
    "Url"=>
     "http://www.tmcnet.com/usubmit/-bt-successfully-completes-exchange-exchange-cisco-telepresence-call-/2009/06/04/4211245.htm",
    "Source"=>"TMCnet",
    "Title"=>
     "BT Successfully Completes Exchange to Exchange Cisco TelePresence Call ... ",
    "Snippet"=>
     "BT Successfully Completes Exchange to Exchange Cisco TelePresence Call; Revolutionary...",
    "Date"=>Thu Jun 04 13:33:09 UTC 2009},
   ...
  ]

Dependencies

Resources

RBing:

Bing: