Skip to main content

RSS Reader Role

The RSS Reader role turns your bot into a feed monitor. It periodically checks RSS/Atom feeds and sends new articles to subscribers — optionally filtered by keywords.

How it works​

When the RSS Reader role is assigned to a bot, two feed modes are available:

Default feed mode​

The bot owner configures one or more feeds in the dashboard. All subscribers receive updates from these feeds. Users just need to /subscribe to start getting articles.

User-managed feeds​

Users can add their own feeds with /addfeed. Each user manages their own list of feeds independently. This is useful when you want to let users track their own sources.

Subscriptions​

  • Users send /subscribe to start receiving feed updates
  • /unsubscribe stops updates
  • Subscribed users receive new articles as they're detected on each scheduled check

Keyword matching​

Subscribers can filter articles using /setkeywords. Only articles matching the keywords will be delivered.

Keyword targets:

  • title: — match against the article title
  • content: — match against the article body
  • If no target is specified, the keyword is matched against both title and content

Match modes:

  • match:any — article is sent if any keyword matches (default)
  • match:all — article is sent only if all keywords match

Matching is case-insensitive.

Examples​

/setkeywords title:RELEASE match:any
/setkeywords title:python content:tutorial match:all
/setkeywords breaking news

See the full RSS Reader commands reference for all options.

Scheduling​

Feeds are checked on a configurable interval. The default is every 60 minutes. Users can adjust their personal schedule with /reschedulefeed.

The platform deduplicates articles so you never receive the same item twice, even if it stays in the feed across multiple checks.