github-action-feed-to-social-media

This GitHub Action monitors RSS and Atom feeds, detects new items, and automatically posts them to your choice of social media platforms including Mastodon, Twitter, Discord, Slack, and Bluesky. It uses a configurable strategy to identify the newest feed item (by publication date, first, or last in feed) and maintains a cache to prevent duplicate posts. Each supported platform can use its own custom post format with template tags like {title}, {link}, {description}, and iTunes-specific fields, allowing you to optimize messages for platform-specific features and character limits. The Action handles authentication via API tokens and webhooks, with sensitive credentials stored as encrypted GitHub secrets.

Add the action to your GitHub workflow with your feed URL and platform credentials. Configure the newestItemStrategy (latestDate, first, or last) and optional custom post formats for each channel. Store API tokens and access credentials as encrypted GitHub secrets. Ensure your repository has read/write workflow permissions so the Action can maintain feed cache to avoid duplicates.