rssfetch

A simple RSS feed fetcher and parser built with Elysia.js and Bun.

A free instance is hosted at: rssfetch.vercel.app. Feel free to use it!

Deployment

Vercel

This project can be directly deployed to Vercel with no additional configuration needed.
Click the button below to deploy:

Cloudflare Workers

This project can also be deployed to Cloudflare Workers, but requires some manual setup.
Follow the instructions in the Elysia Cloudflare Workers documentation.

Docker

Docker images are available on GHCR.

Manual Setup

Install dependencies:
Terminal window
```
bun install
```
Start the server:
Terminal window
```
bun start
```
The server will start on port 3000 by default.

API Usage

Fetch RSS Feed

Endpoint: GET /

Query Parameters:

Parameter	Type	Required	Description	Default
`url`	`string`	Yes	The URL of the RSS feed to fetch.	-
`type`	`string`	No	Sort order for articles: `latest` or `oldest`.	`latest`
`count`	`number`	No	The number of articles to return.	`1`
`step`	`number`	No	The offset for pagination (items to skip).	`0`

Example Request:

Fetch the latest 3 articles from an RSS feed:

curl "http://localhost:3000/?url=https://rss.nytimes.com/services/xml/rss/nyt/HomePage.xml&count=3"

Example Response:

{
  "title": "NYT > Top Stories",
  "description": "The New York Times: Top Stories",
  "link": "https://www.nytimes.com",
  "articles": [
    {
      "title": "Example Article Title",
      "link": "https://www.nytimes.com/2024/01/01/example.html",
      "description": "Brief description of the article content.",
      "pubDate": "Mon, 01 Jan 2024 12:00:00 GMT"
    }
    // ... 2 more articles
  ]
}