Skip to main content

RSS & social feeds

An RSS Feed node turns a board from a snapshot into a watch. Every poll, new items become News Article nodes (or Social Post nodes for social feeds) connected to the feed, scraped, summarized and placed on the canvas. Filters decide what gets through.

Adding a feed

Press Shift+R or use the RSS Feed quick action, then in the editor:

  • Feed URL - paste any RSS or Atom URL. Most news sites have one (look for /feed, /rss, or the orange icon).
  • or Quick add social feed - pick a platform and type a name:
PlatformTypeBecomesNeeds
Redditgeopolitics (subreddit) or a username, with a subreddit/user togglereddit.com/r/…​.rss
YouTube@handle or channel IDThe channel's video feed (handle resolved automatically)
Blueskyname.bsky.socialThe account's posts via a public bridge
X / TwitterusernameThe account's postsA connected X account (Social media)

The assistant can also subscribe with create_rssfeed PRO.

Polling

SettingOptionsDefault
Refresh interval15 min, 30 min, 1 h, 2 h, 4 h, 12 h, 24 h1 h
Enabledon / offon
Initial itemshow many existing items to import on the first poll5

DeepState checks every five minutes for feeds that are due and polls them. The first poll imports only the most recent Initial items; everything older is remembered as seen so it never floods in later. Refresh feed on the card polls immediately.

The card shows last polled, next poll, totals fetched and filtered, and a paused marker when disabled. Consecutive failures are counted and the last error displayed; a feed is never disabled automatically, so a temporary outage recovers on its own.

Shared boards

On a board that is synced between devices, only the device that created a feed polls it. Everyone else receives the articles through sync, so nothing is fetched twice and the feed's author controls it.

Filtering

Filters run in this order; an item must pass all of them.

  1. Keyword filters. Include keywords (item must match at least one) and exclude keywords (item must match none), matched case-insensitively against title and description. Free and instant.
  2. AI relevance filter. When enabled, each surviving item is scored against the board by the summarizer model. Set the threshold (0-1, default 0.5) and, optionally, custom instructions - "focus on litigation and executive departures; ignore product launches". Filtered items are recorded so they are not scored again.

A busy general feed with a good relevance prompt is often more useful than a narrow one: you get the unexpected item that a keyword list would have missed.

Placement

Article placement controls where new nodes land relative to the feed node: spread (fan out around it), stack down or stack right. Auto-layout treats a feed and its articles as a unit and arranges them as a grid.

What a feed item becomes

  • News feeds → a News Article node with the link preview, then the full scraped article and its AI summary a few seconds later. The article's own publish date puts it on the timeline.
  • Social feeds (Reddit, YouTube, Bluesky, X) → a Social Post node fetched from the platform, with media archived.
  • Every item is connected to its feed with a sources connection so you can see where it came from and delete a feed's output in one selection.

Managing feeds

  • Pause a feed by turning Enabled off; its articles stay.
  • Delete the feed node to stop it for good. Its articles are ordinary nodes and remain unless you delete them too.
  • Feeds are synced to collaborators like any node, but only the creator's device polls them.
  • A board with many feeds and relevance filtering makes many small summarizer calls; on the DeepState AI budget keep an eye on usage.

Troubleshooting

  • "Feed URL is not valid RSS" - the URL is an HTML page. Find the feed link on the site, or paste the page URL into a News Article node instead.
  • Nothing arriving from a social quick-add - for X, check the account is connected in Settings; for YouTube, use the exact @handle from the channel URL, not the display name.
  • Too much arriving - lower Initial items for new feeds, add exclude keywords, or enable the relevance filter with a threshold around 0.6-0.7.
  • Articles arrive but never get text - the site blocks headless browsers; you keep the preview and summary of the feed excerpt. See Enrichment.