NAME

SYNOPSIS

 use WWW::Google::PageRank;
 my $pr = WWW::Google::PageRank->new;
 print scalar($pr->get('http://www.yahoo.com/')), "\n";

DESCRIPTION

To use it, you should create "WWW::Google::PageRank" object and use its method get(), to query page rank of URL.

It uses "LWP::UserAgent" for making request to Google.

CONSTRUCTOR METHOD

$gpr = WWW::Google::PageRank->new(%options);

This method constructs a new "WWW::Google::PageRank" object and returns it. Key/value pair arguments may be provided to set up the initial state. The following options correspond to attribute methods described below:

   KEY                     DEFAULT
   -----------             --------------------
   agent                   "Mozilla/4.0 (compatible; GoogleToolbar 2.0.111-big; Windows XP 5.1)"
   proxy                   undef
   timeout                 undef
   env_proxy               undef
   host                    "toolbarqueries.google.com"
    

"agent" specifies the header 'User-Agent' when querying Google. If the "proxy" option is passed in, requests will be made through specified poxy. "proxy" is the host which serve requests from Googlebar.

If the "env_proxy" option is passed in with a TRUE value, then proxy settings are read from environment variables (see "LWP::UserAgent::env_proxy")

QUERY METHOD

$pr = $gpr->get('http://www.yahoo.com');

Queries Google for a specified pagerank URL and returns pagerank. If query successfull, integer value from 0 to 10 returned. If query fails for some reason (google unreachable, url does not begin from 'http://', undefined url passed) it return "undef".

In list context this function returns list from two elements where first is the result as in scalar context and the second is the "HTTP::Response" object (returned by "LWP::UserAgent::get"). This can be usefull for debugging purposes and for querying failure details.

BUGS

AUTHOR

Algorithm of computing checksum taken from mozilla module pagerankstatus http://pagerankstatus.mozdev.org by Stephane Queraud <squeraud@toteme.com>.

Algorithm was modified (15-09-2004) according to new algorithm of computingchecksum in googlebar.

COPYRIGHT

You may use, modify, and distribute this package under the same terms as Perl itself.