@roottale/cms-mcp 0.35.0 → 0.37.0

package/CHANGELOG.md

@@ -1,5 +1,49 @@
 # @roottale/cms-mcp
 
+## 0.37.0
+
+### Minor Changes
+
+- de62ad1: 작가 아카이브 페이지 + 작가 사이트맵 (blanche식 /blog/author/{slug})
+  - `fetchAuthors()` 추가 (`GET /v1/cms/public/authors`) — slug가 있고 발행 글이 1건
+    이상인 작가 목록(slug·이름·이미지·소개·글 수·최근 수정일). 어드민 **설정 > 팀**에서
+    작가 slug를 발급한다(site 내 unique).
+  - `RootTaleBlogList` 에 `author` prop, `fetchPosts` 에 `author` 옵션 추가 —
+    `GET /v1/cms/public/posts?author={slug}` 로 그 작가의 발행 글만 렌더(작가 아카이브용).
+  - `createSitemapIndex` 에 `authors` 하위 사이트맵(`/sitemap/authors.xml`) 추가 — 어드민
+    **설정 > 블로그 > 사이트맵**의 "작가 사이트맵"(`authors`) 토글이 켜졌을 때만 인덱스에
+    포함. `authorBasePath` 옵션(기본 `/blog/author`)으로 경로 커스터마이즈.
+  - starter 에 `app/blog/author/[slug]/page.tsx` 추가 + cms-mcp seo.md 문서 갱신.
+
+- c77238d: 사이트맵 다국어 hreflang (스캐폴딩)
+  - `createSitemapIndex` 가 사이트맵 설정의 `locales`(예 `["ko","ja","en"]`)가 있으면
+    모든 섹션(static/blog/categories/authors) entry 에 `alternates.languages`(hreflang)
+    를 단다. 첫 로케일 = 기본(현 URL) + `x-default`, 나머지는 path-prefix(`/ja/...`).
+    어드민 **설정 > 블로그 > 사이트맵** 의 "다국어 로케일"에서 입력.
+  - 같은 slug + 언어 접두사 1:1 을 가정하는 스캐폴딩 — 실제 per-locale 페이지 서빙은
+    사이트 책임(번역 콘텐츠 모델 도입 시 재방문). 비우면 단일 언어(기본).
+  - 어드민 사이트맵 카드에 "작가 사이트맵"(authors) 토글도 노출 — 작가 사이트맵을
+    UI 에서 켤 수 있다.
+
+- 36e2dae: 사이트맵 인덱스 분리 + 블로그 이미지 색인 (blanche식)
+  - `createSitemapIndex(config, staticRoutes, opts)` 추가 — Next 16 `generateSitemaps`
+    로 `/sitemap.xml`(인덱스) + `/sitemap/static.xml`·`/sitemap/blog.xml`·
+    `/sitemap/categories.xml` 하위 사이트맵으로 분리. 50k URL/50MB 한도 확장 + 검색엔진
+    섹션별 크롤. 소비자는 `export { generateSitemaps }; export default sitemap;`.
+  - 블로그 글 entry 에 대표 이미지(`featuredImageUrl`)를 `<image:image>` 로 색인 —
+    어드민 **설정 > 블로그 > 사이트맵**의 토글(`blogImages`)로 제어. `RootTaleBlogSettings.sitemap`
+    (`/v1/cms/public/blog-settings` 응답)에 사이트맵 정책(`blogImages`/`locales`/`authors`) 추가.
+  - `changeFrequency`/`priority` 는 더 이상 emit 하지 않음(Google 무시 — `loc`+`lastmod` +이미지만). 레거시 `createSitemap`(단일 평면)은 deprecate 되었으나 하위호환 유지.
+
+## 0.36.0
+
+### Patch Changes
+
+- 1fe867f: 문서 갱신 — 블로그 설정 응답의 글 하단 CTA(`post_cta`)와 사이트 SEO 기본값
+  (`site_profile`: 설명·로고·파비콘·기본 OG)을 api-reference / blog 가이드에 반영.
+  CTA 는 `RootTaleBlogPost` 가 본문 끝에 자동 렌더하고, `site_profile` 은 외부
+  사이트가 head + OG 폴백으로 사용한다.
+
 ## 0.35.0
 
 ### Minor Changes

package/dist/index.js

@@ -279,7 +279,7 @@ function registerTools(server2) {
 }
 
 // src/server.ts
-var VERSION = true ? "0.35.0" : "dev";
+var VERSION = true ? "0.37.0" : "dev";
 var SERVER_INSTRUCTIONS = `
 roottale-cms-mcp\uB294 RootTale CMS\uB97C \uC678\uBD80 \uC0AC\uC774\uD2B8(\uC8FC\uB85C Next.js)\uC5D0 \uC5F0\uB3D9\uD558\uAE30 \uC704\uD55C
 \uD1B5\uD569 \uBB38\uC11C\xB7\uC608\uC2DC \uCF54\uB4DC\xB7\uACF5\uAC1C API \uC870\uD68C tool\uC744 \uC81C\uACF5\uD569\uB2C8\uB2E4.

package/docs/api-reference.md

@@ -113,16 +113,29 @@ fallback 네비를 렌더하세요 (`menus.md` 참고).
 
 ## GET /v1/cms/public/blog-settings
 
-블로그 표시 설정 (TOC·작성자·발행일·작성자 카드, 저자 프로필).
+블로그 표시 설정 (TOC·작성자·발행일·작성자 카드, 저자 프로필, 글 하단 CTA).
+`post_cta` 는 admin 에서 활성화하고 버튼 문구·링크를 채웠을 때만 객체이며,
+그 외에는 `null`. `RootTaleBlogPost` 가 본문 끝에 자동으로 렌더하므로 별도
+연동 코드는 필요 없다.
 
 ```json
 { "show_table_of_contents": false, "show_author": true, "show_date": true,
   "show_author_card": true, "toc_title": null,
   "author_profile_name": null, "author_profile_bio": null,
   "author_profile_image_url": null, "author_profile_image_radius": "circle",
+  "site_profile": { "site_description": null, "logo_url": null,
+    "favicon_url": null, "default_og_image_url": null },
+  "post_cta": { "title": "상담이 필요하신가요?", "description": "첫 상담은 무료입니다.",
+    "button_label": "상담 문의하기", "button_href": "/contact" },
   "updated_at": null }
 ```
 
+`site_profile` 은 사이트 공통 SEO 값. `default_og_image_url`(1200×630 권장)은
+글에 대표/OG 이미지가 없을 때 SNS 공유 썸네일 폴백으로 쓰세요 —
+`generateMetadata` 에서 `post.seo?.ogImage ?? post.featured_media_url ??
+settings.siteProfile.defaultOgImageUrl` 순으로 우선합니다. `logo_url`·
+`favicon_url`·`site_description` 은 사이트 `<head>` 에 적용합니다.
+
 ## GET /v1/cms/public/site-knowledge
 
 사이트 지식 — 브랜드 보이스(어조·톤·화자) + 용어 규칙(금지어·교정어). AI

package/docs/blog.md

@@ -38,6 +38,22 @@ export default function BlogPage() {
 }
 ```
 
+> **공지·블로그를 나눈 사이트(ADR-0060)는 목록을 반드시 섹션으로 스코프하세요.**
+> `RootTaleBlogList` 는 기본적으로 **모든 글**을 렌더하므로, 섹션을 나눴는데
+> `collection` 을 안 주면 공지 글이 `/blog` 목록에 섞여 나옵니다. 각 목록 페이지에서
+> `collection`+`collections` 를 넘겨 그 섹션 글만 보이게 하세요(글 링크도 소속 섹션
+> basePath 로 자동 라우팅). 단일 블로그 사이트는 지금처럼 안 줘도 됩니다.
+>
+> ```tsx
+> import { COLLECTIONS } from "@/lib/collections"; // collections.md 참고
+> // app/notice/page.tsx
+> <RootTaleBlogList apiKey={apiKey} collection="notice" collections={COLLECTIONS} />
+> // app/blog/page.tsx
+> <RootTaleBlogList apiKey={apiKey} collection="blog" collections={COLLECTIONS} showCategoryFilter />
+> ```
+>
+> 자세한 내용은 `collections.md` 참고.
+
 ### 상세 페이지
 
 ```tsx
@@ -65,7 +81,9 @@ export default async function PostPage({
 ```
 
 목차(ToC)·작성자 카드·발행일 표시는 어드민의 블로그 표시 설정으로도 제어됩니다
-(`theme-and-settings.md` 참고).
+(`theme-and-settings.md` 참고). 어드민 설정 > 블로그에서 **글 하단 CTA**(제목·설명·
+버튼)를 켜면 `RootTaleBlogPost` 가 모든 글 본문 끝에 같은 CTA 블록을 자동으로
+렌더합니다 — 별도 연동 코드는 필요 없습니다.
 
 #### 목차 블록 (본문 임의 위치)
 
@@ -147,6 +165,7 @@ export async function getPost(slug: string) {
 ```tsx
 // app/blog/[slug]/page.tsx (커스텀 UI 버전)
 import type { Metadata } from "next";
+import { buildPostMetadata } from "@roottale/cms-renderer-next/routes";
 import { getAllPosts, getPost } from "@/lib/blog";
 
 export async function generateStaticParams() {
@@ -162,18 +181,27 @@ export async function generateMetadata({
   const { slug } = await params;
   const post = await getPost(slug);
   if (!post) return {};
-  // 어드민 글 에디터의 SEO 패널 값(metaJson.seo)을 우선 적용
-  const seo = (post.metaJson as { seo?: Record<string, string | boolean> })?.seo;
-  return {
-    title: (seo?.title as string) || post.title,
-    description: (seo?.description as string) || post.excerpt,
-    ...(seo?.noindex || seo?.nofollow
-      ? { robots: { index: !seo?.noindex, follow: !seo?.nofollow } }
-      : {}),
-  };
+  // 어드민 글 에디터의 SEO 패널(metaJson.seo) override 적용 + self-canonical.
+  // canonical/robots/openGraph 분기를 직접 안 써도 한 곳도 빠뜨리지 않습니다.
+  return buildPostMetadata(post, {
+    siteUrl: process.env.NEXT_PUBLIC_SITE_URL,
+    path: `/blog/${post.slug}`,
+  });
 }
 ```
 
+`buildPostMetadata(post, opts)`는 어드민 SEO 패널 값을 Next `Metadata`로
+한 줄 변환합니다:
+
+- `seo.title`/`seo.description`/`seo.ogImage` 가 있으면 우선, 없으면 글 값으로 fallback
+- `seo.canonical` override → 없으면 `siteUrl`+`path` 로 self-canonical 자동 생성
+- `seo.noindex`/`seo.nofollow` 중 하나라도 켜지면 `robots` 출력
+- `openGraph`(article·publishedTime·images) 자동 구성
+
+입력은 `{ title, description?, date?, image?, seo? }` 형태면 되고
+(`getPost` 의 `BlogPostMeta` 가 그대로 호환), 원본 post 를 쓸 땐
+`seo: (post.metaJson as { seo?: ... }).seo` 로 넘기세요.
+
 SEO 오버라이드 필드: `title`, `description`, `canonical`, `ogImage`,
 `noindex`, `nofollow`.
 

package/docs/collections.md

@@ -115,10 +115,13 @@ export const COLLECTIONS: RouteCollection[] = [
 
 ```ts
 // app/sitemap.ts
-import { createSitemap } from "@roottale/cms-renderer-next/routes";
-export default createSitemap({ apiKey, siteUrl, title, collections: COLLECTIONS }, [
-  /* 정적 경로 */
-]);
+import { createSitemapIndex } from "@roottale/cms-renderer-next/routes";
+const { generateSitemaps, sitemap } = createSitemapIndex(
+  { apiKey, siteUrl, title, collections: COLLECTIONS },
+  [ /* 정적 경로 */ ],
+);
+export { generateSitemaps };
+export default sitemap;
 
 // app/feed.xml/route.ts
 export const dynamic = "force-dynamic";
@@ -144,7 +147,12 @@ async function getCollections(): Promise<RouteCollection[]> {
   }
 }
 
-export default createSitemap({ apiKey, siteUrl, title, collections: getCollections }, [ ]);
+const { generateSitemaps, sitemap } = createSitemapIndex(
+  { apiKey, siteUrl, title, collections: getCollections },
+  [ ],
+);
+export { generateSitemaps };
+export default sitemap;
 export const GET = createFeedRoute({ apiKey, siteUrl, title, collections: getCollections });
 ```
 
@@ -152,6 +160,47 @@ export const GET = createFeedRoute({ apiKey, siteUrl, title, collections: getCol
 응답은 `RouteCollection`과 구조 호환이라 그대로 넘길 수 있습니다. 매 요청 fetch를 피하려면
 사이트 경계에서 캐시하세요(예: Next `fetch(url, { next: { revalidate: 300 } })`).
 
+### 섹션 목록 페이지 (공지/블로그 분리 렌더)
+
+각 섹션 목록은 `RootTaleBlogList` 에 **`collection`+`collections`** 를 넘겨 그 섹션
+글만 보이게 합니다. **이걸 안 주면 컴포넌트가 전체 글을 렌더**하므로 공지 글이
+`/blog` 목록에 섞여 들어옵니다(섹션을 나눈 사이트의 가장 흔한 버그). `collections`
+를 주면 글 링크도 소속 섹션 basePath 로 자동 라우팅됩니다(공지→`/notice/{slug}`).
+
+```tsx
+import { RootTaleBlogList } from "@roottale/cms-renderer-next/server";
+import { COLLECTIONS } from "@/lib/collections"; // 위 "방식 A" 의 상수
+
+// app/notice/page.tsx — 공지 게시판
+export default function NoticePage() {
+  return (
+    <RootTaleBlogList
+      apiKey={process.env.ROOTTALE_API_KEY!}
+      collection="notice"
+      collections={COLLECTIONS}
+    />
+  );
+}
+
+// app/blog/page.tsx — 블로그
+export default function BlogPage() {
+  return (
+    <RootTaleBlogList
+      apiKey={process.env.ROOTTALE_API_KEY!}
+      collection="blog"
+      collections={COLLECTIONS}
+      showCategoryFilter
+    />
+  );
+}
+```
+
+`RootTaleBlogCategories` 도 같은 `collection`+`collections` 를 받아 그 섹션의 주제만
+집계합니다. 카테고리 칩/사이드바를 섹션별로 나눌 때 쓰세요.
+
+> 동적 basePath(어드민에서 자유 편집)나 catch-all 라우트를 쓰면 `collection` 값을
+> 요청 경로에서 판정해 넘기세요(아래 "동적 basePath" 참고).
+
 ### 상세 페이지 가드 (섹션 누출 차단)
 
 상세 라우트는 글이 그 섹션 소속인지 확인해 다른 섹션 글이 새는 것을 막습니다.
@@ -165,6 +214,23 @@ const post = await getPost(slug);
 if (!post || resolvePostCollection(post, COLLECTIONS)?.key !== "blog") notFound();
 ```
 
+### 상세 페이지 메타데이터 (canonical 공지/블로그 구분)
+
+상세 라우트의 `generateMetadata` 도 `collections` 를 넘겨야 canonical 이 글의
+섹션에 맞게 나옵니다. `path` 를 `/blog/...` 로 하드코딩하면 공지 글이 잘못된
+블로그 canonical 을 갖게 됩니다.
+
+```ts
+import { buildPostMetadata } from "@roottale/cms-renderer-next/routes";
+// app/blog/[slug]/page.tsx (공지면 app/notice/[slug])
+return buildPostMetadata(post, {
+  siteUrl: process.env.NEXT_PUBLIC_SITE_URL,
+  collections: COLLECTIONS, // 글의 collectionKey 로 /notice·/blog canonical 자동 해석
+});
+```
+
+자세한 동작은 `seo.md` 의 "글 메타데이터 → 공지·블로그 다중 스트림" 참고.
+
 ### revalidate
 
 ```ts

package/docs/seo.md

@@ -29,13 +29,18 @@ export const GET = createFeedRoute({
 
 ## 사이트맵
 
+`createSitemapIndex`는 **사이트맵 인덱스**(`/sitemap.xml`)와 섹션별 하위 사이트맵
+(`/sitemap/static.xml`·`/sitemap/blog.xml`·`/sitemap/categories.xml`)을 만듭니다.
+하나의 거대한 파일 대신 섹션별로 나뉘어 검색엔진이 더 잘 크롤하고, 50,000 URL/50MB
+한도에도 안전합니다. 발행 글·카테고리는 자동 포함됩니다.
+
 ```ts
 // app/sitemap.ts
-import { createSitemap } from "@roottale/cms-renderer-next/routes";
+import { createSitemapIndex } from "@roottale/cms-renderer-next/routes";
 
 const SITE_URL = process.env.NEXT_PUBLIC_SITE_URL!;
 
-export default createSitemap(
+const { generateSitemaps, sitemap } = createSitemapIndex(
   {
     apiKey: process.env.ROOTTALE_API_KEY!,
     apiBase: process.env.ROOTTALE_API_BASE,
@@ -43,14 +48,77 @@ export default createSitemap(
     title: "예시 사이트",
   },
   [
-    // 정적 경로 — 발행 글 URL은 자동 추가됨
-    { url: SITE_URL, changeFrequency: "weekly", priority: 1.0 },
-    { url: `${SITE_URL}/blog`, changeFrequency: "weekly", priority: 0.7 },
-    { url: `${SITE_URL}/contact`, changeFrequency: "monthly", priority: 0.9 },
+    // 정적 경로 — 발행 글·카테고리 URL은 자동 추가됨
+    { url: SITE_URL },
+    { url: `${SITE_URL}/blog` },
+    { url: `${SITE_URL}/contact` },
   ],
 );
+
+// Next 16: 인덱스를 만들려면 generateSitemaps·default 를 둘 다 export.
+export { generateSitemaps };
+export default sitemap;
+```
+
+- **블로그 이미지 색인** — 글에 대표 이미지가 있으면 `<image:image>`로 함께 색인합니다.
+  어드민 **설정 > 블로그 > 사이트맵**에서 켜고 끌 수 있어요(기본 켜짐).
+- `changeFrequency`/`priority`는 Google이 무시하므로 더 이상 내보내지 않습니다(`loc` +
+  `lastmod` + 이미지만).
+- 단일 평면 사이트맵이 필요하면 레거시 `createSitemap`(default export 하나)도 그대로
+  동작하지만, 신규 사이트는 `createSitemapIndex`를 권장합니다.
+
+### 작가 아카이브 (`/blog/author/{slug}`)
+
+어드민 **설정 > 팀**에서 작가에게 주소(slug)를 발급하면, 그 작가의 글 모음 페이지와
+작가 사이트맵(`/sitemap/authors.xml`)을 만들 수 있습니다. 어드민 **설정 > 블로그 >
+사이트맵**에서 "작가 사이트맵"을 켜면 인덱스에 `authors` 섹션이 추가됩니다.
+
+```ts
+// app/blog/author/[slug]/page.tsx
+import { notFound } from "next/navigation";
+import { fetchAuthors } from "@roottale/cms-client/server";
+import { RootTaleBlogList } from "@roottale/cms-renderer-next/server";
+
+export default async function AuthorArchive({
+  params,
+}: {
+  params: Promise<{ slug: string }>;
+}) {
+  const { slug } = await params;
+  const authors = await fetchAuthors({ apiKey: process.env.ROOTTALE_API_KEY! });
+  const author = authors.find((a) => a.slug === slug);
+  if (!author) notFound();
+
+  return (
+    <>
+      <h1>{author.name}</h1>
+      {author.bio ? <p>{author.bio}</p> : null}
+      {/* author= 로 그 작가의 발행 글만 렌더 */}
+      <RootTaleBlogList apiKey={process.env.ROOTTALE_API_KEY!} author={slug} />
+    </>
+  );
+}
 ```
 
+- `fetchAuthors()` 는 slug가 있고 발행 글이 1건 이상인 작가만 반환합니다
+  (`GET /v1/cms/public/authors`).
+- `RootTaleBlogList`에 `author={slug}` 를 주면 그 작가의 글만 가져옵니다
+  (`GET /v1/cms/public/posts?author={slug}`).
+
+### 다국어 (hreflang)
+
+번역 페이지가 있는 사이트는 어드민 **설정 > 블로그 > 사이트맵**의 "다국어 로케일"에
+언어 코드를 입력하면(예: `ko, ja, en`), 사이트맵의 모든 항목에 `hreflang` 대체 언어
+링크(`<xhtml:link rel="alternate">`)가 붙습니다.
+
+- **첫 번째** 로케일이 기본 언어(현재 URL 그대로) + `x-default`.
+- 나머지는 **경로 접두사**로 매핑됩니다 — `ko`가 기본이면 `ja`는
+  `/ja/blog/{slug}`, `en`은 `/en/blog/{slug}`.
+- 같은 slug에 언어 접두사만 붙는 1:1 구조를 가정합니다. **실제 번역 페이지를
+  그 경로(`/ja/...`)에 서빙하는 것은 사이트 쪽 책임**입니다 — 사이트맵은 검색엔진에
+  대체 언어를 알릴 뿐입니다.
+- 비워두면 단일 언어로 동작합니다(기본).
+
 ## 다중 스트림 (collections) — 공지·블로그 분리
 
 같은 글 풀을 공지 게시판(`/notice`) + 블로그(`/blog`) 등 여러 섹션으로 나눠 서로 다른
@@ -114,6 +182,68 @@ const crumbs = breadcrumbSchema([
 발행 웹훅의 `alsoRevalidate`에 `/feed.xml`, `/sitemap.xml`을 포함해 글 변경
 시 함께 갱신하세요 (`revalidation-webhooks.md` 참고).
 
+## 글 메타데이터 (canonical·robots·OG)
+
+블로그 글 상세의 `generateMetadata` 에서 어드민 SEO 패널(`metaJson.seo`) 값을
+`buildPostMetadata` 로 한 줄 변환합니다. canonical/robots/openGraph 분기를
+직접 쓰면 한 곳이라도 빠뜨려 SEO 가 새기 쉬운데(특히 noindex 누락·canonical
+미설정), 이 헬퍼로 표준화합니다.
+
+```tsx
+// app/blog/[slug]/page.tsx
+import type { Metadata } from "next";
+import { buildPostMetadata } from "@roottale/cms-renderer-next/routes";
+
+export async function generateMetadata({ params }: Props): Promise<Metadata> {
+  const { slug } = await params;
+  const post = await getPost(slug);
+  if (!post) return {};
+  return buildPostMetadata(post, {
+    siteUrl: process.env.NEXT_PUBLIC_SITE_URL, // self-canonical 기본값 origin
+    path: `/blog/${post.slug}`, // 현재 slug 기준
+  });
+}
+```
+
+- `seo.title`/`seo.description`/`seo.ogImage` override → 없으면 글 값 fallback
+- canonical: `seo.canonical` override → 없으면 `siteUrl`+`path` 로 **self-canonical
+  자동 생성**(모든 글이 자기 자신을 가리키는 canonical 을 갖도록 — 권장).
+  `siteUrl`/`path` 를 안 넘기면 override 가 있을 때만 canonical 출력.
+- `seo.noindex`/`seo.nofollow` 중 하나라도 켜지면 `robots` 출력
+- `openGraph`(type:`article`·`publishedTime`·`images`) 자동 구성
+
+입력은 `{ title, description?, date?, image?, seo? }` 구조면 됩니다(`getPost`
+의 `BlogPostMeta` 호환). 원본 post 를 쓸 땐 `seo: (post.metaJson as {
+seo?: PostSeoOverrides }).seo` 로 넘기세요. `path` 는 redirect 후의 **현재
+slug**(`post.slug`) 기준으로 주세요(아래 301 참고).
+
+### 공지·블로그 다중 스트림 (ADR-0060)
+
+섹션을 나눈 사이트(공지 `/notice` + 블로그 `/blog`)는 `path` 를 직접 쓰지 말고
+**`collections` 를 넘기세요.** 글의 `collectionKey` 로 소속 섹션 basePath 를 찾아
+canonical 을 **공지/블로그로 구분**해 해석합니다(공지 글 → `/notice/{slug}`, 블로그
+글 → `/blog/{slug}`). `path` 를 `/blog/...` 로 하드코딩하면 공지 글이 잘못된
+블로그 canonical 을 갖게 됩니다.
+
+```tsx
+import { buildPostMetadata } from "@roottale/cms-renderer-next/routes";
+import { COLLECTIONS } from "@/lib/collections"; // collections.md 참고
+
+export async function generateMetadata({ params }: Props): Promise<Metadata> {
+  const { slug } = await params;
+  const post = await getPost(slug);
+  if (!post) return {};
+  return buildPostMetadata(post, {
+    siteUrl: process.env.NEXT_PUBLIC_SITE_URL,
+    collections: COLLECTIONS, // collectionKey 로 /notice·/blog 자동 구분
+  });
+}
+```
+
+`post.collectionKey`(공개 API의 `collection_key`)가 어느 섹션에도 안 맞으면
+canonical 을 생략합니다(섹션 없는 글은 상세·sitemap에서 제외되는 규칙과 동일).
+단일 블로그 사이트는 기존처럼 `path: "/blog/" + post.slug` 만 주면 됩니다.
+
 ## slug 변경 시 301 리다이렉트
 
 글 slug를 바꿔도 옛 URL이 깨지지 않습니다. API가 slug history로 글을 찾아

package/examples/nextjs/app/api/revalidate/route.ts

@@ -13,8 +13,18 @@ export const POST = createRevalidateRoute({
   apiKey: process.env.ROOTTALE_API_KEY!,
   apiBase: process.env.ROOTTALE_API_BASE,
   revalidate: revalidateBlogPath,
-  // 홈에 최신 글 섹션이 있으면 "/" 포함 — 글 변경 시 홈도 함께 갱신
-  alsoRevalidate: ["/feed.xml", "/sitemap.xml", "/blog", "/"],
+  // 사이트맵 인덱스 + 분리된 하위 사이트맵(static/blog/categories)을 모두 무효화.
+  // 홈에 최신 글 섹션이 있으면 "/" 포함 — 글 변경 시 홈도 함께 갱신.
+  alsoRevalidate: [
+    "/feed.xml",
+    "/sitemap.xml",
+    "/sitemap/static.xml",
+    "/sitemap/blog.xml",
+    "/sitemap/categories.xml",
+    "/sitemap/authors.xml",
+    "/blog",
+    "/",
+  ],
 });
 
 export function GET(): Response {

package/examples/nextjs/app/blog/[slug]/page.tsx

@@ -4,7 +4,10 @@
 import type { Metadata } from "next";
 import { notFound, permanentRedirect } from "next/navigation";
 import { RootTaleBlogPost } from "@roottale/cms-renderer-next/server";
-import { postRedirectPath } from "@roottale/cms-renderer-next/routes";
+import {
+  buildPostMetadata,
+  postRedirectPath,
+} from "@roottale/cms-renderer-next/routes";
 
 import { getAllPosts, getPost } from "@/lib/blog";
 
@@ -21,24 +24,11 @@ export async function generateMetadata({ params }: Props): Promise<Metadata> {
   const { slug } = await params;
   const post = await getPost(slug);
   if (!post) return {};
-  const seo = post.seo;
-  const title = seo?.title || post.title;
-  const description = seo?.description || post.description;
-  return {
-    title,
-    description,
-    ...(seo?.canonical ? { alternates: { canonical: seo.canonical } } : {}),
-    ...(seo?.noindex || seo?.nofollow
-      ? { robots: { index: !seo?.noindex, follow: !seo?.nofollow } }
-      : {}),
-    openGraph: {
-      type: "article",
-      title,
-      description,
-      publishedTime: post.date,
-      ...(post.image ? { images: [{ url: seo?.ogImage || post.image, alt: title }] } : {}),
-    },
-  };
+  // 어드민 SEO 패널(metaJson.seo) override + self-canonical 을 1줄로.
+  return buildPostMetadata(post, {
+    siteUrl: process.env.NEXT_PUBLIC_SITE_URL,
+    path: `/blog/${post.slug}`,
+  });
 }
 
 export default async function PostPage({ params }: Props) {

package/examples/nextjs/app/sitemap.ts

@@ -1,19 +1,20 @@
-// 사이트맵 — 정적 경로 + 발행 글 URL 자동 포함.
-import { createSitemap } from "@roottale/cms-renderer-next/routes";
+// 사이트맵 — 인덱스 분리(/sitemap.xml → /sitemap/static.xml·blog·categories).
+// 정적 경로 + 발행 글·카테고리 자동 포함. 블로그 글 대표 이미지는 admin 토글에 따라
+// <image:image> 로 함께 색인(어드민 설정 > 블로그 > 사이트맵).
+import { createSitemapIndex } from "@roottale/cms-renderer-next/routes";
 
 const SITE_URL =
   process.env.NEXT_PUBLIC_SITE_URL?.replace(/\/$/, "") || "https://example.com";
 
-export default createSitemap(
+const { generateSitemaps, sitemap } = createSitemapIndex(
   {
     apiKey: process.env.ROOTTALE_API_KEY!,
     apiBase: process.env.ROOTTALE_API_BASE,
     siteUrl: SITE_URL,
     title: "예시 사이트",
   },
-  [
-    { url: SITE_URL, changeFrequency: "weekly", priority: 1.0 },
-    { url: `${SITE_URL}/blog`, changeFrequency: "weekly", priority: 0.7 },
-    { url: `${SITE_URL}/contact`, changeFrequency: "monthly", priority: 0.9 },
-  ],
+  [{ url: SITE_URL }, { url: `${SITE_URL}/blog` }, { url: `${SITE_URL}/contact` }],
 );
+
+export { generateSitemaps };
+export default sitemap;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@roottale/cms-mcp",
-  "version": "0.35.0",
+  "version": "0.37.0",
   "type": "module",
   "description": "RootTale CMS integration MCP server — bundled integration docs, Next.js example code, and public API lookup tools. Run with: npx @roottale/cms-mcp",
   "bin": {