koppen/rbing

a Ruby library for Microsoft's Bing search API. This fork aims at updating RBing to work with Bing Search API Data from Windows Azure Data Marketplace.

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¶ ↑

• HTTParty: httparty.rubyforge.org/

Resources¶ ↑

RBing:

• Source Code: github.com/mikedemers/rbing/tree

• Support: github.com/mikedemers/rbing/issues

Bing:

• Bing API: www.bing.com/developers

• Register for App Id: www.bing.com/developers/createapp.aspx

• Bing API Reference: msdn.microsoft.com/en-us/library/dd251056.aspx

• Query Keywords: help.live.com/help.aspx?project=wl_searchv1&market=en-US&querytype=keyword&query=redliub&tmt=&domain=www.bing.com:80