mikedemers / rbing

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
  => "https://github.com/vim-ruby/vim-ruby/tree/master"
  rsp = bing.web("ruby", :site => ["github.com", "rubyforge.org"])
  puts rsp.web.results[0].url
  => "https://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"=>"https://rubygems.org/",
    "Title"=>"RubyGems Manuals",
    "CacheUrl"=>
     "https://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"=>
     "https://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