AI Briefing
RSS · llms.txt · REST API

공개 피드와 API 문서

RSS는 구독과 크롤링에, llms.txt는 AI 에이전트의 사이트 구조 파악에, REST API는 페이지네이션·검색·소스 필터가 필요한 연동에 사용합니다. 모든 공개 피드와 공개 API는 처리 완료된 공개 기사와 활성 소스만 반환합니다.

RSS 구독최신순, 일일 인기순, 전체 조회순 피드를 RSS 2.0으로 제공합니다.llms.txtAI 에이전트가 핵심 페이지와 최신 공개 기사 링크를 빠르게 읽습니다.REST API기사, 검색, 소스, 태그 endpoint 목록을 JSON catalog로 확인합니다.

API 키 발급

서버·스크립트 등 외부(다른 출처)에서 /api/v1/*를 호출하려면 API 키가 필요합니다. 신청하면 운영자 승인 후 키가 발급됩니다. 앱 브라우저(같은 출처)는 키 없이 동작하며, RSS(/rss/*)와 llms.txt는 키 없이 공개됩니다.

현재 API는 무료 베타입니다

추후 일부 기능이 유료로 전환될 수 있습니다. 베타 기간 동안 발급된 키는 일일 호출 한도 안에서 무료로 사용할 수 있습니다.

불러오는 중...

RSS · llms.txt

RSS는 최대 50개 기사까지 반환하며, 같은 정렬·소스 조합은 서버 메모리에서 약 5분 동안 캐시됩니다. RSS item의 제목과 설명은 원문 전문이나 원문 RSS description이 아니라 AI Briefing에서 처리한 한국어 제목과 AI 요약을 사용합니다. 특정 소스만 구독하려면 RSS URL 뒤에 ?source=소스-slug를 붙입니다.

최신순 RSS/rss.xml · 기본 RSS 2.0 피드RSS alias/feed.xml · RSS 리더 자동 탐지용 alias최신순 명시 피드/rss/latest.xml · latest-first RSS일일 인기순 RSS/rss/daily-popular.xml · 최근 24시간 조회순전체 조회순 RSS/rss/most-viewed.xml · 전체 공개 기사 조회순llms.txt/llms.txt · AI 에이전트용 Markdown 사이트맵
/rss.xml?source=geeknews
/rss/daily-popular.xml?source=openai-blog
/llms.txt

공개 REST API

공개 읽기 endpoint는 API key 없이 사용할 수 있습니다. 일반적인 API 문서는 endpoint 표만 두지 않고 기본 URL, 인증 방식, rate limit, 요청 예시, 응답 형태, 오류 형태를 함께 제공합니다. 검색, 페이지네이션, 태그 탐색, 소스 필터가 필요한 연동에는 REST API를 사용하세요.

Base URLhttps://aibriefing.imbch.dev
Public authAPI key 없음
Read limitroute별 120/min
MethodEndpointPurpose
GET/api/v1Machine-readable catalog for public and user REST endpoints.
GET/api/v1/announcementCurrent public announcement banner settings.
GET/api/v1/articlesPublic processed articles from active sources.
GET/api/v1/articles/searchSearch public articles by keyword, source prefix, and tags.
GET/api/v1/articles/:idPublic article detail for a processed article from an active source.
GET/api/v1/articles/:id/relatedRelated public articles by shared tags and source fallback.
GET/api/v1/articles/trendingRecent high-score public articles.
GET/api/v1/articles/weekly-topTop public articles from the last week by view count.
GET/api/v1/releases/latestLatest GitHub release article per release source.
GET/api/v1/releasesGitHub release targets. targetKey returns target detail; versionId selects a release version.
GET/api/v1/source-categoriesSource category list.
GET/api/v1/sourcesActive public sources grouped by category.
GET/api/v1/tagsPopular public tags grouped by entity type.
GET/api/v1/tags/:slug/articlesPublic articles for a tag slug.
GET/api/v1/trending/githubGitHub trending repositories via GitHub API.
GET/api/v1/trending/huggingfaceTrending Hugging Face models via Hugging Face API.

요청 예시

/api/v1/articles?limit=10&sort=latest
/api/v1/articles?source=geeknews&limit=10
/api/v1/articles/search?q=Reddit:%20llm
/api/v1/sources
/api/v1/tags

응답 형태

{
  "data": [
    {
      "id": 123,
      "titleKo": "한국어 기사 제목",
      "hookTitleKo": "운영 정책에 따라 노출되는 훅 제목",
      "source": { "name": "GeekNews", "slug": "geeknews" },
      "publishedAt": "2026-04-29T00:00:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 42,
    "totalPages": 5
  }
}

오류 응답은 HTTP 상태 코드와 JSON 메시지를 함께 반환합니다. rate limit 초과 시에는429상태와 Retry-After 헤더를 확인합니다.

로그인 사용자 API

북마크, 좋아요, 싫어요, 읽음 기록, 즐겨찾기, 소스 건의는 Supabase access token이 필요합니다. 토큰은 Authorization: Bearer헤더로 전달합니다. 관리자 API는 공개 문서에서 제외합니다.

MethodEndpointPurpose
POST/api/v1/articles/:id/viewRecord an authenticated article view.
POST/api/v1/suggestionsSubmit a source suggestion for admin review.

운영 기준

RSS와 llms.txt는 구독·크롤링·AI 에이전트 읽기용 안정 인터페이스입니다. REST API는 앱 연동과 세부 필터용입니다. 공개 데이터 경계는 처리 완료 기사, 활성 소스, 일반 기사 표면으로 제한되며 사용자 개인 데이터와 관리자 운영 데이터는 포함하지 않습니다.

저장소 문서가 필요한 경우 docs/rss-llms.md와 docs/public-api.md를 함께 참고할 수 있습니다.