rss-bridge

A bridge between your RSS reader and an RSS source which extracts full articles.

Usage

Run the rss-bridge server:

uv run uvicorn rss_bridge.main:app --host 0.0.0.0 --port 8000

Full Article Extraction

Use the following URL scheme to add feeds to your RSS reader and extract full article texts:

<host>:8000/extract/?source_url=<rss feed source url>

You can optionally append &num=<x> to only load the x most recent feed entries.

Daily LLM Summarizations

To aggregate all news of a day into a single digest, use the daily summary endpoint. This will extract all articles and use Gemini to generate a summary. (Requires GEMINI_API_KEY in your environment).

<host>:8000/daily_summary/?source_url=<rss feed source url>

You can optionally append &num=-<x> to only aggregate the <x> most recent full days. A positive &num=<x> instead restricts the total number of articles processed across all days.

Tests

Run all tests with:

uv run pytest

Live Integration Tests

To run the live integration tests which perform real RSS extraction and Gemini API calls, use the --run-live flag. Note that this requires a valid GEMINI_API_KEY in your environment (or .env file). Use -s to see the generated newsletter output:

uv run pytest --run-live -s tests/test_live.py