Agentic RSS Parser

Why it exists

rss-parser hasn't received a security update since 2022, yet it remains widely used across production agent pipelines. Agentic RSS Parser is a from-scratch rebuild that keeps the API you already know while closing the supply-chain gap — zero runtime dependencies, a custom XML engine, and native LLM adapters built directly on fetch().

Migrate in one line

All existing parseURL, parseString, parseFile, customFields, headers, timeout, and callback-style usage is preserved exactly. The agentic pipeline is an optional layer on top.

// Before
import Parser from 'rss-parser';

// After — zero other changes needed
import Parser from 'agentic-rss-parser';

Core features

• RSS 2.0 & Atom — namespaces, CDATA, HTML entities, dc:creator, media:content, content:encoded
• Drop-in compatibility — parseURL, parseString, parseFile, customFields, callback and promise styles
• Heuristic analysis — signal-based relevance scoring, no API key needed, fully configurable via signals, extraSignals, and threshold
• LLM analysis — OpenAI, Anthropic, and local (Ollama) providers via native fetch()
• Article enrichment — fetches and strips full article body from feed item URLs
• MCP server — stdio JSON-RPC 2.0 server exposing fetch_rss_feed and fetch_full_article, compatible with Claude Desktop, Cursor, VS Code, and any MCP host
• SQLite deduplication — items are SHA-256 deduplicated across runs
• SDK integrations — ready-to-use examples for Anthropic SDK, OpenAI Agents SDK, Vercel AI SDK, LangChain, and Google ADK
• userAgent override — avoid 403s on feeds that block bot user-agents (Reddit, HN, Lobste.rs)

Quick start

npm install agentic-rss-parser

import Parser from 'agentic-rss-parser';

const parser = new Parser({ timeout: 10000 });
const feed = await parser.parseURL('https://news.ycombinator.com/rss');

for (const item of feed.items) {
  console.log(`- ${item.title} — ${item.link}`);
}

Agentic pipeline

Run the full fetch → parse → deduplicate → analyse pipeline with zero API key required, using the built-in heuristic engine:

import { runAgenticParser } from 'agentic-rss-parser';

const { results, feedErrors } = await runAgenticParser({
  feedUrls: ['https://news.ycombinator.com/rss'],
  dbPath: './data/rss-agent.db'
});

for (const { item, analysis } of results) {
  if (analysis.decision === 'relevant') {
    console.log(`[${analysis.confidence}%] ${item.title}`);
  }
}

Requirements

• Node.js ≥ 22.5.0 (required for node:sqlite)
• ESM-only package
• Linux, macOS, Windows