RSSHub is a powerful, community-driven tool that converts non-RSS websites into standardized RSS feeds, allowing users to subscribe to content from platforms like TikTok, Instagram, Zhihu, and Spotify using any RSS reader. It solves the problem of content fragmentation by bringing siloed social media and news sites into the open, decentralized RSS ecosystem.
Built with TypeScript and Node.js, RSSHub supports over 5,000 routes across 100+ platforms and can be deployed via Docker, NPM, or cloud platforms like Cloudflare Workers. It integrates with tools like Folo (AI RSS reader), RSSHub Radar (browser extension), and mobile apps like RSSBud and RSSAid, forming a complete feed aggregation ecosystem.
What You Get
- 5,000+ Built-in Routes - Supports RSS feeds for TikTok, Bilibili, Douban, Instagram, Weibo, Zhihu, Spotify, Twitter, YouTube, Pixiv, Ximalaya, V2EX, and more — each route is maintained by the community.
- Browser Extension (RSSHub Radar) - Automatically detects RSS-unfriendly pages and generates one-click RSS links for subscription in any reader.
- Mobile-Optimized Readers - Compatible with RSSBud (iOS) and RSSAid (Android), enabling seamless feed consumption on mobile devices.
- Cloudflare Workers Deployment - Deploy lightweight, serverless RSSHub instances with zero maintenance using pre-built Cloudflare Workers templates.
- Real-time Analytics Dashboard - Live metrics on monthly requests (over 100M/month) and instance health via public analytics endpoints.
- Folo Integration - Seamlessly pairs with Folo, an AI-powered RSS reader for feed discovery, summarization, and modern reading workflows.
Common Use Cases
- Subscribing to TikTok creators without an account - A content curator uses RSSHub to follow TikTok profiles via RSS, avoiding platform lock-in and algorithmic feeds.
- Aggregating Chinese social media for research - A journalist subscribes to Weibo, Zhihu, and Douban feeds to monitor trending topics in Mandarin-speaking communities.
- Tracking Spotify playlists and new releases - A music enthusiast uses RSSHub to get notifications when new tracks are added to public playlists.
- Building a personal news dashboard - A developer combines RSS feeds from Twitter, GitHub, and V2EX into a custom reader using RSSHub and Folo.
Under The Hood
Architecture
- Modular route system where each RSS source is defined as an isolated Route object with explicit path, radar, handler, and feature flags, enabling independent development and testing
- Centralized middleware pipeline enforces cross-cutting concerns like caching, logging, and access control without polluting route logic
- Dependency inversion through abstracted utilities for caching, HTTP requests, and date parsing ensures stateless, testable route handlers
- Configuration-driven route activation with runtime validation prevents hardcoded secrets and enables dynamic feature toggles
- Containerized deployment decouples stateful operations (caching, API keys) from routing logic using Docker and serverless platforms
Tech Stack
- Node.js backend powered by Hono with Zod-OpenAPI for schema validation and Scalar for interactive API documentation
- TypeScript-first codebase with comprehensive tooling for type safety, bundling, and linting
- Redis for caching and session state, with optional Puppeteer integration via containerized browsers for dynamic content
- Multi-platform deployment support across Vercel, Fly.io, and Cloudflare Workers with platform-specific state management
- Observability stack with OpenTelemetry, Sentry, and Prometheus for metrics, tracing, and error monitoring
- Automated testing and CI/CD pipelines with containerization and route validation hooks
Code Quality
- Extensive test coverage spanning unit, integration, and end-to-end scenarios with robust mocking and environment simulation
- Custom error classes and centralized middleware ensure consistent diagnostics and structured logging across all routes
- Clean separation of concerns via modular middleware composition, allowing reusable layers for caching, auth, and logging
- Strong type safety enforced through interfaces and runtime validation, minimizing runtime failures
- Environment-driven configuration with dynamic feature flags enables safe testing and flexible deployment
- Consistent naming, mocking patterns, and dependency isolation in test files preserve real-world behavior while ensuring test reliability
What Makes It Unique
- Modular route system empowers community contributors to rapidly add RSS feeds for obscure or dynamic websites with minimal boilerplate
- Built-in radar system automatically maps arbitrary web pages to RSS routes, transforming any URL into a subscribable feed
- Sophisticated middleware handles anti-bot protections through header spoofing and caching, reducing reliance on heavy headless browsers
- Native OpenAPI 3.1 documentation auto-generated from route definitions, making it the only RSS aggregator with fully discoverable, programmatic APIs
- Lightweight, purpose-built utilities enable high-throughput scraping with low resource overhead, avoiding bloated frameworks
- Dynamic content extraction from SPAs and login-protected sites via cookie injection and browser-like headers, without full headless browser dependency