Add Email Newsletter to FreshRSS
Subscribe to an email newsletter by creating a Kill the Newsletter inbox, then adding the resulting Atom feed to FreshRSS with an appropriate category.
Procedure
1. Understand the newsletter
The user provides a newsletter name, signup page, or website. Use WebFetch on the provided URL to understand what the newsletter covers (topic, audience, content type). This informs the feed title.
2. Create a Kill the Newsletter inbox
FEED_SLUG=$(curl -s -X POST https://kill-the-newsletter.com/feeds \
-H "CSRF-Protection: true" \
-d "title=NEWSLETTER_TITLE" \
-D - -o /dev/null | grep -oP 'location:.*feeds/\K[^\s]+')
This gives you:
- Email:
${FEED_SLUG}@kill-the-newsletter.com - Atom feed:
https://kill-the-newsletter.com/feeds/${FEED_SLUG}.xml
3. Add to FreshRSS
Invoke add-feed with the atom feed URL
(https://kill-the-newsletter.com/feeds/${FEED_SLUG}.xml) to authenticate with
FreshRSS, infer the best category, and add the feed.
4. Output results
Print clearly:
- Email address:
${FEED_SLUG}@kill-the-newsletter.com - Atom feed URL:
https://kill-the-newsletter.com/feeds/${FEED_SLUG}.xml - FreshRSS category: the assigned category
- What to do next: Go to the newsletter's signup page, paste the email address above into the subscribe form, and submit. Once the newsletter sends its first email, it will appear as an entry in FreshRSS.
- If a confirmation email is required, it will also show up in FreshRSS as a feed entry. Follow the confirmation link from there.
Notes
- The Kill the Newsletter inbox must be created before subscribing. The email address is what the user gives to the newsletter signup form.
- Do not share the KTN feed URL publicly (anyone with it can send spam to it).