Перейти к основному содержимому

Blogwatcher

Мониторинг блогов и RSS/Atom-лент с помощью утилиты blogwatcher-cli.

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

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

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

к сведению

Ниже приведено полное описание навыка, которое VibeOS загружает при его активации. Агент видит эти инструкции, когда навык активен.

Blogwatcher

Отслеживайте обновления блогов и RSS/Atom-лент с помощью утилиты blogwatcher-cli. Поддерживается автоматическое обнаружение лент, запасной парсинг 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

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

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

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

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

Все флаги можно задавать через переменные окружения с префиксом BLOGWATCHER_:

ПеременнаяОписание
BLOGWATCHER_DBПуть к файлу базы данных SQLite
BLOGWATCHER_WORKERSКоличество параллельных рабочих процессов сканирования (по умолчанию: 8)
BLOGWATCHER_SILENTВыводить только «сканирование завершено» при сканировании
BLOGWATCHER_YESПропускать запросы подтверждения
BLOGWATCHER_CATEGORYФильтр по умолчанию для статей по категории

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

$ blogwatcher-cli blogs
Отслеживаемые блоги (1):

  xkcd
    URL: https://xkcd.com
    Лента: https://xkcd.com/atom.xml
    Последнее сканирование: 2026-04-03 10:30
$ blogwatcher-cli scan
Сканирование 1 блога(ов)...

  xkcd
    Источник: RSS | Найдено: 4 | Новых: 4

Всего найдено 4 новых статьи!
$ blogwatcher-cli articles
Непрочитанные статьи (2):

  [1] [новое] Barrel - Part 13
       Блог: xkcd
       URL: https://xkcd.com/3095/
       Опубликовано: 2026-04-02
       Категории: Комиксы, Наука

  [2] [новое] Volcano Fact
       Блог: xkcd
       URL: https://xkcd.com/3094/
       Опубликовано: 2026-04-01
       Категории: Комиксы

Примечания​

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