NAME
   WWW::OpenSearch - Search A9 OpenSearch compatible engines

SYNOPSIS
       use WWW::OpenSearch;

       my $url = "http://bulkfeeds.net/opensearch.xml";
       my $engine = WWW::OpenSearch->new($url);

       my $name = $engine->description->ShortName;
       my $tags = $engine->description->Tags;

       # Perform search for "iPod"
       my $response = $engine->search("iPod");
       for my $item (@{$response->feed->items}) {
           print $item->{description};
       }

       # Retrieve the next page of results
       my $next_page = $response->next_page;
       for my $item (@{$next_page->feed->items}) {
           print $item->{description};
       }

DESCRIPTION
   WWW::OpenSearch is a module to search A9's OpenSearch compatible search
   engines. See http://opensearch.a9.com/ for details.

CONSTRUCTOR
 new( $url )
   Constructs a new instance of WWW::OpenSearch using the given URL as the
   location of the engine's OpenSearch Description document (retrievable
   via the description_url accessor).

METHODS
 fetch_description( [ $url ] )
   Fetches the OpenSearch Descsription found either at the given URL or at
   the URL specified by the description_url accessor. Fetched description
   may be accessed via the description accessor.

 search( $query [, \%params] )
   Searches the engine for the given query using the given search
   parameters. Valid search parameters include:

   *   startPage

   *   totalResults

   *   startIndex

   *   itemsPerPage

   See http://opensearch.a9.com/spec/1.1/response/#elements for details.

 do_search( $url [, $method] )
   Performs a request for the given URL and returns a
   WWW::OpenSearch::Response object. Method defaults to 'GET'.

ACCESSORS
 description_url( [$description_url] )
 agent( [$agent] )
 description( [$description] )
AUTHOR
   Brian Cassidy <[email protected]>

   Tatsuhiko Miyagawa <[email protected]>

COPYRIGHT AND LICENSE
   Copyright 2005-2010 by Tatsuhiko Miyagawa and Brian Cassidy

   This library is free software; you can redistribute it and/or modify it
   under the same terms as Perl itself.