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покажет все доступные флаги и параметры.