> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vetox.io/llms.txt
> Use this file to discover all available pages before exploring further.

# RSS 알림

> RSS 또는 Atom 피드의 새 항목을 Discord 서버에 알립니다.

<Info>
  **Basic**이 필요합니다. 서버당 최대 **10개 피드**. 공통 규칙은 [알림 작동 방식](/ko/notifications/overview)을 참고하세요.
</Info>

RSS는 만능 도구입니다. 사이트가 피드를 게시한다면 Vetox가 알림할 수 있습니다 — 블로그, 변경 로그, 뉴스 사이트, 포럼 섹션, 릴리스 노트.

## 피드 추가

피드 URL을 붙여넣으세요. Vetox가 저장 전에 이를 가져와 파싱합니다; 읽을 수 있는 피드가 아니면 **Invalid RSS feed URL or unable to parse feed**로 거절됩니다.

<Tip>
  사이트 URL이 아니라 피드 URL을 사용하세요. 보통 `/feed`, `/rss`, `/atom.xml`, `/index.xml`로 끝납니다. 확실하지 않다면 페이지 소스를 열어 `application/rss+xml` 링크를 찾으세요.
</Tip>

## 설정

| 설정                            | 기본값    | 설명                                      |
| ----------------------------- | ------ | --------------------------------------- |
| **Discord Channel**           | —      | 필수                                      |
| **Notify on New Items**       | **켬**  |                                         |
| **Custom Message**            | 없음     | 일반 텍스트, 최대 2,000자 — 이 옵션이 있는 두 플랫폼 중 하나 |
| **Mention Role**              | 없음     |                                         |
| **Custom Notification Embed** | RSS 기본 | 주황                                      |

## 변수

| 변수                   | 해석          |
| -------------------- | ----------- |
| `{item.title}`       | 항목 제목       |
| `{item.url}`         | 항목 링크       |
| `{item.description}` | 항목 요약 또는 본문 |
| `{item.author}`      | 저자          |
| `{feed.name}`        | 피드 제목       |
| `{feed.url}`         | 피드의 사이트 URL |

<Note>
  `{item.description}`이 얼마나 많은 텍스트를 담는지는 전적으로 게시자에 달려 있습니다. 어떤 피드는 한 줄 요약을, 어떤 피드는 전체 기사를 제공합니다. Vetox는 이를 자르지 않지만 Discord의 4,096자 description 한도가 적용됩니다.
</Note>

## 무엇이 알림되나

**5분마다** 확인하고 피드당 **5분 쿨다운**을 적용합니다.

<Warning>
  **RSS에는 폴링당 상한이 없습니다.** 다른 플랫폼은 최근 5개 항목을 보지만 RSS는 피드의 모든 항목을 후보로 고려합니다.

  실제로는 2시간 나이 컷오프와 7일 확인 목록이 이를 통제합니다. 하지만 최근 날짜로 여러 항목을 갑자기 다시 게시하는 피드는 알림의 폭발을 유발할 수 있습니다.
</Warning>

<Note>
  읽을 수 있는 게시일이 없는 항목은 2시간 나이 컷오프를 우회합니다. 그래서 형식이 나쁜 피드는 오래된 항목을 알림할 수 있습니다. 어떤 피드가 이를 반복한다면 그것은 Vetox가 아니라 피드의 결함입니다.
</Note>

Vetox는 조건부 요청을 사용하므로 변경되지 않은 피드는 확인 비용이 거의 없습니다.

## 실제 예시

<AccordionGroup>
  <Accordion title="게임의 패치 노트">
    많은 스튜디오가 변경 로그 피드를 게시합니다. Steam 통합보다 자주 나은데, 공식 게시물만 담기 때문입니다.
  </Accordion>

  <Accordion title="상태 페이지">
    대부분의 상태 페이지가 피드를 노출합니다. 커뮤니티에 영향을 주는 장애를 조기 경보로 받으려면 스태프 채널로 라우팅하세요.
  </Accordion>

  <Accordion title="블로그 또는 뉴스레터">
    임베드 제목에 `{item.title}`, 본문에 `{item.description}`, 링크에 `{item.url}`.
  </Accordion>
</AccordionGroup>

## 문제 해결

<AccordionGroup>
  <Accordion title="피드가 저장되지 않아요">
    Vetox가 그 순간 가져와 파싱할 수 있어야 합니다. 브라우저에서 URL을 확인하세요 — XML이 아니라 웹 페이지로 렌더링된다면 그건 피드 URL이 아닙니다.

    가져오기 자체에도 제한이 있습니다. 피드가 **10초** 안에 응답하지 않거나, **5 MB**를 초과하거나, **3회**를 초과해 리디렉션하면 거부됩니다. 주소는 `http://` 또는 `https://` 여야 하며 공개 호스트로 확인되어야 합니다 — 사설, 로컬, 내부 네트워크 주소는 거부됩니다.
  </Accordion>

  <Accordion title="오래된 항목이 알림되었어요">
    피드가 사용 가능한 게시일을 제공하지 않아서 나이 컷오프가 적용될 수 없습니다.
  </Accordion>

  <Accordion title="한 번에 알림이 몰려왔어요">
    게시자가 여러 항목의 날짜를 다시 매겼습니다. 피드당 쿨다운을 넘어서는 요청 제한은 없습니다.
  </Accordion>

  <Accordion title="설명이 비어 있어요">
    그 피드가 이를 포함하지 않습니다. 대신 `{item.title}`과 `{item.url}`을 사용하세요.
  </Accordion>
</AccordionGroup>

<Card title="팟캐스트" icon="podcast" horizontal href="/ko/notifications/podcasts">
  같은 피드 메커니즘의 특수화된 뷰.
</Card>