← Back to blog

Budowanie automatyzacji z API SereneReader

SereneReader///apiautomatyzacja

Po co automatyzować czytanie?

RSS już zbiera treści z wielu źródeł w jednym miejscu. API SereneReader pozwala pobierać te treści do skryptów, zadań cron i innych narzędzi.

Uwierzytelnianie opiera się na jednym kluczu API: utwórz go, dołączaj do każdego żądania HTTP i otrzymuj odpowiedzi w formacie JSON. API jest tylko do odczytu i nie obsługuje webhooków, więc skrypty odpytują je zgodnie z harmonogramem.

Jak zacząć

Dostęp do API jest dostępny w planach Pro (5 USD/miesiąc w wersji web) oraz Team.

Utwórz klucz API

W SereneReader otwórz Ustawienia i przejdź do zakładki API. Utwórz klucz, nadaj mu nazwę, którą później rozpoznasz, i skopiuj go w bezpieczne miejsce — jest wyświetlany tylko raz. Konta Pro mogą mieć do 5 kluczy, a konta Team do 10.

Uwierzytelnianie

Każde żądanie wymaga podania klucza jako tokenu Bearer w nagłówku Authorization. Nie ma identyfikatorów klienta, tokenów odświeżania ani zakresów uprawnień. Zakładka API w Ustawieniach zawiera podstawowy adres URL, listę endpointów oraz przykładowe żądania.

Limity żądań

API pozwala na 30 żądań na minutę na konto, współdzielonych między wszystkimi kluczami — to wystarczy dla skryptów działających według harmonogramu. Każda odpowiedź zawiera nagłówek X-RateLimit-Remaining. Po przekroczeniu limitu API zwraca 429 z nagłówkiem Retry-After; przed ponowną próbą należy odczekać podaną liczbę sekund.

Co możesz zrobić

API daje dostęp do odczytu artykułów i subskrypcji:

  • GET /api/v1/articles zwraca artykuły z Twoich kanałów, od najnowszych. Możesz filtrować według kanału, folderu lub daty publikacji i przeglądać wyniki stronicami (domyślnie 50 na żądanie, maksymalnie 200). Każdy artykuł zawiera tytuł, URL, nazwę kanału, autora, datę publikacji, fragment treści oraz informację o tym, czy został przeczytany lub oznaczony gwiazdką.
  • GET /api/v1/feeds wyświetla listę subskrypcji wraz z liczbą nieprzeczytanych artykułów i przypisanymi folderami.
  • GET /api/v1/usage pokazuje, ile żądań wykonał używany klucz w ciągu ostatniej godziny, 8 godzin i 24 godzin.

Zakładka API w Ustawieniach zawiera pełną listę parametrów i pól odpowiedzi.

Przykłady zastosowań

Codzienny digest e-mailowy

Napisz skrypt uruchamiany każdego ranka o 7:00, który pobiera artykuły z poprzedniego dnia i wysyła Ci e-mail z podsumowaniem. Filtruj według daty, przetwarzaj JSON przez jq, aby wyciągnąć tytuły i adresy URL, a wynik wyślij dowolnym narzędziem do e-maili lub powiadomień.

Sprawdzanie cichych kanałów

Kanały bywają zepsute: domeny wygasają, ścieżki się zmieniają, serwery przestają działać. API nie raportuje błędów pobierania ani daty ostatniej publikacji, ale cotygodniowy skrypt może wykryć kanały, które przestały publikować. Wylistuj swoje kanały, pobierz dla każdego z nich najnowsze artykuły z parametrami feedId i since, a następnie oznacz te, w których nic nie ukazało się przez ostatnie kilka tygodni. Jeśli masz wiele kanałów, rozłóż żądania w czasie, by nie przekroczyć limitu.

Cichy kanał nie zawsze oznacza zepsuty, ale lista podpowie Ci, które blogi warto sprawdzić.

Eksport do innych narzędzi

Pobieraj artykuły do lokalnej bazy danych, strony w Notion, repozytorium Obsidian lub arkusza kalkulacyjnego. API zwraca ustrukturyzowany JSON, więc transformacja to zazwyczaj kilka linijek jq lub krótki skrypt w Python.

Integracja z agentami AI

API współpracuje z narzędziami AI, które potrafią wykonywać żądania HTTP. Jeśli używasz asystenta takiego jak OpenClaw, możesz skierować go na SereneReader i zlecić mu przetwarzanie Twoich kanałów. Napisaliśmy o tym osobny wpis: Jak podłączyć kanały RSS do agentów AI.

Więcej pomysłów

Kilka innych rzeczy, które możesz zbudować w kilku linijkach: zadanie cron wysyłające Ci codziennie artykuły z wybranego folderu, alias powłoki sumujący liczbę nieprzeczytanych z /api/v1/feeds lub skrypt odpytujący, który publikuje nowe artykuły z jednego kanału na kanał Slack.

Do żadnego z tych zastosowań nie potrzebujesz frameworka. curl i jq pokrywają większość przypadków, a do pozostałych wystarczy dowolny język z klientem HTTP.

Utwórz swój klucz w Ustawieniach, w zakładce API.