Создание автоматизаций с помощью API SereneReader

Зачем автоматизировать чтение?

RSS уже решает самое сложное: собирает контент из сотен источников в одном месте. API SereneReader позволяет получать этот контент в скриптах, задачах cron и других инструментах программным способом.

Никаких вебхуков для настройки. Никакого OAuth. Сгенерируйте ключ API, делайте HTTP-запросы, получайте JSON в ответ.

Начало работы

Доступ к API включён в тариф Pro за $5/мес — без необходимости корпоративного плана. Большинство конкурирующих RSS-читалок открывают доступ к API только на более дорогих или топовых тарифах.

Создание ключа API

Перейдите на страницу настроек в SereneReader и прокрутите до раздела API. Создайте новый ключ, дайте ему имя, по которому вы его узнаете, и скопируйте в надёжное место. Ключ отображается только один раз.

Аутентификация

Каждый запрос требует токена Bearer в заголовке Authorization. Вот и всё. Никаких client ID, токенов обновления или областей видимости. На странице настроек API указаны базовый URL, документация по эндпоинтам и примеры запросов.

Ограничения частоты запросов

API допускает 30 запросов в минуту на аккаунт. Этого более чем достаточно для скриптов, работающих по расписанию. Если вы превысили лимит, подождите несколько секунд и повторите попытку.

Возможности

API предоставляет доступ на чтение к вашим статьям и подпискам. Фильтруйте статьи по ленте, папке или дате публикации. Просматривайте список подписок с количеством непрочитанных материалов. Все ответы возвращаются в формате JSON с заголовками, URL, датами публикации, фрагментами текста и метаданными лент.

Полный список эндпоинтов, параметров и форматов ответов находится в разделе документации API на странице настроек.

Сценарии использования

Ежедневный дайджест по электронной почте

Напишите скрипт, который каждое утро в 7:00 собирает вчерашние статьи и отправляет вам сводное письмо. Отфильтруйте по дате, пропустите JSON через jq, чтобы извлечь заголовки и URL, и отправьте результат в удобную для вас систему уведомлений.

Данные представлены в чистом формате, готовом к любой обработке.

Мониторинг работоспособности лент

Ленты перестают работать. Домены истекают, пути меняются, серверы выходят из строя. Еженедельный скрипт может перечислить ваши подписки и проверить, какие из них давно не публиковали материалы.

Когда лента замолкает, вы узнаете об этом раньше, чем начнёте задаваться вопросом, куда пропал тот блог.

Экспорт в другие инструменты

Выгружайте статьи в локальную базу данных, страницу Notion, хранилище Obsidian или таблицу. API возвращает структурированные данные, поэтому для преобразования обычно достаточно нескольких строк jq или короткого скрипта на Python.

Интеграция с AI-агентами

API хорошо сочетается с AI-инструментами, умеющими делать HTTP-запросы. Если вы используете фреймворк для агентов, например OpenClaw, можно направить его на SereneReader и дать ему самостоятельно обрабатывать ваши ленты. Мы написали об этом отдельную статью: Как подключить RSS-ленты к AI-агентам.

Оставляйте всё простым

Лучшие автоматизации — это короткие скрипты, решающие одну задачу. Задача cron, запускаемая раз в день. Псевдоним в оболочке, показывающий количество непрочитанных. Ретранслятор вебхуков, пересылающий статьи в канал Slack.

Никакой фреймворк для этого не нужен. curl и jq покрывают большинство случаев. Если нужно что-то более структурированное, подойдёт любой язык с HTTP-клиентом.

Ключи API и документация по эндпоинтам находятся в настройках SereneReader.