> ## 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 フィード**。共通ルールは [通知の仕組み](/ja/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 文字 — この機能を持つ 2 プラットフォームの 1 つ |
| **Mention Role**              | なし     |                                                |
| **Custom Notification Embed** | RSS 既定 | オレンジ                                           |

## 変数

| 変数                   | 解決先          |
| -------------------- | ------------ |
| `{item.title}`       | アイテムタイトル     |
| `{item.url}`         | アイテムへのリンク    |
| `{item.description}` | 要約または本文      |
| `{item.author}`      | 著者           |
| `{feed.name}`        | フィードのタイトル    |
| `{feed.url}`         | フィードのサイト URL |

<Note>
  `{item.description}` にどれだけのテキストが含まれるかは完全に発行者次第です。1 行の要約だけのものもあれば、記事全文のものもあります。Vetox は切り詰めませんが、Discord の 4,096 文字の説明制限が適用されます。
</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 でなく Web ページに見えるならフィード 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="/ja/notifications/podcasts">
  同じフィード機構の専用ビュー。
</Card>