← Back to blog

Tworzenie automatyzacji z API SereneReader

Po co automatyzować czytanie?

RSS rozwiązuje już najtrudniejszą część: zbieranie treści z setek źródeł w jednym miejscu. API SereneReader pozwala pobierać te treści do skryptów, zadań cron i innych narzędzi w sposób programowy.

Żadnych webhooków do konfigurowania. Żadnego tańca z OAuth. Wygeneruj klucz API, wysyłaj żądania HTTP, odbieraj JSON.

Pierwsze kroki

Dostęp do API jest dostępny w planie Pro za 5 USD/mies. — nie jest wymagany żaden plan enterprise. Większość konkurencyjnych czytników RSS blokuje dostęp do API za wyższymi lub najdroższymi planami.

Utwórz klucz API

Przejdź do strony ustawień w SereneReader i przewiń do sekcji API. Utwórz nowy klucz, nadaj mu nazwę, którą później rozpoznasz, i skopiuj go w bezpieczne miejsce. Klucz jest wyświetlany tylko raz.

Autoryzacja

Każde żądanie wymaga tokenu Bearer w nagłówku Authorization. To wszystko. Żadnych identyfikatorów klientów, żadnych tokenów odświeżania, żadnych zakresów. Na stronie ustawień API znajdziesz bazowy URL, dokumentację punktów końcowych i przykładowe żądania.

Limity żądań

API dopuszcza 30 żądań na minutę na konto. W zupełności wystarczy dla skryptów uruchamianych według harmonogramu. Jeśli osiągniesz limit, odczekaj chwilę i spróbuj ponownie po kilku sekundach.

Co możesz zrobić

API daje Ci dostęp do odczytu artykułów i subskrypcji. Filtruj artykuły według kanału, folderu lub daty publikacji. Wyświetlaj swoje subskrypcje wraz z liczbą nieprzeczytanych. Wszystkie odpowiedzi są w formacie JSON i zawierają tytuły, adresy URL, daty publikacji, fragmenty treści oraz metadane kanałów.

Pełna lista punktów końcowych, parametrów i struktur odpowiedzi znajduje się w sekcji dokumentacji API na stronie ustawień.

Przypadki użycia

Codzienny e-mail z podsumowaniem

Napisz skrypt, który uruchamia się każdego ranka o 7:00, pobiera wczorajsze artykuły i wysyła Ci e-mail ze streszczeniem. Filtruj według daty, przetwarzaj JSON przez jq, aby wyodrębnić tytuły i adresy URL, a następnie wyślij wynik do dowolnego wybranego systemu powiadomień.

Dane są dostępne w przejrzystym formacie, gotowe do dowolnego przetworzenia.

Monitor kondycji kanałów

Kanały się psują. Domeny wygasają, ścieżki się zmieniają, serwery padają. Tygodniowy skrypt może wylistować Twoje subskrypcje i sprawdzić, które z nich od jakiegoś czasu nic nie opublikowały.

Gdy kanał zamilknie, dowiesz się o tym, zanim zaczniesz zastanawiać się, dlaczego ten blog przestał się pojawiać.

Eksport do innych narzędzi

Pobieraj artykuły do lokalnej bazy danych, strony Notion, repozytorium Obsidian lub arkusza kalkulacyjnego. API dostarcza ustrukturyzowane dane, więc krok transformacji to zazwyczaj kilka linii jq lub krótki skrypt Python.

Połączenie z agentami AI

API dobrze współpracuje z narzędziami AI, które mogą wykonywać żądania HTTP. Jeśli korzystasz z frameworka agentowego takiego jak OpenClaw, możesz skierować go na SereneReader i pozwolić mu samodzielnie przetwarzać Twoje kanały. Napisaliśmy na ten temat osobny wpis: Jak połączyć kanały RSS z agentami AI.

Zachowaj prostotę

Najlepsze automatyzacje to krótkie skrypty robiące jedną rzecz. Zadanie cron uruchamiane raz dziennie. Alias powłoki pokazujący liczbę nieprzeczytanych. Przekaźnik webhooków przesyłający artykuły do kanału Slack.

Nie potrzebujesz do tego frameworka. curl i jq wystarczą w większości przypadków. Jeśli potrzebujesz czegoś bardziej zorganizowanego, sprawdzi się każdy język posiadający klienta HTTP.

Klucze API i dokumentacja punktów końcowych są dostępne w ustawieniach SereneReader.