AIツクリラボ
・Next.js制作Tips・12分で読めます・🔵 実装記録

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つです。

  1. 記事の一覧を取得して、直近30件に絞る
  2. XMLの文字列を組み立てる
  3. 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, "&amp;")
    .replace(/</g, "&lt;")
    .replace(/>/g, "&gt;")
    .replace(/"/g, "&quot;")
    .replace(/'/g, "&apos;");
}

XMLでは、&や<が特別な意味を持ちます。記事のタイトルや説明に「AT&T」や「<script>」のような文字列が含まれると、そのままではXMLが壊れ、フィード全体が読めなくなります。&を最初に置換しているのは、後から置換した&lt;などの&が、二重にエスケープされないようにするためです。

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に流す」は別の判断なので、フィードも別にしました。同じ条件で扱っていると、片方の都合でもう片方まで決まってしまいます。

この記事を書いた人

ラボ管理人

AIツール・ノーコード・Next.jsで実際に手を動かしながら、AIツクリラボを運営しています。

運営者情報を見る →