Added n8n workflow that monitors Mastodon instances for version updates: - Checks latest Mastodon release from GitHub API - Queries running Mastodon instance version via /api/v2/instance endpoint - Compares versions using Python-based semantic versioning - Sends email alerts when updates are available - Includes detailed README with setup instructions and troubleshooting - Updated root README and CHANGELOG to document the new workflow 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> |
||
|---|---|---|
| .claude/agents | ||
| aws-rss-discourse | ||
| forgejo-version-checker | ||
| mastodon-version-checker | ||
| CHANGELOG.md | ||
| LICENSE | ||
| prompt.md | ||
| README.md | ||
| WORKFLOW_TEMPLATE.md | ||
n8n Workflow Examples
This repository contains a collection of n8n workflow examples that can be imported directly into your n8n instance. Each workflow is stored in its own directory with a workflow.json file that can be imported.
How to Import
- Open your n8n instance
- Click on "Workflows" in the left sidebar
- Click the "Import" button
- Select the
workflow.jsonfile from the desired workflow directory - Configure any required credentials and parameters
- Activate the workflow
Available Workflows
1. Forgejo Version Checker
Directory: forgejo-version-checker/
Description: Automatically monitors your Forgejo instance for available updates and sends email notifications when a new version is released.
Features:
- Checks the latest Forgejo version from Codeberg API
- Queries your running Forgejo instance for its current version
- Compares versions using semantic versioning
- Sends email alerts via SMTP when an update is available
- Runs on a daily schedule (configurable)
Setup Instructions:
- Import the workflow from
forgejo-version-checker/workflow.json - Configure SMTP credentials in n8n (Settings → Credentials → Create New → SMTP)
- Edit the "Get Running Forgejo Version" node:
- Update the URL to your Forgejo instance (e.g.,
https://forgejo.example.com/api/v1/version)
- Update the URL to your Forgejo instance (e.g.,
- Edit the "Send Email Alert" node:
- Update
fromEmailandtoEmailaddresses - Select your SMTP credentials
- Update
- Optionally adjust the schedule in the "Schedule Trigger" node (default: daily)
- Activate the workflow
Requirements:
- Forgejo instance must have API access enabled
- Valid SMTP credentials for sending emails
- Network access to both Codeberg.org and your Forgejo instance
Use Cases:
- Staying informed about Forgejo security updates
- Maintaining up-to-date self-hosted Git services
- Automated update monitoring for multiple instances
2. Mastodon Version Checker
Directory: mastodon-version-checker/
Description: Automatically monitors your Mastodon instance for available updates and sends email notifications when a new version is released.
Features:
- Checks the latest Mastodon version from GitHub API
- Queries your running Mastodon instance for its current version
- Compares versions using semantic versioning
- Sends email alerts via SMTP when an update is available
- Runs on a daily schedule (configurable)
Setup Instructions:
- Import the workflow from
mastodon-version-checker/workflow.json - Configure SMTP credentials in n8n (Settings → Credentials → Create New → SMTP)
- Edit the "Get Running Mastodon Version" node:
- Update the URL to your Mastodon instance (e.g.,
https://mastodon.example.com/api/v2/instance)
- Update the URL to your Mastodon instance (e.g.,
- Edit the "Send Email Alert" node:
- Update
fromEmailandtoEmailaddresses - Select your SMTP credentials
- Update
- Optionally adjust the schedule in the "Schedule Trigger" node (default: daily)
- Activate the workflow
Requirements:
- Mastodon instance with API access enabled (public endpoint)
- Valid SMTP credentials for sending emails
- Network access to both GitHub.com and your Mastodon instance
Use Cases:
- Staying informed about Mastodon security updates
- Maintaining up-to-date self-hosted Fediverse instances
- Automated update monitoring for multiple instances
3. AWS RSS to Discourse with AI Summary
Directory: aws-rss-discourse/
Description: Automated workflow that fetches AWS announcements from their RSS feed, processes them with AI to create engaging summaries with fintech use cases, and posts them to Discourse with proper formatting and tagging.
Features:
- Scheduled Monitoring: Runs every hour at 5 minutes past the hour
- Time-based Filtering: Only processes announcements from the last 1 hour
- AI-Powered Content Generation: Uses Claude Sonnet 4.5 to create:
- Short summaries of AWS announcements
- Fintech business use case ideas
- Upbeat, friendly tech blog writing style
- Reader engagement prompts and call-to-action
- Structured JSON Output: Validates AI responses with schema parser
- Automatic Discourse Posting: Posts directly to Discourse via API
- Smart Tagging: Auto-tags with "aws" and "reinvent"
- Markdown Formatting: Rich text formatting for professional posts
Setup Instructions:
- Import the workflow from
aws-rss-discourse/workflow.json - Configure Anthropic API credentials in n8n:
- Settings → Credentials → Create New → Anthropic API
- Enter your Anthropic API key
- Configure Discourse API credentials in n8n:
- Settings → Credentials → Create New → Discourse API
- Enter your Discourse instance URL (e.g.,
https://discourse.example.com) - Enter your Discourse username
- Enter your Discourse API key
- Edit the HTTP Request node (if needed):
- Update the URL to your Discourse instance
- Adjust category ID (default: 12)
- Modify tags as needed (default: aws, reinvent)
- Optionally adjust the schedule (default: hourly at :05)
- Optionally adjust the time filter window (default: 1 hour)
- Activate the workflow
Requirements:
- Valid Anthropic API key with access to Claude Sonnet 4.5
- Discourse instance with API access enabled
- Discourse API key with permission to create posts
- Network access to aws.amazon.com and api.anthropic.com
- Python environment with dateutil library
Use Cases:
- Automated AWS announcement sharing for fintech communities
- AI-generated content with business context
- Time-saving automation for community managers
- Consistent posting schedule for technical forums
- Building searchable knowledge base with AWS updates
Technical Details:
- Schedule Trigger: Hourly execution at 5 minutes past
- RSS Feed Reader: Fetches AWS What's New feed
- Python Code Node: Filters items by publication date (1 hour window)
- LLM Chain: Claude Sonnet 4.5 with structured output
- Structured Output Parser: JSON schema validation (title, body)
- HTTP Request: Direct Discourse API posting
- Writing Style: Professional technical writer with fintech focus, British English
- Error Handling: Configured error workflow for failed executions
- Time Saved: ~15 minutes per execution
Configuration Options:
- Adjust time filter: Modify
timedelta(hours=1)in Python node - Change schedule: Edit Schedule Trigger interval
- Update tags: Modify bodyParameters in HTTP Request node
- Change category: Update category ID in HTTP Request node
- Customize writing style: Edit system message in LLM Chain node
Contributing
Feel free to add more workflow examples to this collection. Each workflow should:
- Be in its own directory
- Include a
workflow.jsonfile - Be documented in this README with setup instructions
License
This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.
You are free to:
- Share — copy and redistribute the material in any medium or format
- Adapt — remix, transform, and build upon the material for any purpose, even commercially
Under the following terms:
- Attribution — You must give appropriate credit, provide a link to the license, and indicate if changes were made
- ShareAlike — If you remix, transform, or build upon the material, you must distribute your contributions under the same license as the original
See the LICENSE file for the full legal text.
