@radzor/rss-feed

Parse, generate, and watch RSS 2.0 and Atom feeds. Supports polling for new items, feed generation from structured data, and event-driven notifications when new content appears.

Data & Databasev0.1.0typescriptpythonServerrssatomfeedparsersyndicationpollingxmlby Radzor

Install

View source on GitHub →

$npx radzor@latest add rss-feed

⚠ Constraints: Uses native fetch (Node.js 18+). Parses RSS 2.0 and Atom feeds using basic XML parsing (no external XML library). Feed watching uses setInterval-based polling — not suitable for hundreds of concurrent watches.

Inputs

Name	Type	Default	Description
userAgent	string	RadzorRSSFeed/0.1	User-Agent header sent when fetching feeds.
defaultPollIntervalMs	number	300000	Default polling interval in milliseconds for watched feeds.
maxItems	number	100	Maximum number of items to return when parsing a feed.

userAgentstring

User-Agent header sent when fetching feeds.

default: RadzorRSSFeed/0.1

defaultPollIntervalMsnumber

Default polling interval in milliseconds for watched feeds.

default: 300000

maxItems

{ "llm": { "constraints": "Uses native fetch (Node.js 18+). Parses RSS 2.0 and Atom feeds using basic XML parsing (no external XML library). Feed watching uses setInterval-based polling — not suitable for hundreds of concurrent watches.", "usageExamples": "llm/examples.md", "integrationPrompt": "llm/integration.md" }, "name": "@radzor/rss-feed", "tags": [ "rss", "atom", "feed", "parser", "syndication", "polling", "xml" ], "events": [ { "name": "onNewItem", "payload": { "link": "string", "title": "string", "feedUrl": "string", "pubDate": "string" }, "description": "Fired when a watched feed has a new item that wasn't present in the previous poll." } ], "inputs": [ { "name": "userAgent", "type": "string", "default": "RadzorRSSFeed/0.1", "required": false, "description": "User-Agent header sent when fetching feeds." }, { "name": "defaultPollIntervalMs", "type": "number", "default": 300000, "required": false, "description": "Default polling interval in milliseconds for watched feeds." }, { "name": "maxItems", "type": "number", "default": 100, "required": false, "description": "Maximum number of items to return when parsing a feed." } ], "radzor": "1.0.0", "actions": [ { "name": "parse", "params": [ { "name": "urlOrXml", "type": "string", "description": "A feed URL to fetch, or raw XML/Atom string to parse." } ], "returns": "Promise<FeedData>", "description": "Parse an RSS/Atom feed from a URL or raw XML string." }, { "name": "generate", "params": [ { "name": "options", "type": "GenerateFeedOptions", "description": "Feed metadata and items for generating an RSS 2.0 XML string." } ], "returns": "string", "description": "Generate an RSS 2.0 XML feed from structured data." }, { "name": "watch", "params": [ { "name": "url", "type": "string", "description": "The feed URL to watch." }, { "name": "intervalMs", "type": "number", "required": false, "description": "Poll interval in milliseconds. Defaults to defaultPollIntervalMs." } ], "returns": "void", "description": "Start polling a feed URL for new items. New items trigger onNewItem events." }, { "name": "unwatch", "params": [ { "name": "url", "type": "string", "description": "The feed URL to stop watching." } ], "returns": "boolean", "description": "Stop watching a feed URL. Returns true if the feed was being watched." } ], "outputs": [ { "name": "feedData", "type": "FeedData", "fields": [ { "name": "title", "type": "string", "description": "The feed title." }, { "name": "items", "type": "Array<{ title: string; link: string; description?: string; pubDate?: string; guid?: string; author?: string }>", "description": "The feed items/entries." }, { "name": "lastUpdated", "type": "string", "description": "ISO 8601 timestamp of the last feed update." }, { "name": "feedUrl", "type": "string", "description": "The URL the feed was fetched from." }, { "name": "feedType", "type": "string", "description": "Detected feed type: 'rss' or 'atom'." } ], "description": "Parsed feed data including metadata and items." } ], "runtime": "server", "version": "0.1.0", "category": "data", "languages": [ "typescript", "python" ], "description": "Parse, generate, and watch RSS 2.0 and Atom feeds. Supports polling for new items, feed generation from structured data, and event-driven notifications when new content appears.", "dependencies": { "radzor": [], "packages": {} }, "composability": { "connectsTo": [ { "output": "feedData", "mapField": "title", "compatibleWith": [ "@radzor/json-transform.action.transform.data", "@radzor/embeddings-store.action.add.text", "@radzor/search-index.action.index.documents" ] }, { "event": "onNewItem", "description": "Process new RSS items through AI or notify channels", "compatibleWith": [ "@radzor/llm-completion.action.complete.prompt", "@radzor/slack-bot.action.sendMessage.text", "@radzor/notification-hub.action.send.body" ] } ] } }

@radzor/rss-feed

Install

Inputs

Outputs

Actions

Events

Composability

radzor.manifest.json