rss

name	rss
description	RSS feed discovery, preview, and RSSHub management. Use when user mentions RSS, feed, RSSHub, subscribing to blogs, or discovering feeds. Triggers on "rss", "feed", "訂閱", "RSS", "RSSHub", "rss-discover".
user_invocable	true
version	1.0.0
scope	public

RSS Feed Discovery & Management

Manage RSS feeds through a local RSSHub instance and the rss CLI tool.

Environment

• RSSHub: http://localhost:1200 (Docker at /Users/panda/site/projects/RSSHub)
• CLI: rss command at ~/.local/bin/rss

Available Operations

1. Discover RSS feeds for a website

When the user provides a URL they want to subscribe to:

rss <url>

Automatically detects HTML <link> tags and common paths, and searches RSSHub for matching routes.

2. Preview feed content

rss preview <feed_url_or_rsshub_path>
rss preview /hackernews/best
rss preview https://simonwillison.net/atom/everything/

3. Search RSSHub routes

rss routes <keyword>
rss routes twitter
rss routes telegram
rss routes bilibili

4. Test RSSHub route

rss test <rsshub_path>
rss test /36kr/newsflashes

5. Service management

rss status    # Check if RSSHub is running
rss up        # Start
rss down      # Stop
rss logs      # View logs

Workflow

Before any rss CLI call: If the user mentions feeds aren't loading, or any command returns a connection error, run rss status first. If RSSHub is not running, run rss up before retrying. RSSHub requires Docker.

When the user says "I want to subscribe to this blog" or pastes a URL:

1. Use rss <url> to find the RSS feed
2. Use rss preview <feed> to confirm the content is correct
3. Tell the user they can add the feed URL to their RSS reader or the n8n -> Telegram pipeline

When the user asks "Does RSSHub support X":

1. Use rss routes <keyword> to search
2. Use rss test <path> to verify the route works
3. Provide RSSHub docs link

Verified RSSHub Routes

Route	Status
/hackernews/best	OK
/telegram/channel/{name}	OK
/youtube/channel/{id}	OK
/36kr/newsflashes	OK
/zhihu/hot	OK
/github/repos/{user}	OK
/twitter/user/{id}	Requires auth token
/reddit/subreddit/{name}	Requires API credentials
/weibo/hot	Requires cookie
/bilibili/ranking/...	Requires cookie

Notes

• RSSHub runs on Docker; make sure Docker is started
• Some routes require additional environment variables (API keys, cookies), configured in the environment section of docker-compose.yml