Skip to content

Latest commit

 

History

History
92 lines (63 loc) · 2.53 KB

README.rdoc

File metadata and controls

92 lines (63 loc) · 2.53 KB

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: