RSS Finder

A modern web application to discover RSS feeds from any website. Powered by feedfinder-ts for reliable RSS feed detection.

Features

  • Robust Detection: Uses feedfinder-ts under the hood for comprehensive RSS feed discovery
  • Fast & Lightweight: Optimized for performance with minimal dependencies
  • Shareable Deep Links: Search results are reflected in the URL as a ?q= parameter, so you can link directly to a search (e.g. https://your-instance/?q=havo.co.id opens with the search already performed, like rssfinder.app)
  • Side Panel Preview: Clicking Preview on a search result opens an animated slide-in side panel showing the latest feed items — no page navigation required. The full-page view at /preview/<feed> remains available for direct links (also linked from the panel's Full page button)

Getting Started

1. Using Docker Image (Recommended)
docker run -d -p 3000:3000 --name rss-finder ghcr.io/0x2E/rss-finder:latest

Visit http://localhost:3000 to use the application.

2. Build from Source or Deploy to Cloud Services
  • Node.js 22+
  • pnpm
# Clone the repository
git clone <your-repo-url>
cd rss-finder

# Install dependencies
pnpm install

# Build for production
pnpm build

# or build for Node.js
pnpm build:node

Since this app is built with SvelteKit, it's compatible with multiple runtimes. Check the SvelteKit docs for platform-specific deployment instructions.

API

Find RSS Feeds

POST /api/find-feeds

{
	"url": "https://example.com"
}

Response:

{
	"feeds": [
		{
			"title": "Example Blog RSS",
			"url": "https://example.com/rss.xml",
			"type": "application/rss+xml"
		}
	]
}

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Test thoroughly
  5. Submit a pull request

License

MIT

Credits