docs

RSS Feed Node

The RSS Feed node fetches and parses articles from RSS or Atom feeds. Pick from a curated catalog of 26 trusted sources (crypto, macro, equities, geopolitics, tech), or paste any custom RSS/Atom URL — with optional Basic Auth for protected feeds.

RSS Feed
https://feeds.example.com/news

Configuration

General

Give this node a custom name to identify it in your workflow

Continue workflow if this node fails

Feed Source

Pick from a curated catalog or paste any RSS/Atom URL

Pick one or more feeds from the catalog (see list below)

Supports RSS 2.0, RSS 1.0, and Atom feeds

Authentication

Optional Basic Auth credentials for protected feeds (custom mode only)

Options

Configuration

The node has two modes: Catalog for one-click multi-source aggregation from a curated set of trusted feeds, or Custom URL for any RSS/Atom URL with optional Basic Auth.

FieldDescription
Modecatalog to pick from the curated feed catalog (multi-select), or custom for a single feed URL. Default: custom.
Selected Feeds (catalog)One or more feed IDs from the catalog (see list below). Articles from all selected feeds are merged and sorted by publish date (newest first).
Feed URL (custom)The URL of the RSS or Atom feed to fetch. Supports RSS 2.0, RSS 1.0, and Atom formats. The https:// prefix is added automatically if you omit it — paste either example.com/feed.xml or https://example.com/feed.xml. Supports the f(x) toggle for dynamic URLs.
Credential (custom only)Optional Basic Auth credential for password-protected feeds. Select None for public feeds. Create a Basic Auth credential with your username and password in Credentials.
Max ItemsMaximum number of feed items to return. Range: 1--50. Default: 10. In catalog mode this cap is applied per feed before merging.
Strip HTMLWhen enabled, removes HTML tags from description and content fields. Some feeds (e.g. CoinTelegraph, Chainalysis, Bitcoin Magazine) embed raw HTML; turn this on when downstream nodes need plain text. Default: off.
Most RSS feeds are public and don't require authentication. Only set a credential if the feed returns a 401 or 403 error without one.
Billing: 1 credit per feed fetched. A custom-mode run costs 1 credit; a catalog run with 5 selected feeds costs 5 credits.

Feed Catalog

The catalog ships 26 curated feeds across six categories. In catalog mode, pick any combination — articles from all selected feeds are aggregated and sorted by publish date (newest first), with each article tagged with its sourceId, sourceName, and sourceUrl.

Crypto News

IDSourceNotes
coindeskCoinDeskUpdated hourly. Sub-feeds for markets, policy, tech.
cointelegraphCoinTelegraphSub-feeds by tag (bitcoin, defi, regulation).
decryptDecryptStrong prediction market and DeFi/AI coverage.
the-blockThe BlockFull article content. Institutional deal flow.
bitcoin-magazineBitcoin MagazineFull content. BTC-only perspective.

On-chain / DeFi Analytics

IDSourceNotes
glassnodeGlassnode InsightsTrue Market Mean, STH cost basis, ETF flows.
the-defiantThe DefiantDeFi governance, exploits, yield. High item count.
rekt-newsRekt NewsExploit postmortems. Critical risk signal.
chainalysisChainalysis BlogCompliance, sanctions, illicit flows.

Macro / Central Banks

IDSourceNotes
fed-pressFederal Reserve PressFOMC, speeches, enforcement.
ecb-pressECB PressECB monetary policy, Lagarde speeches.

Equity / Markets / Financial News

IDSourceNotes
cnbc-topCNBC Top NewsMarket headlines, updated every few minutes.
cnbc-earningsCNBC EarningsEPS, guidance, earnings surprises.
cnbc-economyCNBC EconomyGDP, jobs, inflation, Fed commentary.
cnbc-marketsCNBC MarketsMarket overview, sector moves.
marketwatchMarketWatch Top StoriesDow Jones publisher. Market analysis.
seeking-alphaSeeking AlphaCrowd-sourced analysis, ticker-specific feeds.
investing-comInvesting.comForex, commodities, bonds, equities.
yahoo-financeYahoo FinanceBroad aggregated news. High volume.

Geopolitics / International Politics

IDSourceNotes
foreign-affairsForeign AffairsCouncil on Foreign Relations. Deep analysis.
the-diplomatThe DiplomatAsia-Pacific: China/Taiwan, trade, security.
war-on-the-rocksWar on the RocksDefense, national security, conflict analysis.

Tech / AI

IDSourceNotes
techcrunchTechCrunchStartup funding, tech M&A, AI developments.
ars-technicaArs TechnicaFull content. Deep tech analysis, AI, science.
hacker-newsHacker NewsTitle + link only. Tech sentiment proxy.
the-vergeThe VergeFull content. Consumer tech, AI narrative.
Need a source that isn't in the catalog? Switch to Custom URL mode and paste any RSS or Atom feed URL.

Dynamic Feed URL

The Feed URL field supports the f(x) toggle. Click the f(x) button to switch from a static URL to an expression that resolves at runtime:

{my_function.feedUrl}

This is useful when you want to select a feed dynamically — for example, choosing between multiple news sources based on an upstream condition.

Setting Up Basic Auth

If your feed requires authentication, follow these steps:

Step 1: Create a Basic Auth Credential

  1. Go to Credentials in NickAI.
  2. Click Add Credential and select Basic Auth.
  3. Enter the Username and Password for the feed.
  4. Give the credential a name (e.g., "Company News Feed Auth").
  5. Click Save. The password is encrypted at rest.

Step 2: Select the Credential in the Node

  1. Open your workflow and select the RSS Feed node.
  2. In the Authentication section, select the credential you just created.
  3. The node will send an Authorization: Basic <encoded> header with each request.
Never paste credentials directly into the Feed URL. Always use the credential picker so your username and password are encrypted and never exposed in workflow definitions or shared workflows.

Template Interpolation

Use curly braces to inject live data from upstream nodes into the Feed URL field.

Dynamic Feed URL Example

https://feeds.example.com/{workflow.feedCategory}/rss.xml

Using Feed Data Downstream

Once the RSS Feed node runs, downstream nodes can access the articles via interpolation:

Latest headline: {rss_feed.articles[0].title}
Published: {rss_feed.articles[0].pubDate}
Link: {rss_feed.articles[0].link}
Replace rss_feed with your node's edge label. If the edge connecting this node to the next is labeled news, use {news.articles[0].title}.

Workflow Examples

News-Driven Trading Signal (Catalog Mode)

Aggregate multiple crypto news sources from the catalog, analyze sentiment with an LLM, and execute a trade if the signal is strong:

Crypto News
coindesk + the-block + decrypt
Sentiment Analysis
Claude Sonnet 4.6
Bullish Signal?
sentiment > 0.7
Buy BTC
Alpaca

In this workflow:

  1. RSS Feed (catalog mode) fetches and merges articles from coindesk, the-block, and decrypt — sorted newest first.
  2. LLM analyzes the headlines and descriptions for market sentiment. Enable Strip HTML so the LLM sees plain text.
  3. Conditional checks if the sentiment score exceeds the threshold.
  4. Exchange places a buy order when the signal is bullish.

News Digest with Notification

Aggregate macro and equity news from the catalog and send a daily summary to Telegram:

Macro + Markets
fed-press + cnbc-markets + marketwatch
Summarize
Claude Sonnet 4.6
Daily Digest
Markdown

Output

After execution, the node produces the following data that downstream nodes can reference:

PathDescription
{rss_feed.articles}Array of feed items, sorted by pubDate newest-first. In catalog mode, articles from all selected feeds are merged into this single array.
{rss_feed.articles[0].title}Title of the first article.
{rss_feed.articles[0].link}URL of the first article.
{rss_feed.articles[0].pubDate}Publication date as an ISO string.
{rss_feed.articles[0].description}Short summary or snippet of the article. (HTML stripped if Strip HTML is on.)
{rss_feed.articles[0].content}Full HTML content of the article (if provided by the feed). (HTML stripped if Strip HTML is on.)
{rss_feed.articles[0].author}Author name (if provided by the feed).
{rss_feed.articles[0].categories}Array of category/tag strings (if provided by the feed).
{rss_feed.articles[0].sourceId}Catalog feed ID this article came from (catalog mode only, e.g. coindesk).
{rss_feed.articles[0].sourceName}Display name of the source feed (catalog mode only, e.g. CoinDesk).
{rss_feed.articles[0].sourceUrl}URL of the source feed.
{rss_feed.metadata.feedTitle}Title of the feed (custom mode), or "N of M feeds" summary (catalog mode).
{rss_feed.metadata.feedDescription}Description of the feed (custom mode), or aggregation summary (catalog mode).
{rss_feed.metadata.feedUrl}The URL that was fetched (custom mode), or comma-separated successful feed URLs (catalog mode).
{rss_feed.metadata.itemCount}Total number of articles returned across all feeds.
{rss_feed.metadata.fetchedAt}ISO timestamp of when the feed was fetched.
{rss_feed.metadata.sources}Per-feed fetch status array (catalog mode). Each entry: { id, name, url, itemCount, ok, error } — useful for detecting partial failures.
Not all feeds provide every field. Fields like content, author, and categories depend on the feed publisher. The sourceId/sourceName fields are only set when articles come from the catalog. The node returns undefined for any missing fields.

Next Steps