[READ-ONLY] Mirror of https://github.com/shuuji3/bsky-rss. 🦋 A minimal Node.js application to generate Bluesky RSS feeds including replies, which are not supported by the official RSS feeds
README.md

@shuuji3/bsky-rss 🦋 #

A minimal Node.js application to generate Bluesky RSS feeds including replies, which are not supported by the official RSS feeds.

Built with atcute, Hono, and feed. This tool can be used as a standalone CLI or as a proxy server.

Note

This project was almost entirely generated by an LLM (model: gemini-3-flash-preview) as a jig for personal usage.

Installation #

# Using pnpm dlx (like npx)
pnpm dlx @shuuji3/bsky-rss <command>

# Or install globally
pnpm add -g @shuuji3/bsky-rss

Usage #

Generate RSS (CLI) #

Generate an RSS feed for a specific Bluesky user and output it to stdout.

bsky-rss generate <handle-or-did>

Example:

bsky-rss generate bsky.app > feed.xml

Start Server #

Start a proxy server that serves RSS feeds via HTTP.

bsky-rss serve --port 3000

Access the RSS feed at: http://localhost:3000/rss/[handle_or_did]

Example:

  • http://localhost:3000/rss/bsky.app
  • http://localhost:3000/rss/did:plc:z72i7hdynmk6r22z27h6tvur

Development #

Requires Node.js v25 or later (for native TypeScript support).

pnpm install
node src/cli.ts generate bsky.app

License #

MIT License