blogwatcher

Monitor blogs and RSS/Atom feeds using the blogwatcher-cli tool.

Updated Sep 10, 2026
One-click install
npx skills add https://github.com/loteiron/ZeusAgent --skill blogwatcher-loteiron
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: blogwatcher
Source: https://github.com/loteiron/ZeusAgent/tree/main/optional-skills/research/blogwatcher
Command: npx skills add https://github.com/loteiron/ZeusAgent --skill blogwatcher-loteiron

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Keeping up with many blogs and RSS/Atom feeds manually means repeatedly checking sites for new posts. This Skill tracks feeds in a local SQLite database, scans for new articles, and manages read/unread state so nothing is missed. ## Core Features & Use Cases - Feed tracking and discovery: Add blogs with automatic RSS/Atom feed discovery, HTML scraping fallback via CSS selectors, and bulk OPML import from readers like Feedly or Inoreader. - Scanning and read state: Scan all or individual blogs, list unread articles filtered by blog or category, and mark articles read or unread. - Recurring monitoring: Pair with the cronjob tool's monitor field to wake the agent only when new articles appear, and route digests to a chat or channel. - Use Case: Track a dozen engineering blogs, run scheduled scans, and receive a digest of only the new unread articles each morning. ## Quick Start Install blogwatcher-cli, then ask the agent to add https://xkcd.com and list any unread articles.

Frequently Asked Questions about blogwatcher

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

FAQPage Schema
How do I monitor RSS feeds from the command line?▼

Use blogwatcher-cli to add blogs with `blogwatcher-cli add "Name" URL`, then run `blogwatcher-cli scan` to fetch new articles and `blogwatcher-cli articles` to list unread items. Feed URLs are auto-discovered from blog homepages.

How to import OPML subscriptions into a feed reader CLI?▼

Run `blogwatcher-cli import subscriptions.opml` to bulk-import feeds exported from Feedly, Inoreader, NewsBlur, or similar readers. Each entry becomes a tracked blog in the local SQLite database.

Does blogwatcher-cli work on sites without an RSS feed?▼

Yes, it falls back to HTML scraping when RSS fails. Add the blog with `--scrape-selector "article h2 a"` to specify a CSS selector for extracting article links from the page.

Can I run blogwatcher-cli in Docker with persistent data?▼

Yes, mount a volume and set BLOGWATCHER_DB to a path inside it, for example `docker run --rm -v blogwatcher-cli:/data -e BLOGWATCHER_DB=/data/blogwatcher-cli.db ghcr.io/julientant/blogwatcher-cli scan`. Without this the database is lost on container restart.

When should I use blogwatcher instead of a simple feed read?▼

Use blogwatcher when tracking many feeds over time with read/unread state and scheduled scans. For a one-off read of a single feed, a lightweight feed-reading script is sufficient without installing anything.