lobsters-rss

RSS feed server for lobste.rs. Fetches top posts, extracts full article content, and serves an RSS 2.0 feed.

What it does

• Periodically fetches posts from lobste.rs filtered by minimum score
• Extracts full article content from linked URLs
• Stores posts, comments, and extracted content in SQLite
• Serves an RSS 2.0 feed with article content and top comments

Setup

cp .env.example .env
npm install
npm run dev

Docker

docker compose up -d

Environment variables

Variable	Default	Description
PORT	3000	HTTP port
MIN_SCORE	20	Minimum post score to include
FETCH_INTERVAL	90	Fetch interval in minutes
LOOKBACK_DAYS	7	How far back to fetch posts
RETENTION_DAYS	14	How long to keep posts in DB
DB_PATH	./data/lobsters.db	SQLite database path
SERVER_URL		Base URL (used in feed metadata)

Endpoints

• GET /rss — RSS 2.0 feed
• GET /health — health check