muddyit_fu

Installation

sudo gem install monkeyhelper-muddyit-fu --source http://gems.github.com

Getting started

muddy.it uses oauth to manage it’s api access. To access the muddy.it data programmatically you will need to register an application. Login and visit :

www.muddy.it/oauth_clients/

You can register an application here, a callback URI isn’t required.

The ‘consumer token’ and ‘consumer secret’ are used to generate a token for accessing muddy.it. For further details and an example of how to programatically generate a new access token for muddy.it see here :

stakeventures.com/articles/2008/02/23/developing-oauth-clients-in-ruby

See the ‘Authorising clients using irb’ section for a sample irb session.

These details are then used to provide access to the service. The credentials can be stored in a yml file, an example of which is provided below.

Example muddyit.yml

---
consumer_key: "YOUR_CONSUMER_KEY"
consumer_secret: "YOUR_CONSUMER_SECRET"
access_token: "YOUR_ACCESS_TOKEN"
access_token_secret: "YOUR_ACCESS_TOKEN_SECRET"

Retrieving a site

require 'muddyit_fu'
muddyit = Muddyit.new('muddyit.yml')
muddyit.sites.each do |site|
  puts "#{site.label} : #{site.token}"
end

Categorisation request

require 'muddyit_fu'
muddyit = Muddyit.new('muddyit.yml')
site = muddyit.sites.first
site.pages.categorise({:identifier => 'http://news.bbc.co.uk/1/hi/uk_politics/8011321.stm'}, {:minium_confidence => 0.2})

View categorised pages

require 'muddyit_fu'
muddyit =  Muddyit.new(:consumer_key => 'aaa',
                       :consumer_secret => 'bbb',
                       :access_token => 'ccc',
                       :access_token_secret => 'ddd')
site = muddyit.sites.first
site.pages.index do |page|
  puts page.title
  page.results.each do |result|
    puts result.uri
  end
end

View all pages containing ‘Gordon Brown’

require 'muddyit_fu'
muddyit = Muddyit.new('muddyit.yml')
site = muddyit.sites.first
site.pages.find_by_entity('http://dbpedia.org/resource/Gordon_Brown') do |page|
  puts page.identifier
end

require 'muddyit_fu'
muddyit = Muddyit.new('muddyit.yml')
site = muddyit.sites.first
site.entities.related('http://dbpedia.org/resource/Gordon_Brown').each do |entity|
  puts "#{entity.uri} : #{entity.confidence}"
end

require 'muddyit_fu'
muddyit = Muddyit.new('muddyit.yml')
site = muddyit.sites.first
page = site.pages.find('http://news.bbc.co.uk/1/hi/uk_politics/7878418.stm')
puts "Our page : #{page.title}\n\n"
page.related_content.each do |results|
  puts "#{results[:page].title} #{results[:count]}"
end

Authorising clients using irb

See gist.github.com/178993 for details on how to obtain access credentials.

Contact

Author: Rob Lee
Email: robl [at] monkeyhelper.com
Main Repository: http://github.com/monkeyhelper/muddyit_fu/tree/master