@robinpath/rss

Parse RSS and Atom feeds, detect new entries, and get feed metadata

Why use this module?

The rss module lets you:

• Parse an RSS/Atom feed from a URL
• Parse RSS/Atom XML from a string
• Get feed items with a limit
• Get only new items since last check or since a date
• Get the most recent item from a feed

All functions are callable directly from RobinPath scripts with a simple, consistent API.

Installation

npm install @robinpath/rss

Quick Start

No credentials needed — start using it right away:

rss.parseString $xmlContent

Available Functions

Function	Description
rss.parse	Parse an RSS/Atom feed from a URL
rss.parseString	Parse RSS/Atom XML from a string
rss.getItems	Get feed items with a limit
rss.getNew	Get only new items since last check or since a date
rss.getLatest	Get the most recent item from a feed
rss.feedInfo	Get feed metadata without items

Examples

Parse RSS/Atom XML from a string

rss.parseString $xmlContent

Get feed items with a limit

rss.getItems "https://blog.example.com/feed" 5

Get only new items since last check or since a date

rss.getNew "https://blog.example.com/feed" "2025-01-01"

Integration with RobinPath

import { RobinPath } from "@wiredwp/robinpath";
import Module from "@robinpath/rss";

const rp = new RobinPath();
rp.registerModule(Module.name, Module.functions);
rp.registerModuleMeta(Module.name, Module.functionMetadata);

const result = await rp.executeScript(`
  rss.parseString $xmlContent
`);

Full API Reference

See MODULE.md for complete documentation including all parameters, return types, error handling, and advanced examples.

Related Modules

• @robinpath/json — JSON module for complementary functionality

License

MIT