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 <bricas@cpan.org>

    Tatsuhiko Miyagawa <miyagawa@bulknews.net>

COPYRIGHT AND LICENSE
    Copyright 2008 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.

