SereneReader API로 자동화 구축하기

읽기를 자동화하는 이유

RSS는 이미 어려운 부분을 해결해 줍니다. 수백 개의 출처에서 콘텐츠를 한 곳으로 모아주는 것이죠. SereneReader API를 사용하면 그 콘텐츠를 스크립트, cron 작업, 그리고 다른 도구에 프로그래밍 방식으로 가져올 수 있습니다.

설정할 웹훅도 없습니다. OAuth 절차도 없습니다. API 키를 생성하고, HTTP 요청을 보내고, JSON을 돌려받으면 됩니다.

시작하기

API 접근은 월 $5의 Pro 플랜에 포함되어 있으며, 엔터프라이즈 티어가 필요하지 않습니다. 대부분의 경쟁 RSS 리더는 API 접근을 더 높은 가격이나 최상위 플랜 뒤에 가두어 놓습니다.

API 키 만들기

SereneReader의 설정 페이지로 이동해 API 섹션으로 스크롤하세요. 새 키를 만들고, 나중에 알아볼 수 있는 이름을 붙인 뒤, 안전한 곳에 복사해 두세요. 키는 한 번만 표시됩니다.

인증

모든 요청에는 Authorization 헤더에 Bearer 토큰이 필요합니다. 그게 전부입니다. 클라이언트 ID도, 리프레시 토큰도, 스코프도 없습니다. API 설정 페이지에는 기본 URL, 엔드포인트 문서, 예시 요청이 있습니다.

속도 제한

API는 계정당 분당 30회 요청을 허용합니다. 일정에 따라 실행되는 스크립트에는 충분한 양입니다. 제한에 도달하면 잠시 기다렸다가 몇 초 후에 재시도하세요.

할 수 있는 것들

API는 아티클과 구독에 대한 읽기 접근을 제공합니다. 피드, 폴더, 또는 게시 날짜별로 아티클을 필터링할 수 있습니다. 읽지 않은 수와 함께 구독 목록을 조회할 수 있습니다. 모든 응답은 제목, URL, 게시 날짜, 요약, 피드 메타데이터가 포함된 JSON 형식입니다.

전체 엔드포인트 목록, 파라미터, 응답 형태는 설정 페이지의 API 문서 섹션에서 확인할 수 있습니다.

활용 사례

일일 다이제스트 이메일

매일 아침 7시에 실행되는 스크립트를 작성해 전날 아티클을 가져와 요약 이메일을 보내세요. 날짜별로 필터링하고, jq로 JSON을 파이프해 제목과 URL을 추출한 뒤, 원하는 알림 시스템으로 결과를 전달하면 됩니다.

데이터는 깔끔한 형식으로 준비되어 있어, 원하는 대로 가공할 수 있습니다.

피드 상태 모니터

피드는 종종 망가집니다. 도메인이 만료되거나, 경로가 바뀌거나, 서버가 다운되기도 합니다. 주간 스크립트로 구독 목록을 조회하고, 한동안 게시물이 없었던 피드를 확인할 수 있습니다.

피드가 조용해지면, 왜 그 블로그가 보이지 않는지 의아해하기 전에 미리 알 수 있습니다.

다른 도구로 내보내기

아티클을 로컬 데이터베이스, Notion 페이지, Obsidian 볼트, 또는 스프레드시트로 가져오세요. API가 구조화된 데이터를 제공하므로, 변환 단계는 보통 jq 몇 줄이나 짧은 Python 스크립트로 충분합니다.

AI 에이전트와 결합하기

API는 HTTP 요청을 만들 수 있는 AI 도구와 잘 어울립니다. OpenClaw 같은 에이전트 프레임워크를 사용하고 있다면, SereneReader를 연결해 피드를 자체적으로 처리하도록 할 수 있습니다. 이에 대한 별도 포스트를 작성했습니다: RSS 피드를 AI 에이전트에 연결하는 방법.

단순하게 유지하기

가장 좋은 자동화는 한 가지 일을 하는 짧은 스크립트입니다. 하루에 한 번 실행되는 cron 작업. 읽지 않은 수를 보여주는 셸 별칭. 아티클을 Slack 채널로 전달하는 웹훅 릴레이.

이를 위한 프레임워크는 필요하지 않습니다. curl과 jq로 대부분의 경우를 처리할 수 있습니다. 더 구조화된 것이 필요하다면, HTTP 클라이언트가 있는 어떤 언어든 동작합니다.

API 키와 엔드포인트 문서는 SereneReader 설정에서 확인할 수 있습니다.