A CLI tool for contextual RSS amplification with AI-driven snippet generation and social media posting.
RSS Amplifier helps technical marketers, indie developers, and SaaS founders share their content organically across social platforms without explicit links. It imports RSS/OPML feeds, generates AI-driven snippets with contextual brand mentions, and posts to multiple social platforms automatically or via manual approval.
- 📡 RSS/OPML Import: Import feeds from local files or URLs
- 🤖 AI-Powered Snippets: Generate contextual content with brand mentions
- 📅 Scheduled Fetching: Automatic RSS feed updates via cron jobs
- ✅ Snippet Management: Approve, edit, delete, and schedule snippets
- 🌐 Multi-Platform Posting: Support for Mastodon, Bluesky, X/Twitter, LinkedIn, Nostr
- 📊 Analytics: Track performance with Supabase integration
- ⚙️ Flexible Configuration: Comprehensive settings management
# Install globally via npm
npm install -g @profullstack/rss-amplifier
# Or install via pnpm
pnpm add -g @profullstack/rss-amplifier📋 For detailed setup instructions, see SETUP.md
-
Configure environment variables:
# Copy the sample environment file cp .env.sample .env # Edit with your API keys and credentials nano .env
-
Required: OpenAI API Key
OPENAI_API_KEY=sk-your-openai-api-key-here
-
Optional: Social media platform credentials (see SETUP.md for details)
# Set up configuration
rssamp setup
# Import OPML file
rssamp import ./feeds.opml
# List imported feeds
rssamp feeds list
# Generate snippets with brand context
rssamp snippets generate --brand "SmashLang, async-first JS alternative"
# List generated snippets
rssamp snippets list
# Approve a snippet
rssamp snippets approve [snippet-id]
# Post to social platforms
rssamp snippets post --id [snippet-id] --platform mastodon
# Schedule automatic posting
rssamp schedule auto-post --platform bluesky --interval dailyrssamp setup- Interactive setup wizardrssamp config- Show current configurationrssamp status- Show platform authentication status
rssamp import <file>- Import OPML/RSS feedsrssamp feeds list- List all feedsrssamp feeds refresh- Manually refresh feeds
For catalogues rather than a handful of hand-picked feeds. These commands use a
SQLite store (~/.config/rss-amplifier/feeds.db) instead of feeds.json,
because the JSON store loads every feed into memory and rewrites the whole file
on each change — fine for fifty feeds, fatal for fifty thousand.
rssamp feeds import-opml --file feeds.opml- Stream an OPML catalogue in. Tested at 47,000 feeds in under two seconds.rssamp feeds harvest-podcasts [--all]- Build a podcast catalogue from the iTunes Search API (free, no key).--allsweeps ten markets instead of one. Paced under Apple's rate limit; Ctrl-C is safe and keeps what it found.rssamp feeds stats- Catalogue size, what is due, what is failing.rssamp feeds recent [--kind podcast]- Newest articles collected.
brisk.news holds the same feeds in Supabase (rss_feed_sources), split into
smallweb (the Kagi catalogue) and opml (feeds collected by hand over the
years — the ones worth keeping). Export them as OPML server-side so tens of
thousands of rows never travel through an agent's context:
select '<?xml version="1.0" encoding="UTF-8"?><opml version="2.0">'
|| '<head><title>brisk.news feeds</title></head><body>'
|| string_agg(
'<outline type="rss" title="' || replace(coalesce(title, feed_url), '"', '"')
|| '" xmlUrl="' || replace(feed_url, '"', '"') || '"/>', '')
|| '</body></opml>'
from rss_feed_sources
where source_origin = 'opml'; -- or drop the filter for all ~33kThen rssamp feeds import-opml --file <that file> --origin brisk. Re-running is
safe: feed URLs are unique and normalised, so an existing feed is skipped rather
than duplicated.
rssamp daemon start # 8 feeds at a time, 2s between batches
rssamp daemon start --batch 16 --pause 5
rssamp daemon status # same as `feeds stats`Keeping tens of thousands of feeds current is only affordable because almost every poll costs nothing:
- Conditional GET. Each feed stores its
ETag/Last-Modified, so an unchanged feed answers304— no body, no parsing. Servers that ignore those get the same cheap path via a content hash. - Adaptive intervals. A feed that publishes is checked sooner; one that never changes backs off, up to a day.
- Backoff and eviction. Failures back off exponentially, and a feed that fails repeatedly is deactivated rather than retried forever.
- Bounded everything. One feed per host per batch, a request timeout, and a download size cap.
The database is the queue — there is no Redis and no job server. The daemon can be killed at any moment and resumes exactly where it left off.
rssamp snippets generate [options]- Generate AI snippetsrssamp snippets list- List all snippetsrssamp snippets approve <id>- Approve snippet for postingrssamp snippets edit <id>- Edit snippet contentrssamp snippets delete <id>- Delete snippetrssamp snippets post <id> [options]- Post snippet to platforms
rssamp schedule auto-post [options]- Set up automatic postingrssamp schedule list- List scheduled tasksrssamp schedule stop <id>- Stop scheduled task
RSS Amplifier stores configuration in ~/.config/rss-amplifier/config.json. Key sections include:
Configure social media platforms:
{
"platforms": {
"mastodon": {
"enabled": true,
"instanceUrl": "https://mastodon.social",
"accessToken": "your-token"
},
"bluesky": {
"enabled": true,
"handle": "your-handle.bsky.social",
"appPassword": "your-app-password"
}
}
}Set up AI providers:
{
"ai": {
"enabled": true,
"provider": "openai",
"openaiApiKey": "sk-your-api-key",
"model": "gpt-4o-mini",
"temperature": 0.7
}
}Define your brand context for AI generation:
{
"general": {
"brandContext": "SmashLang, an async-first JavaScript alternative focused on performance and developer experience"
}
}- Node.js 20+
- pnpm (recommended)
# Clone repository
git clone https://github.com/profullstack/rss-amplifier.git
cd rss-amplifier
# Install dependencies
pnpm install
# Run tests
pnpm test
# Run specific test suite
pnpm test:config
pnpm test:feeds
pnpm test:snippets
# Lint and format
pnpm lint
pnpm formatrss-amplifier/
├── src/ # Source code
│ ├── config-manager.js # Configuration management
│ ├── feed-manager.js # RSS/OPML handling
│ ├── snippet-manager.js # Snippet operations
│ ├── ai-service.js # AI integration
│ └── social-poster.js # Social platform posting
├── test/ # Test files
├── bin/ # CLI executables
├── examples/ # Usage examples
└── index.js # Main module export
[ CLI Interface ] ↔ [ Config Manager ]
↔ [ Feed Manager ] ↔ [ RSS Parser ]
↔ [ AI Service ] ↔ [ OpenAI/Ollama ]
↔ [ Snippet Manager ] ↔ [ Supabase DB ]
↔ [ Social Poster ] ↔ [ Platform APIs ]
- Mastodon: ActivityPub-based decentralized social network
- Bluesky: AT Protocol-based social network
- X (Twitter): Microblogging platform
- LinkedIn: Professional networking platform
- Nostr: Decentralized social protocol
- OpenAI: GPT models for content generation
- Ollama: Local AI model hosting (planned)
- Fork the repository
- Create a feature branch
- Write tests for new functionality
- Implement the feature
- Ensure all tests pass
- Submit a pull request
MIT License - see LICENSE file for details.
Built with ❤️ by Profullstack