Blogwatcher

Отслеживание блогов и RSS/Atom-лент через инструмент blogwatcher-cli.

Метаданные навыка

ИсточникВстроенный (установлен по умолчанию)
Путьskills/research/blogwatcher
Версия2.0.0
АвторJulienTant (fork of Hyaxia/blogwatcher)
ЛицензияMIT
Платформыlinux, macos, windows
ТегиRSS, Blogs, Feed-Reader, Monitoring

Справочник: полный SKILL.md

инфо

Ниже — полное определение навыка, которое Hermes загружает при его срабатывании. Именно эти инструкции видит агент, пока навык активен.

Blogwatcher

Следите за обновлениями блогов и RSS/Atom-лент с помощью blogwatcher-cli. Инструмент сам находит ленты, при неудаче с RSS переключается на скрапинг HTML, умеет импортировать OPML и ведёт учёт прочитанных и непрочитанных статей.

Установка

Выберите один из способов:

  • Go: go install github.com/JulienTant/blogwatcher-cli/cmd/blogwatcher-cli@latest
  • Docker: docker run --rm -v blogwatcher-cli:/data ghcr.io/julientant/blogwatcher-cli
  • Бинарник (Linux amd64): curl -sL https://github.com/JulienTant/blogwatcher-cli/releases/latest/download/blogwatcher-cli_linux_amd64.tar.gz | tar xz -C /usr/local/bin blogwatcher-cli
  • Бинарник (Linux arm64): curl -sL https://github.com/JulienTant/blogwatcher-cli/releases/latest/download/blogwatcher-cli_linux_arm64.tar.gz | tar xz -C /usr/local/bin blogwatcher-cli
  • Бинарник (macOS Apple Silicon): curl -sL https://github.com/JulienTant/blogwatcher-cli/releases/latest/download/blogwatcher-cli_darwin_arm64.tar.gz | tar xz -C /usr/local/bin blogwatcher-cli
  • Бинарник (macOS Intel): curl -sL https://github.com/JulienTant/blogwatcher-cli/releases/latest/download/blogwatcher-cli_darwin_amd64.tar.gz | tar xz -C /usr/local/bin blogwatcher-cli

Все релизы: https://github.com/JulienTant/blogwatcher-cli/releases

Docker с постоянным хранилищем

По умолчанию база лежит в ~/.blogwatcher-cli/blogwatcher-cli.db. В Docker она теряется при перезапуске контейнера. Чтобы её сохранить, укажите BLOGWATCHER_DB или подключите том:

# Именованный том (проще всего)
docker run --rm -v blogwatcher-cli:/data -e BLOGWATCHER_DB=/data/blogwatcher-cli.db ghcr.io/julientant/blogwatcher-cli scan

# Bind-монтирование с хоста
docker run --rm -v /path/on/host:/data -e BLOGWATCHER_DB=/data/blogwatcher-cli.db ghcr.io/julientant/blogwatcher-cli scan

Переход с оригинального blogwatcher

Если обновляетесь с Hyaxia/blogwatcher, перенесите базу данных:

mv ~/.blogwatcher/blogwatcher.db ~/.blogwatcher-cli/blogwatcher-cli.db

Имя бинарника изменилось с blogwatcher на blogwatcher-cli.

Основные команды

Управление блогами

  • Добавить блог: blogwatcher-cli add "My Blog" https://example.com
  • Добавить с явной лентой: blogwatcher-cli add "My Blog" https://example.com --feed-url https://example.com/feed.xml
  • Добавить со скрапингом HTML: blogwatcher-cli add "My Blog" https://example.com --scrape-selector "article h2 a"
  • Список отслеживаемых блогов: blogwatcher-cli blogs
  • Удалить блог: blogwatcher-cli remove "My Blog" --yes
  • Импортировать из OPML: blogwatcher-cli import subscriptions.opml

Сканирование и чтение

  • Просканировать все блоги: blogwatcher-cli scan
  • Просканировать один блог: blogwatcher-cli scan "My Blog"
  • Список непрочитанных статей: blogwatcher-cli articles
  • Список всех статей: blogwatcher-cli articles --all
  • Фильтр по блогу: blogwatcher-cli articles --blog "My Blog"
  • Фильтр по категории: blogwatcher-cli articles --category "Engineering"
  • Пометить статью прочитанной: blogwatcher-cli read 1
  • Пометить статью непрочитанной: blogwatcher-cli unread 1
  • Пометить всё прочитанным: blogwatcher-cli read-all
  • Пометить всё прочитанным для блога: blogwatcher-cli read-all --blog "My Blog" --yes

Переменные окружения

Любой флаг можно задать через переменную окружения с префиксом BLOGWATCHER_:

ПеременнаяОписание
BLOGWATCHER_DBПуть к файлу базы данных SQLite
BLOGWATCHER_WORKERSЧисло параллельных воркеров сканирования (по умолчанию: 8)
BLOGWATCHER_SILENTПри сканировании выводить только “scan done”
BLOGWATCHER_YESПропускать запросы на подтверждение
BLOGWATCHER_CATEGORYКатегория-фильтр для статей по умолчанию

Пример вывода

$ blogwatcher-cli blogs
Tracked blogs (1):

  xkcd
    URL: https://xkcd.com
    Feed: https://xkcd.com/atom.xml
    Last scanned: 2026-04-03 10:30
$ blogwatcher-cli scan
Scanning 1 blog(s)...

  xkcd
    Source: RSS | Found: 4 | New: 4

Found 4 new article(s) total!
$ blogwatcher-cli articles
Unread articles (2):

  [1] [new] Barrel - Part 13
       Blog: xkcd
       URL: https://xkcd.com/3095/
       Published: 2026-04-02
       Categories: Comics, Science

  [2] [new] Volcano Fact
       Blog: xkcd
       URL: https://xkcd.com/3094/
       Published: 2026-04-01
       Categories: Comics

Примечания

  • Автоматически находит RSS/Atom-ленты на главных страницах блогов, если --feed-url не указан.
  • Переходит к скрапингу HTML, если RSS не сработал и задан --scrape-selector.
  • Категории из RSS/Atom-лент сохраняются, по ним можно фильтровать статьи.
  • Блоги можно импортировать группой из OPML-файлов, выгруженных из Feedly, Inoreader, NewsBlur и других агрегаторов.
  • База данных по умолчанию хранится в ~/.blogwatcher-cli/blogwatcher-cli.db (переопределяется через --db или BLOGWATCHER_DB).
  • Команда blogwatcher-cli <command> --help покажет все доступные флаги и параметры.
ESC