paperboy

Fetch, filter, and summarize RSS and newsletter sources into a daily Obsidian markdown digest.

1|Updated May 3, 2026
One-click install
npx skills add https://github.com/rezrov/claude-marketplace --skill paperboy-rezrov
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: paperboy
Source: https://github.com/rezrov/claude-marketplace/tree/main/plugins/paperboy/skills/paperboy
Command: npx skills add https://github.com/rezrov/claude-marketplace --skill paperboy-rezrov

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Manually scanning dozens of RSS feeds, newsletters, and subreddits every day is noisy and time-consuming. This Skill automates the entire pipeline: it fetches new items from your configured sources, filters them against your stated interests, deduplicates repeated stories, summarizes the keepers, and writes a single clean markdown digest into an Obsidian vault. ## Core Features & Use Cases - Multi-source fetching: Pulls candidates from RSS 2.0 feeds, the 1440 daily newsletter (parsed per-blurb with citations), and subreddit listings, with per-source state tracking so nothing resurfaces. - LLM-based classification and dedup: Classifies items against your editable interests.md, clusters cross-outlet coverage of the same story, and suppresses stories already covered on previous days. - Paywall-aware summarization: Detects paywalled articles, searches for the same story at a non-paywalled source, and summarizes via WebFetch with feed-description fallbacks. - Use Case: Each morning, say "fetch my newspaper" and receive a timestamped digest in your Obsidian vault containing only the stories matching your interests, plus an inspectable Skipped section for tuning. ## Quick Start Say "run paperboy" to fetch your configured news sources, filter them against your interests, and write today's digest into your Obsidian vault.

Frequently Asked Questions about paperboy

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build a daily news digest from RSS feeds automatically?

Configure your RSS feeds in sources.md and your keep/skip rules in interests.md, then trigger the skill with "run paperboy". It fetches new items, classifies them against your interests, summarizes keepers, and writes a timestamped markdown digest to your vault.

How do I filter news articles by personal interests using an LLM?

Write your keep and reject rules in plain language in interests.md. The classifier reads that file every run and applies it to all fetched candidates in one batched pass, defaulting to skip for marginal items so the feed stays tight.

Does paperboy work without Obsidian?

Yes, Obsidian is not required. The digest is plain markdown readable in any editor; Obsidian is only assumed for link rendering and the optional step that opens the vault via an obsidian:// URL.

Can it handle paywalled news articles?

It detects paywalled domains from your sources.md paywall list and searches for the same story at a non-paywalled source, summarizing from that alternate instead. It never bypasses paywalls; if no alternate exists, the original link stands with a note.

Why do old news items reappear in my digest?

Reappearing items usually mean the per-source seen-ID list hit its cap or a state file became corrupt and was reset. The skill emits warnings for both conditions; raise PAPERBOY_SEEN_CAP or restore the state file to fix it.

What news sources and feed formats are supported?

Three source types are supported: standard RSS 2.0 feeds, the 1440 newsletter via its sitemap (parsed into pre-summarized blurbs with citations), and subreddit listings via Reddit's JSON endpoints. Other formats report an unsupported-source error.