SereneReader API로 자동화 구축하기

SereneReader/2026년 3월 7일/2026년 10월 6일 업데이트됨/api자동화

읽기를 자동화하는 이유

RSS는 여러 출처의 콘텐츠를 한 곳으로 모아줍니다. SereneReader API를 사용하면 그 콘텐츠를 스크립트, cron 작업 및 다른 도구로 가져올 수 있습니다.

인증은 API 키 하나로 충분합니다. 키를 생성하고, 각 HTTP 요청에 함께 보내면 JSON 응답을 받습니다. API는 읽기 전용이며 웹훅을 지원하지 않으므로, 스크립트는 일정에 따라 폴링합니다.

시작하기

API 액세스는 Pro(웹 기준 월 $5)와 Team 플랜에 포함되어 있습니다.

API 키 생성

SereneReader에서 설정을 열고 API 탭을 선택합니다. 키를 생성하고, 나중에 알아볼 수 있는 이름을 붙인 뒤, 안전한 곳에 복사해 두세요. 키는 한 번만 표시됩니다. Pro 계정은 최대 5개, Team 계정은 최대 10개의 키를 가질 수 있습니다.

인증

모든 요청에는 Authorization 헤더에 Bearer 토큰 형태로 키를 포함해야 합니다. 클라이언트 ID, 리프레시 토큰, 스코프는 필요하지 않습니다. 설정의 API 탭에서 기본 URL, 엔드포인트, 요청 예시를 확인할 수 있습니다.

요청 제한

API는 계정당 분당 30개의 요청을 허용하며, 모든 키가 이 한도를 공유합니다. 일정에 따라 실행되는 스크립트에는 충분한 수준입니다. 각 응답에는 X-RateLimit-Remaining 헤더가 포함됩니다. 한도를 초과하면 API는 429와 함께 Retry-After 헤더를 반환하며, 해당 초만큼 기다린 후 다시 시도하면 됩니다.

할 수 있는 것들

API는 아티클과 구독에 대한 읽기 권한을 제공합니다.

GET /api/v1/articles는 피드의 아티클을 최신순으로 반환합니다. 피드, 폴더, 발행일로 필터링하고 결과를 페이지 단위로 탐색할 수 있습니다(기본값 요청당 50개, 최대 200개). 각 아티클에는 제목, URL, 피드 이름, 작성자, 발행일, 요약, 읽음 여부 및 즐겨찾기 여부가 포함됩니다.
GET /api/v1/feeds는 구독 목록을 읽지 않은 수 및 폴더 정보와 함께 반환합니다.
GET /api/v1/usage는 현재 사용 중인 키가 지난 1시간, 8시간, 24시간 동안 몇 번의 요청을 했는지 보여줍니다.

설정의 API 탭에서 파라미터와 응답 필드의 전체 목록을 확인할 수 있습니다.

활용 사례

일일 요약 이메일

매일 아침 7시에 실행되는 스크립트를 작성해 전날의 아티클을 가져오고 요약 이메일을 보냅니다. 날짜로 필터링하고, jq로 JSON을 처리해 제목과 URL을 추출한 뒤, 원하는 이메일 또는 알림 도구로 결과를 전송하면 됩니다.

조용한 피드 확인

피드는 끊기기 마련입니다. 도메인이 만료되거나, 경로가 변경되거나, 서버가 다운될 수 있습니다. API는 가져오기 오류나 피드의 마지막 발행 시점을 직접 알려주지 않지만, 주간 스크립트로 조용해진 피드를 발견할 수 있습니다. 피드 목록을 가져오고, feedId와 since 파라미터로 각 피드의 최근 아티클을 요청한 뒤, 지난 몇 주 동안 아무것도 발행되지 않은 피드에 표시를 남기세요. 피드가 많다면 요청 속도를 조절해 요청 제한을 넘지 않도록 하세요.

조용한 피드가 반드시 고장난 피드는 아니지만, 목록을 통해 어떤 블로그를 직접 확인해야 할지 알 수 있습니다.

다른 도구로 내보내기

아티클을 로컬 데이터베이스, Notion 페이지, Obsidian 보관소 또는 스프레드시트로 가져올 수 있습니다. API는 구조화된 JSON을 반환하므로, 변환 작업은 대개 jq 몇 줄이나 짧은 Python 스크립트로 충분합니다.

AI 에이전트와 연동

API는 HTTP 요청을 보낼 수 있는 AI 도구와 함께 사용할 수 있습니다. OpenClaw 같은 어시스턴트를 사용한다면 SereneReader를 연결해 피드를 처리하도록 할 수 있습니다. 이에 대해 별도의 글을 작성했습니다: RSS 피드를 AI 에이전트에 연결하는 방법.

더 많은 아이디어

몇 줄로 만들 수 있는 것들이 더 있습니다. 특정 폴더의 오늘 아티클을 이메일로 보내는 cron 작업, /api/v1/feeds에서 읽지 않은 수를 합산하는 셸 별칭, 특정 피드의 새 아티클을 Slack 채널에 올리는 폴링 스크립트 등이 그 예입니다.

이 중 어느 것도 프레임워크가 필요하지 않습니다. 대부분의 경우 curl과 jq로 충분하고, 나머지는 HTTP 클라이언트가 있는 어떤 언어로도 처리할 수 있습니다.

설정의 API 탭에서 키를 생성하세요.