Module:Bluesky RSS Feed

This module is a custom-designed RSS feed, designed to process a Bluesky RSS feed and output it as a template. Up to three search keywords can be input - OR rather than AND - to find posts that mention any of the keywords. A Bluesky RSS feed can be found by going to any user's page, and typing /rss at the end of the URL before hitting enter.

Usage

{{Template:Bluesky RSS Feed
|url= Bluesky RSS feed URL
|term1= Optional search term
|term2= Optional search term
|term3= Optional search term
}}

Example

{{Template:Bluesky RSS Feed
|url=https://bsky.app/profile/did:plc:ve2p3lz33ivtyikqztvsgtx3/rss
|term1=#NOISZ
}}

Will yield:

24 Aug 2026 17:28 +0000
8 years... Time flies, doesn't it? Even if the world enters a new age, these memories will always remain.

Once again, experience NOISZ at its lowest-ever price on Steam. #NOISZ https://store.steampowered.com/app/681530/NOISZ/

22 Jul 2026 17:08 +0000
☀️ Happy birthday to SUNRaiSE's Asuka! Let the golden sun shine on a bright new future! ☀️

🎨 @/beffkawa

1. NOISZ_SL

---

local capiunto = require 'capiunto'
local p = {}
function p.main(frame)

local args = frame:getParent().args
local posts = {}
local searchTerms = {}

-- These are the search terms as defined in the template.
if args.term1 or args.term2 or args.term3 then
	searchTerms[1] = args.term1
	searchTerms[2] = args.term2
	searchTerms[3] = args.term3
else 
-- If no search terms, then the search terms array is left blank so it'll match everything.
	searchTerms = {""}
end

-- We use externaldata.getWebDate to obtain XML format data from the RSS feed at the URL defined by the user.
local rss = mw.ext.externaldata.getWebData {
    url = args.url
  , data = {pubDate = 'pubDate', description = 'description', link= 'link'}
  , format = 'xml'
}

-- We iterate over every post found in the RSS feed, in chronological order - hence ipairs.
for k, v in ipairs(rss) do

-- We need description, publish date AND link to know that it's a post. Additionally, k has to be more than 1 as the very first post to pop up in an RSS feed is the user bio which is not an actual post.

	if v["description"] and v["pubDate"] and v["link"] and k > 3 then
-- Search over every search term in the search terms to make sure a post contains that term.
		for a, b in pairs(searchTerms) do
			if string.find(v["description"],b) then
-- We bundle up the information into template form via the frame:expandTemplate method - the "Bluesky RSS Feed Row" template, to be precise - and put it into an incremental table which will later be expanded in full.
				table.insert(posts, frame:expandTemplate{title = 'Bluesky RSS Feed Row', args = {description = v["description"], pubDate = v["pubDate"], link=v["link"]}})
			end	
		end
	end
end

-- Table.concat to move it from Lua table form to a form the wikitext can use.
return table.concat(posts,"")


end

return p