Next.jsのRoute HandlerでRSSフィードを自作する【検索から外す記事と、SNSに流したい記事を別フィードにした理由】
- この記事で分かること
- app/rss.xml/route.ts に Route Handler を置き、共通のXML組み立て関数でRSS 2.0を出力する実装。noindex記事を除いた通常フィードと、日誌だけを拾う専用フィードの2本立て
- 実際に使った環境
- Next.js 16.3.1(App Router)/ TypeScript。/rss.xml と /rss-trading-log.xml として、このブログで実際に配信している実装です
- 筆者の結論
- RSS 2.0のXMLは文字列を組み立てるだけで作れる。実装で迷ったのはXMLではなく、「検索に出さない記事」をSNSに流すかどうかという、記事の扱い方の方だった
RSSは、ブログの更新を機械が読める形で配信する仕組みです。読者がRSSリーダーで購読するほか、新着記事を検知してX(旧Twitter)などに自動投稿するサービスの入力としても使えます。このブログでは後者の用途で使っています。
この記事では、Next.jsのRoute Handlerで、外部ライブラリなしでRSSフィードを作る実装を紹介します。後半では、フィードを1本から2本に増やした経緯にも触れます。
🛠 実装してみて分かったこと
RSSのXMLを出力すること自体は簡単でした。考えさせられたのは、「検索エンジンに載せない記事を、SNSには流したいか」という問いです。この2つは別の判断なのに、最初の実装では同じ条件で扱っていたため、片方を決めるともう片方も決まってしまっていました。
Route HandlerでRSSを出力する
Next.jsのApp Routerでは、route.tsというファイルにHTTPメソッドごとの関数を書くと、そのパスのAPIとして動きます。RSSフィードは、app/rss.xml/route.tsに置くことで、/rss.xmlというURLで配信できます。
import { getIndexablePostSummaries } from "@/lib/posts";
import { buildRssXml } from "@/lib/rss";
// 予約投稿の記事が公開日を迎えたらフィードにも自動的に反映されるよう、1時間おきに再生成する。
export const revalidate = 3600;
export async function GET() {
const posts = getIndexablePostSummaries().slice(0, 30);
const xml = buildRssXml(posts, "/rss.xml");
return new Response(xml, {
headers: {
"Content-Type": "application/xml; charset=utf-8",
},
});
}やっていることは3つです。
- 記事の一覧を取得して、直近30件に絞る
- XMLの文字列を組み立てる
Content-Typeをapplication/xmlにして返す
予約投稿は、自動で載る
記事の一覧を取得する関数は、予約投稿(公開日が未来の記事)を最初から除外します。そのため、フィード側で公開日を判定する処理は書いていません。
export const revalidate = 3600は、このフィードを1時間ごとに再生成するという指定です。予約投稿の記事が公開日を迎えると、一覧にその記事が含まれるようになりますが、フィードがキャッシュされたままだと反映されません。1時間ごとに作り直すことで、公開日を迎えた記事が、遅くとも1時間程度でフィードに現れます。予約投稿の仕組みそのものは、予約投稿の実装記事で解説しています。
XMLを組み立てる
XMLの組み立ては、src/lib/rss.tsにまとめています。
export function buildRssXml(posts: PostSummary[], selfPath: string): string {
const items = posts
.map((post) => {
const category = categories.find((c) => c.slug === post.category);
const url = `${siteConfig.url}/blog/${post.slug}`;
const pubDate = new Date(`${post.date}T00:00:00+09:00`).toUTCString();
return `
<item>
<title>${escapeXml(post.title)}</title>
<link>${url}</link>
<guid isPermaLink="true">${url}</guid>
<pubDate>${pubDate}</pubDate>
${category ? `<category>${escapeXml(category.name)}</category>` : ""}
<description>${escapeXml(post.description)}</description>
</item>`;
})
.join("");
return `<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0">
<channel>
<title>${escapeXml(siteConfig.name)}</title>
<link>${siteConfig.url}</link>
<description>${escapeXml(siteConfig.description)}</description>
<language>ja</language>
<atom:link xmlns:atom="http://www.w3.org/2005/Atom" href="${siteConfig.url}${selfPath}" rel="self" type="application/rss+xml" />
${items}
</channel>
</rss>`;
}公開日は、日本時間の0時として扱う
記事のdateは"2026-10-11"のような日付だけの文字列です。RSSのpubDateにはタイムゾーン付きの日時が必要なので、T00:00:00+09:00を付けて日本時間の0時として解釈し、toUTCString()でRSSの形式に変換しています。タイムゾーンを付けずにnew Date("2026-10-11")と書くと、UTCの0時として扱われ、日本時間では午前9時になってしまうためです。
特殊文字は、エスケープする
export function escapeXml(value: string): string {
return value
.replace(/&/g, "&")
.replace(/</g, "<")
.replace(/>/g, ">")
.replace(/"/g, """)
.replace(/'/g, "'");
}XMLでは、&や<が特別な意味を持ちます。記事のタイトルや説明に「AT&T」や「<script>」のような文字列が含まれると、そのままではXMLが壊れ、フィード全体が読めなくなります。&を最初に置換しているのは、後から置換した<などの&が、二重にエスケープされないようにするためです。
guidはURLにする
<guid isPermaLink="true">に記事のURLを入れています。RSSを読むサービスは、このguidで「すでに見た記事か」を判断します。URLは記事ごとに固有で、変わらないものなので、guidに向いています。
RSSの存在を、ブラウザに知らせる
フィードを置いても、ブラウザやRSSリーダーが見つけられなければ、購読してもらえません。HTMLの<head>に、rel="alternate"のlinkタグを置いておくと、ブラウザやリーダーがフィードのURLを自動で検出できます。
通常、Next.jsではmetadataのalternatesにこの情報を書くのが自然ですが、このブログではlayout.tsxにlinkタグを直接書いています。
<link
rel="alternate"
type="application/rss+xml"
title={siteConfig.name}
href="/rss.xml"
/>理由は、各ページがmetadata.alternates.canonicalを個別に設定しているためです。Next.jsのmetadata APIは、alternatesオブジェクトをページ単位で丸ごと上書きします。canonicalとRSSのlinkが別々にマージされず、ページ側でcanonicalを指定したとたんに、レイアウトで書いたRSSの指定が消えてしまいます。React 19はhead向けのタグをどこに置いてもheadへ引き上げてくれるので、レイアウトに直接書くことで、全ページに必ず出るようにしました。
フィードを2本に分けた理由
最初は、フィードは/rss.xmlの1本でした。このフィードは、noindexの記事を含めていません。検索エンジンに載せたくない記事が、SNSの自動投稿を通じて結局広まってしまうのは、本末転倒だと考えたからです。
ところが、あとから問題に気づきました。このブログでは、AIの自動売買の日次記録(ai-trading-log-*)を、記事のslugで一律にnoindexにしています。通常のフィードはnoindexを除外するため、日誌がフィードに載らず、Xへの自動投稿からも漏れていました。
noindexは、検索エンジンに向けた指定です。SNSで共有するかどうかは、別の判断です。日誌は検索には載せなくても、Xでは読んでもらいたい。そこで、日誌だけを拾う専用のフィード/rss-trading-log.xmlを追加しました。
export async function GET() {
const posts = getTradingLogPostSummaries().slice(0, 30);
const xml = buildRssXml(posts, "/rss-trading-log.xml");
return new Response(xml, {
headers: { "Content-Type": "application/xml; charset=utf-8" },
});
}記事の一覧を取る関数が違うだけで、XMLの組み立ては共通のbuildRssXmlをそのまま使っています。XML組み立てを共通関数にしてあるので、2本目の追加は短いファイル1つで済みました。
| フィード | 元になる一覧 | noindexの記事 |
|---|---|---|
/rss.xml | 検索の対象になっている記事 | 載せない |
/rss-trading-log.xml | 日次の売買日誌だけ | 載せる(日誌は常にnoindex) |
サイト側だけでは、投稿は始まらない
ここまでは、サイト側でフィードを用意しただけです。Xへの自動投稿は、外部サービス(dlvr.it)が、登録されたフィードのURLを定期的に読みに来て、新しい記事を見つけたら投稿する仕組みです。そのため、新しいフィードのURLは、サービスの管理画面でソースとして登録する必要があります。サイト側の実装だけでは、自動投稿は始まりません。dlvr.itの設定そのものは、dlvr.itでXへ自動投稿する記事にまとめています。
よくある質問
Q. RSSフィードを作るのに、ライブラリは必要ですか?
A. このブログでは使っていません。RSS 2.0のXMLは構造が単純なので、テンプレート文字列で組み立てています。ただし、タイトルや説明文に&や<が含まれるとXMLとして壊れるため、エスケープ処理だけは自前で用意しています。
Q. 予約投稿の記事は、公開日前にRSSへ載ってしまいませんか? A. 載りません。フィードの元になる記事一覧を取得する関数が、公開判定を通った記事だけを返すためです。さらに、フィードは1時間ごとに再生成するので、公開日を迎えた記事は、遅くとも1時間程度で自動的にフィードに現れます。
Q. 新しいフィードを作っただけで、X(旧Twitter)への自動投稿は始まりますか? A. 始まりません。このブログでは、RSSをきっかけにXへ自動投稿する外部サービス(dlvr.it)を使っており、そのサービス側の管理画面で、新しいフィードのURLをソースとして登録する作業が別途必要です。サイト側の実装は、読み取ってもらえる状態を用意するところまでです。
まとめ
RSSフィードは、Route Handlerでテンプレート文字列を組み立てるだけで作れました。予約投稿は一覧の取得側で除外され、revalidateの設定で公開日を迎えたら自動的に載ります。
実装で一番考えたのは、XMLではなく、どの記事を載せるかでした。「検索に載せない」と「SNSに流す」は別の判断なので、フィードも別にしました。同じ条件で扱っていると、片方の都合でもう片方まで決まってしまいます。