Support discovering multiple RSS feeds from HTML autodiscovery tags

Open
#4,893 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
3/5
Estimated time
1-2 days
Newbie friendliness
45/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Stale
Tech stack
typescript
Domain
backend

Research direction

Start by tracing Folo's Discover flow for HTML RSS autodiscovery. Check how alternate RSS links are collected and presented when a page declares multiple feeds. Done means all qualifying feeds, including the English and Chinese examples, are discovered and offered for selection rather than only the first link.

Written by the indexing model from the issue text.

Description

Problem

When searching a domain (e.g., mjshao.fun) in Folo's Discover, only the first <link rel="alternate" type="application/rss+xml"> tag is discovered, even when the page declares multiple feeds.

My site has two RSS feeds — English and Chinese:

<link rel="alternate" type="application/rss+xml" title="Mingjian Shao's Writing (English)" href="/rss.xml"/>
<link rel="alternate" type="application/rss+xml" title="Mingjian Shao's Writing (中文)" href="/rss-cn.xml"/>
  • ✅ /rss.xml is discovered via domain search
  • ❌ /rss-cn.xml is not discovered (works when added manually via direct URL)

Expected Behavior

Folo should discover all <link rel="alternate"> feeds declared in the HTML <head> and present them to the user for selection — similar to how Feedly, Inoreader, and Firefox handle multiple autodiscovery links.

RSS Autodiscovery Spec

The RSS Advisory Board spec explicitly supports multiple feeds:

"A head may include more than one autodiscovery link, but each must identify a different feed."

"If you decide to include more than one autodiscovery link, the first link should be the site's main feed."

"When a page contains more than one autodiscovery link, the title enables users to differentiate between the feeds."

Use Cases

  • Multilingual sites (EN + CN feeds, like mine)
  • Content type variants (full articles vs. headlines)
  • Category feeds (tech, design, etc.)

Prior Art

A nearly identical issue was reported and fixed in bridgy-fed#2255 — their backend also only read the first <link rel="alternate"> tag.

Environment

Dominant language
TypeScript
Stars
39.3k
Forks
2.2k
Avg merge
9h 14m
Merged PRs (30d)
16

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from RSSNext/Folo

All issues in RSSNext/Folo

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.