NAME

Feed::Find - Syndication feed auto-discovery

SYNOPSIS

use Feed::Find;
my @feeds = Feed::Find->find('http://example.com/');

DESCRIPTION

Feed::Find implements feed auto-discovery for finding syndication feeds, given a URI. It (currently) passes all of the auto-discovery tests at http://diveintomark.org/tests/client/autodiscovery/.

Feed::Find will discover the following feed formats:

  • RSS 0.91

  • RSS 1.0

  • RSS 2.0

  • Atom

USAGE

Feed::Find->find($uri)

Given a URI $uri, use a variety of techniques to find the feeds associated with that page.

Returns a list of feed URIs.

The following techniques are used:

1. <link> tag auto-discovery

If the page contains any <link> tags in the <head> section, these tags are examined for recognized feed content types. The following content types are treated as feeds: application/x.atom+xml, application/atom+xml, text/xml, application/rss+xml, and application/rdf+xml.

2. Scanning <a> tags

If the page does not contain any known <link> tags, the page is then scanned for <a> tags for links to URIs with certain file extensions. The following extensions are treated as feeds: .rss, .xml, and .rdf.

Note that this technique is employed only if the first technique returns no results.

LICENSE

Feed::Find is free software; you may redistribute it and/or modify it under the same terms as Perl itself.

AUTHOR & COPYRIGHT

Except where otherwise noted, Feed::Find is Copyright 2004 Benjamin Trott, cpan@stupidfool.org. All rights reserved.