Easy way to retrieve Google Page Rank, Alexa Rank, index counts, and backlink counts
Easy way to retrieve Google Page Rank, Alexa Rank, index counts, and backlink counts
Provides an easy way to retrieve Google Page Rank, Alexa Rank, backlink counts, index counts and different types of social signals.
This project is abandoned. If you'd like to take ownership of this project, let me know.
Note: Version ~> 2.0 and ~> 3.0 used typheous internally which caused memory leak issues and failures on windows. 4.0.0 changes the implementation to use a Net::HTTP based library for better compatability.
Note: Version >= 4.1.0 no longer actively maintains compatibility with Ruby 1.8.X. It will probably still work for the time being.
_Note: Version >= 4.2.0 no longer actively maintains compatibility with Ruby = 4.5.0 no longer actively maintains compatibility with Ruby {:google=>161000, :bing=>208000000} PageRankr.backlinks('www.google.com', :yahoo) #=> {:yahoo=>256300062}
If you don't specify a search engine, then all of them are used.
``` ruby
# this
PageRankr.backlinks('www.google.com')
#=> {:google=>23000, :bing=>215000000, :yahoo=>250522337, :alexa=>727036}
# is equivalent to
PageRankr.backlinks('www.google.com', :google, :bing, :yahoo, :alexa)
#=> {:google=>23000, :bing=>215000000, :yahoo=>250522337, :alexa=>727036}You can also use the alias backlink instead of backlinks.
Valid search engines are: :google, :bing, :yahoo, :alexa (altavista and alltheweb now redirect to yahoo). To get this list you can do:
PageRankr.backlink_trackers #=> [:alexa, :bing, :google, :yahoo]Indexes are the result of doing a search with a query like "site:www.google.com". The number of returned results indicates how many pages of a domain are indexed by a particular search engine. If the site is not indexed nil is returned.
PageRankr.indexes('www.google.com', :google) #=> {:google=>4860000}
PageRankr.indexes('www.google.com', :bing) #=> {:bing=>2120000}If you don't specify a search engine, then all of them are used.
# this
PageRankr.indexes('www.google.com')
#=> {:bing=>2120000, :google=>4860000, :yahoo => 4863000}
# is equivalent to
PageRankr.indexes('www.google.com', :google, :bing, :yahoo)
#=> {:bing=>2120000, :google=>4860000, :yahoo => 4863000}You can also use the alias index instead of indexes.
Valid search engines are: :google, :bing, :yahoo. To get this list you can do:
PageRankr.index_trackers #=> [:bing, :google, :yahoo]Ranks are ratings assigned to specify how popular a site is. The most famous example of this is the google page rank.
PageRankr.ranks('www.google.com', :google) #=> {:google=>10}If you don't specify a rank provider, then all of them are used.
PageRankr.ranks('www.google.com', :alexa_us, :alexa_global, :google, :moz_rank, :page_authority)
#=> {:alexa_us=>1, :alexa_global=>1, :alexa_country=>1, :google=>10, :moz_rank => 8, :page_authority => 97}
# this also gives the same result
PageRankr.ranks('www.google.com')
#=> {:alexa_us=>1, :alexa_global=>1, :alexa_country=>1, :google=>9, :moz_rank=>8, :domain_authority=>100, :page_authority=>96}You can also use the alias rank instead of ranks.
Valid rank trackers are: :alexa_country, :alexa_global, :alexa_us, :google, :moz_rank, :page_authority. To get this you can do:
PageRankr.rank_trackers #=> [:alexa_us, :alexa_global, :alexa_country, :google, :moz_rank, :domain_authority, :page_authority]Alexa ranks are descending where 1 is the most popular. Google page ranks are in the range 0-10 where 10 is the most popular. If a site is unindexed then the rank will be nil.
Social signals are a somewhat oversimplified way of telling how popular a site or page currently is.
PageRankr.socials('www.google.com', :linked_in) #=> {:linked_in=>1001}If you don't specify a social tracker, then all of them are used.
PageRankr.socials('www.google.com', :google, :linked_in, :pinterest, :stumbled_upon, :twitter, :vk)
#=> {:google=>10000, :linked_in=>1001, :pinterest=>75108, :stumple_upon=>255078, :twitter=>21933764, :vk=>3725}
# this also gives the same result
PageRankr.socials('www.google.com')
#=> {:google=>10000, :linked_in=>1001, :pinterest=>75108, :stumble_upon=>255078, :twitter=>21933764, :vk=>3725}Valid social trackers are: :google, :linked_in, :pinterest, :stumble_upon, :twitter, :vk. To get this you can do:
PageRankr.social_trackers #=> [:google, :linked_in, :pinterest, :stumble_upon, :twitter, :vk]From versions >= 3, everything should be usable in a much more a la carte manner. If all you care about is google page rank (which I speculate is common) you can get that all by itself:
require 'page_rankr/ranks/google'
tracker = PageRankr::Ranks::Google.new("myawesomesite.com")
tracker.run #=> 2Also, once a tracker has run three values will be accessible from it:
# The value extracted. Tracked is aliased to rank for PageRankr::Ranks, backlink for PageRankr::Backlinks, and index for PageRankr::Indexes.
tracker.tracked #=> 2
# The value extracted with the jsonpath, xpath, or regex before being cleaned.
tracker.raw #=> "2"
# The body of the response
tracker.body #=> "..."
…
ruby
PageRankr.proxy_service = PageRankr::ProxyServices::Random.new([
'http://user:[email protected]:50501',
'http://user:[email protected]:50501'
])
…
ruby
module PageRankr
class Backlinks
class Bing
def xpath
"//my/new/awesome/@xpath"
end
end
end
endIf you ever come across a site that provides a rank or backlinks you can hook that class up to automatically be use with PageRankr. PageRankr does this by looking up all the classes namespaced under Backlinks, Indexes, and Ranks.
require 'page_rankr/backlink'
module PageRankr
class Backlinks
class Foo
include Backlink
# This method is required
def url
"http://example.com/"
end
# This method specifies the parameters for the url. It is optional, but likely required for the class to be useful.
def params
{:q => tracked_url}
end
# You can use a method named either xpath, jsonpath, or regex with the appropriate query type
def xpath
"//backlinks/text()"
end
# Optionally, you could override the clean method if the current implementation isn't sufficient
# def clean(backlink_count)
# #do some of my own cleaning
# super(backlink_count) # strips non-digits and converts it to an integer or nil
# end
end
end
end
PageRankr::Backlinks::Foo.new("myawesomesite.com").run #=> 3
PageRankr.backlinks("myawesomesite.com", :foo)[:foo] #=> 3Then, just make sure you require the class and PageRankr and whenever you call PageRankr.backlinks it'll be able to use your class.
Gotta give credit where credits due!
Original inspiration from:
Copyright (c) 2010 Allen Madsen. See LICENSE for details.
No open issues yet, or sync has not completed.