Help Topics

Bot RSS Capability

The RSS capability monitors RSS and Atom feeds and automatically posts new items to designated channels.

Commands

Command Description
!Bot rss add <url> <#channel> Add an RSS/Atom feed
!Bot rss list List all configured feeds
!Bot rss remove <id> Remove a feed by ID
!Bot rss check <id> Force-check a feed immediately

How It Works

  • Feeds are polled at a configurable interval (default: every 30 minutes)
  • Only new items since the last check are posted
  • Uses HTTP conditional requests (ETag/Last-Modified) for efficiency
  • Feed titles are auto-detected from the feed metadata
  • Items are posted in the format: [Feed Title] Item Title — Link

Configuration

Admins can configure via /bot set:

  • rss_interval — Poll interval in minutes (default: 30)
  • rss_max_feeds — Maximum feeds per bot (default: 5)
  • rss_max_items — Maximum items posted per poll (default: 3)

Examples 

!MyBot rss add https://blog.example.com/feed.xml #news
!MyBot rss add https://example.com/rss news
!MyBot rss list
!MyBot rss check f1a2b3
!MyBot rss remove f1a2b3

Notes

  • URLs must start with http:// or https://
  • The # prefix on channel names is added automatically if missing
  • Polling timers automatically reschedule after each poll
  • Fetch errors are logged but do not stop future polls

See Also

BotService Overview · /bot Command Reference · Bot Scheduler