@roottale/cms-mcp 0.24.0 → 0.32.0

package/CHANGELOG.md

@@ -1,5 +1,64 @@
 # @roottale/cms-mcp
 
+## 0.32.0
+
+### Minor Changes
+
+- dfe7814: docs: 콘텐츠 유형(Collections) 전용 문서 추가 (ADR-0060)
+
+  신규 `docs/collections.md` — 공지·블로그 다중 스트림의 URL 구조, 어드민 "콘텐츠 유형"
+  설정, 연동 코드(코드 상수 vs `fetchCollections` 동적 로드), 가드·catch-all·slug 301·동적
+  OG·동적 basePath·트러블슈팅을 한 곳에 정리. `docs/seo.md` 의 collections 섹션은 이 문서로
+  포인터 처리(드리프트 방지). 공개 엔드포인트 `GET /v1/cms/public/collections` 명시.
+
+  MCP `listDocs()` 는 docs/ 자동 발견이라 새 문서가 바로 노출되고, roottale-web 문서 사이트는
+  `PREFERRED_ORDER` 에 `collections` 추가로 노출된다.
+
+## 0.25.0
+
+### Minor Changes
+
+- 0dcb931: 비즈니스 프로필 (로컬 SEO) — 어드민 "운영 > 비즈니스 프로필" 에서 저장한
+  사업장 정보(이름·업종·주소·좌표·영업시간·네이버플레이스/구글 비즈니스
+  프로필 URL)를 외부 사이트가 조회해 LocalBusiness JSON-LD 를 자동 렌더.
+  - cms-client: `fetchBusinessProfile()` (미설정/구 서버 404 = null) +
+    `localBusinessSchema(profile, { url, image? })` — @type 중복 제거,
+    PostalAddress/GeoCoordinates/openingHoursSpecification/sameAs.
+  - API: `GET /v1/cms/public/business-profile` (cms:read).
+  - cms-mcp docs: seo.md 로컬 SEO 섹션, theme-and-settings.md
+    fetchBusinessProfile, api-reference.md 엔드포인트, examples layout 적용.
+
+- c81991a: CLS(Core Web Vitals) 대책: 본문 이미지에 width/height 출력. 에디터가
+  삽입 시 원본 치수를 보존하고(CmsImage), 렌더러(Next·Astro)가 `width`/
+  `height` 속성으로 출력 — 기존 CSS(max-inline-size:100%; block-size:auto)와
+  조합돼 반응형 유지하면서 레이아웃 시프트 제거. WP import 의 width/height 도
+  자동 보존. cms-mcp docs 에 robots.txt·브레드크럼·페이지네이션 가이드 추가.
+- 4e7f9f8: llms.txt 라우트 팩토리 (AEO/GEO): `createLlmsTxtRoute(config)` 추가 —
+  llms.txt 스펙(https://llmstxt.org)의 마크다운 인덱스로 AI 검색·생성엔진
+  크롤러에 사이트 구조·발행 글(최대 100개, excerpt 1줄)을 노출. fetch 실패도
+  항상 200(fail-soft). `createRevalidateRoute` 기본 `alsoRevalidate` 에
+  `/llms.txt` 포함 — 글 변경 시 AI 크롤러 인덱스 자동 갱신. docs/examples 반영.
+- 50b6df0: 메뉴(네비게이션) 연동: `fetchMenu({ apiKey, slug })` / `fetchMenus({ apiKey })`
+  — 어드민 "디자인 > 메뉴" 트리(`GET /v1/cms/public/menus`)를 헤더/푸터 네비로
+  렌더. 깊이 2, 미존재 404 → null/빈 배열 fail-soft. 새 문서 `menus.md` +
+  예시 `components/site-nav.tsx`.
+- e84a46c: slug 변경 301 (WP permalink 패리티): public API 가 옛 slug 로도 글을 찾아
+  현재 slug 로 응답하고(post_slug_history fallback), `cms-renderer-next/routes`
+  에 `postRedirectPath(post, requestedSlug, blogBasePath?)` 헬퍼를 추가 —
+  페이지에서 `permanentRedirect()` 로 301 처리. docs/examples 에 패턴 반영.
+- 6262fe7: 동적 OG 이미지: `createPostOgImage(config, { ImageResponse })` +
+  `OG_IMAGE_SIZE`/`OG_IMAGE_CONTENT_TYPE` — `app/blog/[slug]/opengraph-image.tsx`
+  에서 글별 1200×630 소셜 카드 생성. 한글은 Noto Sans KR 부분셋 런타임 로딩,
+  글/폰트 fetch 실패 시 fail-soft. `next` 직접 의존 없음(ImageResponse 주입).
+- 50b6df0: 공개 검색 API: `searchPosts({ apiKey, query, limit?, type? })` — 발행 글
+  키워드 검색 (WP `?s=` 패리티, `GET /v1/cms/public/search`). title·excerpt·
+  본문 텍스트 부분일치, 본문 미포함 슬림 hit. 구 서버 404 는 빈 배열 fail-soft.
+
+### Patch Changes
+
+- e7e0849: per-post nofollow 제어 문서화 — 어드민 SEO 패널의 noindex 옆에 nofollow
+  토글이 추가됨. `metaJson.seo.nofollow` → Next `robots.follow` 매핑 예시 갱신.
+
 ## 0.24.0
 
 ### Minor Changes

package/dist/index.js

@@ -256,7 +256,7 @@ function registerTools(server2) {
 }
 
 // src/server.ts
-var VERSION = true ? "0.24.0" : "dev";
+var VERSION = true ? "0.32.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

@@ -36,6 +36,48 @@ JS/TS 스택은 raw 호출 대신 `@roottale/cms-client`를 사용하세요 —
 
 글 1개 — `identifier`는 slug 또는 UUID. 미발행/없는 글은 `404`.
 
+## GET /v1/cms/public/search
+
+발행된 글 키워드 검색 (사이트 내 검색, WP `?s=` 패리티). title·excerpt·본문
+텍스트의 case-insensitive 부분일치, 최신 발행순. 응답은 카드 렌더용 슬림
+hit — 본문(`body_json`)은 미포함이므로 상세는 slug 로 글 1개 API를 호출하세요.
+
+| 쿼리 | 설명 |
+|---|---|
+| `q` | 검색 키워드 (필수, 1~100자) |
+| `limit` | 결과 수 1~50, 기본 10 |
+| `type` | `post`(기본) \| `page` |
+| `site_id` | 멀티 사이트 키일 때만 |
+
+```json
+{ "tenant_id": "…", "site_id": "…", "query": "세무",
+  "items": [ { "id": "…", "type": "post", "title": "…", "slug": "…",
+               "excerpt": "…", "featured_media_url": "…",
+               "published_at": "…" } ] }
+```
+
+JS/TS 는 `@roottale/cms-client/server` 의 `searchPosts({ apiKey, query })` 를
+사용하세요 — 구 서버(라우트 미배포)의 404 를 빈 배열로 처리합니다.
+
+## GET /v1/cms/public/menus
+
+네비게이션 메뉴 전체 — 어드민 "디자인 > 메뉴" 저장값. 항목은 깊이 2 트리.
+
+```json
+{ "tenant_id": "…", "site_id": "…",
+  "items": [ { "id": "…", "name": "헤더 메뉴", "slug": "primary",
+               "items": [ { "id": "…", "label": "회사 소개", "url": "/about",
+                            "children": [ { "id": "…", "label": "오시는 길",
+                                            "url": "/about/location" } ] },
+                          { "id": "…", "label": "블로그", "url": "/blog" } ],
+               "updated_at": "…" } ] }
+```
+
+## GET /v1/cms/public/menus/{slug}
+
+위치 핸들(`primary`, `footer` 등)로 메뉴 1개. 없으면 `404` — 사이트는 자체
+fallback 네비를 렌더하세요 (`menus.md` 참고).
+
 ## GET /v1/cms/public/theme
 
 어드민에서 설정한 디자인 토큰. 설정된 그룹만 포함됩니다.
@@ -57,6 +99,31 @@ JS/TS 스택은 raw 호출 대신 `@roottale/cms-client`를 사용하세요 —
   "updated_at": null }
 ```
 
+## GET /v1/cms/public/business-profile
+
+비즈니스 프로필 (로컬 SEO) — 어드민 "운영 > 비즈니스 프로필" 저장값.
+미설정이면 `configured: false` + 필드 `null`.
+
+```json
+{ "tenant_id": "…", "site_id": "…", "configured": true,
+  "name": "길동세무회계", "legal_name": null,
+  "business_type": "AccountingService",
+  "telephone": "02-1234-5678", "email": null,
+  "address": { "street_address": "테헤란로 123", "address_locality": "강남구",
+               "address_region": "서울특별시", "postal_code": "06234" },
+  "geo": { "latitude": 37.5006, "longitude": 127.0364 },
+  "opening_hours": [ { "days": ["Mo","Tu","We","Th","Fr"],
+                       "opens": "09:00", "closes": "18:00" } ],
+  "price_range": "₩₩", "area_served": ["서울 강남구"],
+  "profiles": { "naver_place": "https://…", "google_business": "https://…",
+                "kakao_channel": null, "instagram": null, "naver_blog": null },
+  "updated_at": "…" }
+```
+
+`business_type`: `LocalBusiness` | `ProfessionalService` |
+`AccountingService` | `LegalService` | `MedicalClinic` | `Dentist` |
+`RealEstateAgent` | `Restaurant` | `BeautySalon`.
+
 ## GET /v1/cms/public/analytics
 
 분석 태그 설정.

package/docs/blog.md

@@ -67,6 +67,18 @@ export default async function PostPage({
 목차(ToC)·작성자 카드·발행일 표시는 어드민의 블로그 표시 설정으로도 제어됩니다
 (`theme-and-settings.md` 참고).
 
+#### 목차 블록 (본문 임의 위치)
+
+`showTableOfContents` 는 본문 **상단**에 목차를 자동으로 붙입니다. 글 안의
+원하는 위치(예: 인트로 문단 다음)에 목차를 넣고 싶다면, 어드민 에디터에서
+슬래시 메뉴 `/목차` 로 **목차 블록**(`roottale/table-of-contents`)을 삽입하세요.
+렌더러가 그 위치에 문서의 h2–h4 제목으로 목차(`<nav class="rt-cms-toc">`)를
+생성하고 각 제목에 앵커 id 를 부여합니다 — 상단 자동 ToC 와 동일 마크업·클래스라
+스타일은 그대로 적용됩니다. 헤딩이 하나도 없으면 아무것도 렌더되지 않습니다.
+
+블록을 본문에 직접 배치할 때는 상단 자동 ToC 와 중복되지 않도록
+`showTableOfContents` 를 생략(기본 `false`)하는 것을 권장합니다.
+
 ### 고정 페이지 (회사소개 등)
 
 어드민의 고정 페이지(`type: "page"`)는 `RootTalePage`로 렌더링합니다 — 블로그
@@ -155,12 +167,39 @@ export async function generateMetadata({
   return {
     title: (seo?.title as string) || post.title,
     description: (seo?.description as string) || post.excerpt,
-    ...(seo?.noindex ? { robots: { index: false, follow: true } } : {}),
+    ...(seo?.noindex || seo?.nofollow
+      ? { robots: { index: !seo?.noindex, follow: !seo?.nofollow } }
+      : {}),
   };
 }
 ```
 
-SEO 오버라이드 필드: `title`, `description`, `canonical`, `ogImage`, `noindex`.
+SEO 오버라이드 필드: `title`, `description`, `canonical`, `ogImage`,
+`noindex`, `nofollow`.
+
+### slug 변경 시 301 리다이렉트 (필수 권장)
+
+어드민에서 글 slug를 바꿔도 API는 **옛 slug로 글을 찾아 현재 slug로
+응답**합니다(slug history fallback). 페이지에서 요청 slug와 응답 slug가
+다르면 301로 보내야 검색엔진 순위가 새 URL로 승계됩니다:
+
+```tsx
+// app/blog/[slug]/page.tsx
+import { notFound, permanentRedirect } from "next/navigation";
+import { postRedirectPath } from "@roottale/cms-renderer-next/routes";
+
+export default async function PostPage({ params }: Props) {
+  const { slug } = await params;
+  const post = await getPost(slug);
+  if (!post) notFound();
+  const redirect = postRedirectPath(post, slug); // 기본 basePath "/blog"
+  if (redirect) permanentRedirect(redirect);
+  // ... 렌더
+}
+```
+
+`generateMetadata`는 redirect 페이지에서 실행돼도 무방하지만, canonical을
+직접 계산한다면 `post.slug`(현재 slug) 기준으로 계산하세요.
 
 ## 캐싱 전략
 

package/docs/collections.md

@@ -0,0 +1,211 @@
+---
+title: 콘텐츠 유형 (Collections) — 공지·블로그 URL 분리
+description: 같은 글 풀을 공지 게시판(/notice)·블로그(/blog) 등 여러 스트림으로 나누는 법. URL 구조, 어드민 설정, 연동 코드, slug·301·OG.
+---
+
+# 콘텐츠 유형 (Collections)
+
+하나의 글 목록을 **여러 스트림**으로 나눠 서로 다른 URL·레이아웃으로 보여주는 기능입니다.
+가장 흔한 형태는 **공지 게시판(`/notice`) + 블로그(`/blog`)** 분리입니다. 어느 글이 어느
+스트림에 속할지는 그 글의 **카테고리**로 정해집니다.
+
+## URL이 어떻게 정해지나
+
+> **글의 URL = 그 글이 속한 스트림의 `basePath` + `/{slug}`**
+
+| 글의 카테고리 | 속하는 스트림 | URL |
+|---|---|---|
+| `notice` | 공지 (basePath `/notice`) | `/notice/{slug}` |
+| `column` · `news` | 블로그 (basePath `/blog`) | `/blog/{slug}` |
+
+예: `notice` 카테고리 글 "개강안내" → `https://내사이트/notice/개강안내`
+`column` 카테고리 글 "비문학공부법" → `https://내사이트/blog/비문학공부법`
+
+스트림별로 함께 만들어지는 경로:
+
+| 경로 | 설명 |
+|---|---|
+| `{basePath}` | 스트림 목록 (예: `/notice`, `/blog`) |
+| `{basePath}/{slug}` | 글 상세 |
+| `{basePath}/categories/{slug}` | 카테고리 아카이브 (`archives` 켠 스트림만) |
+| `/feed.xml` | RSS — `feed` 켠 스트림들의 통합 피드 |
+| `/sitemap.xml` | 글마다 **소속 스트림 basePath로** 정확히 매핑 |
+| `{basePath}/{slug}/opengraph-image` | 글별 동적 OG 카드 (배선 시) |
+
+규칙:
+
+- **slug은 한글 그대로** 됩니다(예: `/blog/비문학독해`). 내부적으로 percent-encoding.
+- **같은 글이 두 스트림에 안 뜸**: 공지 글을 `/blog/개강안내`로 열면 404, 반대도 404(가드).
+- **글이 어느 스트림에도 안 속하면**(분류 전용 카테고리 등) sitemap·feed에서 제외됩니다.
+- 한 글이 여러 스트림 카테고리를 동시에 가지면 **선언 순서가 빠른 스트림**이 이깁니다(first-wins).
+
+## 어드민에서 설정 (`mysite.roottale.com`)
+
+**설정 > 콘텐츠 유형** 에서 스트림을 정의합니다. 각 스트림은:
+
+| 항목 | 의미 |
+|---|---|
+| key | 안정 식별자 (`notice`, `blog`) |
+| 라벨 | 메뉴·작성 화면 표시 이름 (공지/블로그) |
+| basePath | URL 앞부분 (`/notice`, `/blog`) |
+| 카테고리 | 이 스트림에 속하는 카테고리 slug들. **비우면 catch-all**(나머지 전부) |
+| feed / archives / og | RSS 포함 / 카테고리 아카이브 / 동적 OG |
+| 순서 | 위에서부터 우선순위 |
+
+**비우면 단일 블로그(`/blog`)** 로 동작합니다(설정 전 기본값).
+
+### ⚠️ basePath는 "라우트가 있어야" 동작합니다 (데이터=DB, 라우트=코드)
+
+basePath·라벨·카테고리·플래그는 어드민에서 바꾸면 sitemap·feed·라우팅이 즉시 따라갑니다.
+**단 basePath에 해당하는 페이지 파일이 사이트에 있어야** 실제로 열립니다:
+
+- `/notice`·`/blog`처럼 **이미 라우트가 있는 경로**는 어드민만으로 자유롭게 편집 → 동작.
+- basePath를 **완전히 새 경로**(예: `/news`)로 바꾸면 sitemap엔 `/news/{slug}`가 나가지만
+  사이트에 `app/news/[slug]` 라우트가 없으면 **404**. 이 경우 개발자가 라우트를 먼저 추가해야
+  합니다. (새 basePath도 코드 수정 없이 동작시키려면 catch-all 동적 라우트를 쓰면 됩니다 — 아래.)
+
+### 카테고리 만들기
+
+각 스트림의 카테고리(`notice`, `column`, `news` 등)는 **설정 > 카테고리**(taxonomy)에서
+만들고, 글 작성 화면에서 글에 붙입니다. 작성 화면에는 *"이 글은 → /notice 에 게시됩니다"*
+표시가 떠서 어느 스트림으로 가는지 바로 확인됩니다.
+
+## 사이트 연동 코드
+
+스트림 선언을 route 팩토리에 넘기면 sitemap·feed·revalidate가 거기서 파생됩니다. 두 가지
+방식이 있습니다.
+
+### 방식 A — 코드 상수 (간단, 고정)
+
+```ts
+import type { RouteCollection } from "@roottale/cms-renderer-next/routes";
+
+export const COLLECTIONS: RouteCollection[] = [
+  { key: "notice", basePath: "/notice", categories: ["notice"] },
+  {
+    key: "blog",
+    basePath: "/blog",
+    categories: ["column", "news"], // 또는 [] = catch-all(공지 외 전부)
+    feed: true,
+    archives: true,
+  },
+];
+```
+
+```ts
+// app/sitemap.ts
+import { createSitemap } from "@roottale/cms-renderer-next/routes";
+export default createSitemap({ apiKey, siteUrl, title, collections: COLLECTIONS }, [
+  /* 정적 경로 */
+]);
+
+// app/feed.xml/route.ts
+export const dynamic = "force-dynamic";
+export const GET = createFeedRoute({ apiKey, siteUrl, title, collections: COLLECTIONS });
+```
+
+### 방식 B — 어드민에서 동적 로드 (운영자가 직접 편집)
+
+상수 대신 **어드민 "콘텐츠 유형"** 값을 `fetchCollections()`로 가져와 팩토리에 **resolver
+함수**로 넘깁니다. 운영자가 어드민에서 스트림을 바꾸면 사이트가 따라갑니다.
+
+```ts
+import { fetchCollections } from "@roottale/cms-client/server";
+
+const DEFAULT: RouteCollection[] = [ /* 위와 동일 — fail-soft 기본값 */ ];
+
+async function getCollections(): Promise<RouteCollection[]> {
+  try {
+    const c = await fetchCollections({ apiKey: process.env.ROOTTALE_API_KEY! });
+    return c.length ? c : DEFAULT;
+  } catch {
+    return DEFAULT; // API 미설정/실패 시 기본값
+  }
+}
+
+export default createSitemap({ apiKey, siteUrl, title, collections: getCollections }, [ ]);
+export const GET = createFeedRoute({ apiKey, siteUrl, title, collections: getCollections });
+```
+
+공개 엔드포인트: `GET /v1/cms/public/collections` (블로그 조회와 같은 API 키).
+응답은 `RouteCollection`과 구조 호환이라 그대로 넘길 수 있습니다. 매 요청 fetch를 피하려면
+사이트 경계에서 캐시하세요(예: Next `fetch(url, { next: { revalidate: 300 } })`).
+
+### 상세 페이지 가드 (스트림 누출 차단)
+
+상세 라우트는 글이 그 스트림 소속인지 확인해 다른 스트림 글이 새는 것을 막습니다.
+
+```ts
+import { resolvePostCollection } from "@roottale/cms-renderer-next/routes";
+// app/blog/[slug]/page.tsx
+const post = await getPost(slug);
+if (!post || resolvePostCollection(post, COLLECTIONS)?.key !== "blog") notFound();
+```
+
+### revalidate
+
+```ts
+import { createRevalidateRoute } from "@roottale/cms-renderer-next/routes";
+export const POST = createRevalidateRoute({ apiKey, revalidate, collections: COLLECTIONS });
+```
+
+각 스트림 basePath(+ `archives`면 `/categories`)와 `/feed.xml`·`/sitemap.xml`·`/llms.txt`를
+자동 무효화합니다. resolver가 실패하면 잘못된 경로를 추측하지 않고 불변 경로만 갱신하며
+응답에 `warning`을 노출합니다.
+
+### 동적 OG 이미지
+
+```tsx
+// app/blog/[slug]/opengraph-image.tsx
+import { ImageResponse } from "next/og";
+import {
+  createPostOgImage, OG_IMAGE_SIZE, OG_IMAGE_CONTENT_TYPE,
+  type ImageResponseLike,
+} from "@roottale/cms-renderer-next/routes";
+
+export const size = OG_IMAGE_SIZE;
+export const contentType = OG_IMAGE_CONTENT_TYPE;
+export default createPostOgImage(
+  { apiKey, siteUrl, title, brandLabel: "내 사이트" },
+  { ImageResponse: ImageResponse as unknown as ImageResponseLike }, // Next 16 타입 cast
+);
+```
+
+> Astro 사이트는 `@roottale/cms-renderer-astro`에서 동일한 `resolvePostCollection`/
+> `resolvePostPath`/`RouteCollection`을 import 하고 `renderBlogList({ collections })`로
+> 링크를 스트림별로 라우팅합니다(동등 surface).
+
+## catch-all 스트림
+
+블로그 카테고리가 계속 늘어나는 사이트는, 블로그를 **`categories: []`(빈 배열) = catch-all**로
+두면 됩니다 — 공지로 분류되지 않은 글을 전부 흡수합니다. catch-all은 **맨 뒤**에 두세요
+(선언 순서가 우선순위라, 뒤에 둔 스트림은 도달 못 합니다).
+
+```ts
+[
+  { key: "notice", basePath: "/notice", categories: ["notice"] },
+  { key: "blog", basePath: "/blog", categories: [], feed: true }, // 나머지 전부
+]
+```
+
+## slug 변경과 301
+
+글의 slug(`/{slug}` 부분)는 글 편집 화면에서 바꿉니다. 바꾼 뒤 옛 slug로 들어오면 `postRedirectPath`로
+**301 리다이렉트**되어 새 slug로 넘어갑니다(검색 순위 보존).
+
+## 동적 basePath (advanced)
+
+basePath를 **코드 수정 없이 어드민에서 자유롭게** 바꾸고 싶으면, 정적 `app/notice/[slug]`
+대신 **catch-all 동적 라우트** `app/[stream]/[slug]/page.tsx`(또는 `app/[...path]`)를 두고,
+그 안에서 collections를 읽어 요청 경로가 어떤 스트림 basePath인지 판정해 렌더합니다. 그러면
+어드민에서 basePath를 `/news`로 바꿔도 동작합니다. 트레이드오프: 정적 라우트보다 캐시·타입
+안전성이 떨어지므로, 스트림 구조가 자주 바뀌는 사이트에만 권장합니다.
+
+## 자주 막히는 곳
+
+- **글이 안 보여요** → 그 글에 스트림 카테고리(`notice`/`column`/`news` 등)가 붙어 있는지 확인.
+  어드민 콘텐츠 유형이 비어 있으면 사이트는 코드 기본값으로만 동작합니다.
+- **404가 떠요** → 공지 글을 `/blog/...`로(또는 그 반대로) 열면 가드가 막습니다. 올바른 스트림
+  basePath로 접근하세요. basePath를 바꿨다면 사이트에 그 라우트 파일이 있는지 확인.
+- **sitemap에 글이 빠졌어요** → 그 글이 어느 스트림에도 안 속하면(상세 라우트 없는 분류 전용)
+  의도적으로 제외됩니다.

package/docs/menus.md

@@ -0,0 +1,100 @@
+---
+title: 메뉴 (네비게이션) 연동
+description: 어드민 "디자인 > 메뉴"에서 관리하는 네비게이션을 헤더/푸터에 렌더
+---
+
+# 메뉴 (네비게이션) 연동
+
+어드민(mysite.roottale.com)의 **디자인 > 메뉴**에서 저장한 네비게이션 트리를
+사이트의 헤더·푸터에 렌더합니다. 고객이 직접 메뉴 항목(이름·주소·순서·하위
+항목)을 바꿀 수 있어 코드 수정 없이 네비가 갱신됩니다.
+
+- 메뉴는 **위치 핸들(slug)** 로 구분합니다 — 관례: `primary`(헤더), `footer`(푸터).
+- 항목은 깊이 2 트리 (상위 + 드롭다운 1단).
+- `url` 은 상대 경로(`/about`) 또는 절대 `http(s)` URL — 서버가 위험 스킴을
+  제거한 안전한 값만 내려줍니다.
+- 메뉴 저장 시 발행 웹훅(`post.updated`, paths: `["/"]`)이 발송되므로
+  웹훅 수신 라우트(`revalidation-webhooks.md`)를 설정했다면 몇 초 내 반영됩니다.
+
+## 서버 컴포넌트에서 메뉴 가져오기
+
+```tsx
+// components/site-nav.tsx (Server Component)
+import Link from "next/link";
+import { fetchMenu } from "@roottale/cms-client/server";
+
+export async function SiteNav() {
+  const menu = await fetchMenu({
+    apiKey: process.env.ROOTTALE_API_KEY!,
+    slug: "primary",
+  });
+
+  // 메뉴 미설정(null)이면 자체 fallback 네비를 렌더하세요.
+  if (!menu) {
+    return (
+      <nav>
+        <Link href="/blog">블로그</Link>
+      </nav>
+    );
+  }
+
+  return (
+    <nav>
+      {menu.items.map((item) => (
+        <div key={item.id}>
+          <Link
+            href={item.url}
+            {...(item.newTab
+              ? { target: "_blank", rel: "noopener" }
+              : {})}
+          >
+            {item.label}
+          </Link>
+          {item.children?.length ? (
+            <div>
+              {item.children.map((child) => (
+                <Link key={child.id} href={child.url}>
+                  {child.label}
+                </Link>
+              ))}
+            </div>
+          ) : null}
+        </div>
+      ))}
+    </nav>
+  );
+}
+```
+
+`fetchMenu` 는 미존재/구 서버의 404 를 `null` 로 돌려주므로(fail-soft) 항상
+fallback 분기를 두세요. 전체 메뉴 목록이 필요하면 `fetchMenus({ apiKey })`.
+
+## 타입
+
+```ts
+interface RootTaleMenu {
+  id: string;
+  name: string;        // "헤더 메뉴"
+  slug: string;        // "primary" | "footer" | ...
+  items: RootTaleMenuItem[];
+  updatedAt: string | null;
+}
+
+interface RootTaleMenuItem {
+  id: string;
+  label: string;
+  url: string;         // "/about" 또는 "https://..."
+  newTab?: boolean;    // target="_blank" rel="noopener" 로 렌더
+  children?: RootTaleMenuItem[];
+}
+```
+
+## 캐싱
+
+메뉴 응답은 5분 캐시(+SWR)로 내려갑니다. 페이지가 ISR 이라면 발행 웹훅이
+`/` 를 revalidate 할 때 함께 갱신되므로 별도 처리 없이 near-real-time 입니다.
+
+## raw HTTP
+
+JS 외 스택은 `GET /v1/cms/public/menus/{slug}` 를 직접 호출하세요 —
+`api-reference.md` 참고.

package/docs/overview.md

@@ -50,7 +50,8 @@ RootTale CMS는 어드민(`mysite.roottale.com`)에서 콘텐츠를 작성·발
 | `blog.md` | 블로그 목록/상세 페이지 구현 (컴포넌트 또는 직접 fetch) |
 | `revalidation-webhooks.md` | 발행 웹훅으로 near-real-time 캐시 갱신 |
 | `inquiries.md` | 상담문의(리드) 폼 연동 |
-| `seo.md` | RSS 피드, 사이트맵, JSON-LD, fleet 프로브 |
+| `menus.md` | 메뉴(네비게이션) — 어드민 "디자인 > 메뉴" 트리를 헤더/푸터에 렌더 |
+| `seo.md` | RSS 피드, 사이트맵, JSON-LD, 동적 OG 이미지, 공개 검색, fleet 프로브 |
 | `theme-and-settings.md` | 디자인 토큰, 블로그 표시 설정, 분석 태그 |
 | `api-reference.md` | HTTP API 레퍼런스 (비 JS 스택용 raw 엔드포인트) |
 
@@ -59,5 +60,6 @@ RootTale CMS는 어드민(`mysite.roottale.com`)에서 콘텐츠를 작성·발
 1. `getting-started.md` — 키 발급 + 환경 설정
 2. `blog.md` — `/blog` 목록·상세 페이지
 3. `revalidation-webhooks.md` — 웹훅 등록 (발행 → 즉시 반영)
-4. `seo.md` — RSS·사이트맵
+4. `seo.md` — RSS·사이트맵·동적 OG 이미지
 5. `inquiries.md` — 상담문의 폼 (선택)
+6. `menus.md` — 어드민 관리 네비게이션 (선택)

package/docs/seo.md

@@ -51,11 +51,145 @@ export default createSitemap(
 );
 ```
 
+## 다중 스트림 (collections) — 공지·블로그 분리
+
+같은 글 풀을 공지 게시판(`/notice`) + 블로그(`/blog`) 등 여러 스트림으로 나눠 서로 다른
+URL·레이아웃으로 보여줄 수 있습니다. URL 구조·어드민 설정·연동 코드(코드 상수 vs 어드민
+fetch)·가드·catch-all·동적 basePath는 별도 문서 [콘텐츠 유형 (Collections)](./collections.md)
+에 정리되어 있습니다. 여기 sitemap/feed 예시도 `collections`를 넘기면 스트림별로 파생됩니다.
+
+## robots.txt
+
+크롤링 제어의 기본. sitemap 위치를 알려주고, 크롤링이 무의미한 경로만
+차단합니다. **CSS/JS/이미지 경로를 차단하지 마세요** — 구글이 페이지를
+렌더링하지 못해 평가가 깨집니다. 색인 제외가 목적이면 robots.txt 차단이
+아니라 페이지의 noindex 를 쓰세요 (외부 링크가 있으면 차단해도 색인될 수
+있습니다).
+
+```ts
+// app/robots.ts
+import type { MetadataRoute } from "next";
+
+const SITE_URL = process.env.NEXT_PUBLIC_SITE_URL!;
+
+export default function robots(): MetadataRoute.Robots {
+  return {
+    rules: [{ userAgent: "*", allow: "/", disallow: ["/api/"] }],
+    sitemap: `${SITE_URL}/sitemap.xml`,
+  };
+}
+```
+
+## 브레드크럼 (BreadcrumbList)
+
+사이트 구조를 검색엔진에 전달하고 검색결과에 경로가 표시됩니다. 블로그 글
+상세에서 `breadcrumbSchema` 로 렌더하세요 (UI 브레드크럼과 구조 일치 권장):
+
+```tsx
+import { breadcrumbSchema } from "@roottale/cms-client/server";
+
+const category = post.terms.find((t) => t.taxonomy === "category");
+const crumbs = breadcrumbSchema([
+  { name: "홈", url: SITE_URL },
+  { name: "블로그", url: `${SITE_URL}/blog` },
+  ...(category
+    ? [{ name: category.name, url: `${SITE_URL}/blog/categories/${category.slug}` }]
+    : []),
+  { name: post.title, url: `${SITE_URL}/blog/${post.slug}` },
+]);
+```
+
+## 블로그 목록 페이지네이션 주의
+
+- 마지막 페이지에 다음(next) 링크를 렌더하지 마세요 — 같은 페이지가 반복
+  노출되면 크롤 낭비·중복 신호가 됩니다.
+- 필터·정렬로 내용이 바뀌면 URL(쿼리)도 함께 바뀌어야 하고, canonical 은
+  필터 없는 기본 목록을 가리키게 하세요.
+- 검색결과(사이트 내 검색) 페이지는 noindex 처리하세요 — 특히 결과 0건
+  페이지가 색인되면 저품질(소프트 404) 신호가 됩니다.
+
 ## RSS/사이트맵과 웹훅
 
 발행 웹훅의 `alsoRevalidate`에 `/feed.xml`, `/sitemap.xml`을 포함해 글 변경
 시 함께 갱신하세요 (`revalidation-webhooks.md` 참고).
 
+## slug 변경 시 301 리다이렉트
+
+글 slug를 바꿔도 옛 URL이 깨지지 않습니다. API가 slug history로 글을 찾아
+**현재 slug로 응답**하므로, 페이지에서 요청 slug와 비교해 301을 보내세요:
+
+```tsx
+import { notFound, permanentRedirect } from "next/navigation";
+import { postRedirectPath } from "@roottale/cms-renderer-next/routes";
+
+const post = await getPost(slug);
+if (!post) notFound();
+const redirect = postRedirectPath(post, slug);
+if (redirect) permanentRedirect(redirect);
+```
+
+301이어야 기존 URL의 검색 순위·백링크가 새 URL로 승계됩니다 (사이트맵·RSS는
+항상 현재 slug만 포함).
+
+## 동적 OG 이미지 (글별 1200×630)
+
+글마다 제목·날짜가 들어간 소셜 공유 카드를 자동 생성합니다 — 대표 이미지를
+일일이 만들지 않아도 카카오톡·페이스북·X 공유 시 글 제목이 보이는 카드가
+나갑니다. 한글 제목은 Noto Sans KR 부분셋을 런타임에 받아 렌더합니다.
+
+```tsx
+// app/blog/[slug]/opengraph-image.tsx
+import { ImageResponse } from "next/og";
+import {
+  createPostOgImage,
+  OG_IMAGE_SIZE,
+  OG_IMAGE_CONTENT_TYPE,
+  type ImageResponseLike,
+} from "@roottale/cms-renderer-next/routes";
+
+export const size = OG_IMAGE_SIZE; // { width: 1200, height: 630 }
+export const contentType = OG_IMAGE_CONTENT_TYPE; // "image/png"
+
+export default createPostOgImage(
+  {
+    apiKey: process.env.ROOTTALE_API_KEY!,
+    siteUrl: process.env.NEXT_PUBLIC_SITE_URL!,
+    title: "예시 블로그",
+    // 선택 — 브랜드 색 커스텀:
+    // backgroundColor: "#10172a", accentColor: "#38bdf8", brandLabel: "예시",
+  },
+  // Next 16 의 ImageResponse 타입은 패키지 ImageResponseLike 와 미묘하게 달라
+  // cast 가 필요하다(패키지는 next 비의존이라 구조적 타입만 안다).
+  { ImageResponse: ImageResponse as unknown as ImageResponseLike },
+);
+```
+
+- `opengraph-image.tsx` 파일 컨벤션이라 별도 meta 태그 없이 Next 가
+  `og:image` 를 자동 주입합니다 (`twitter-image.tsx` 로 복제하면 X 카드도).
+- 글이 없거나 API 실패 시 사이트 제목으로 fail-soft 렌더 — 빈 카드가
+  나가지 않습니다.
+- `ImageResponse` 는 호출부에서 주입합니다 — 본 패키지는 `next` 에 직접
+  의존하지 않습니다.
+
+## 공개 검색 (사이트 내 검색)
+
+`searchPosts` 로 발행 글 키워드 검색을 붙일 수 있습니다 (WP `?s=` 패리티):
+
+```tsx
+// app/search/page.tsx (Server Component)
+import { searchPosts } from "@roottale/cms-client/server";
+
+const hits = await searchPosts({
+  apiKey: process.env.ROOTTALE_API_KEY!,
+  query: q, // ?q= 쿼리
+  limit: 20,
+});
+// hits: { id, title, slug, excerpt, featuredImageUrl, publishedAt }[]
+```
+
+본문은 미포함 슬림 hit 이므로 카드에서 `/blog/{slug}` 로 연결하세요.
+검색결과 페이지는 위 체크리스트대로 **noindex** 처리를 잊지 마세요.
+
 ## JSON-LD 스키마 헬퍼
 
 `@roottale/cms-client/server`에서 제공:
@@ -65,6 +199,7 @@ export default createSitemap(
 | `articleSchema(input)` | 블로그 글 상세 페이지 Article |
 | `breadcrumbSchema(items)` | 빵부스러기 |
 | `organizationSchema(input)` | 조직/사업체 |
+| `localBusinessSchema(profile, opts)` | 사업장 LocalBusiness (로컬 SEO — 아래 섹션) |
 | `websiteSchema(input)` | 웹사이트 |
 | `faqSchema(items)` | FAQ |
 
@@ -88,6 +223,63 @@ const jsonLd = articleSchema({
 저수준 RSS가 필요하면 `generateRssXml` / `rssItemsFromPosts`를 직접 사용할 수
 있습니다.
 
+## 로컬 SEO (네이버플레이스·구글 비즈니스)
+
+어드민 **운영 > 비즈니스 프로필**에서 사업장 정보(이름·업종·주소·좌표·
+영업시간·외부 프로필 URL)를 저장하면, 사이트가 `fetchBusinessProfile`로
+조회해 LocalBusiness JSON-LD를 자동 렌더할 수 있습니다 — 주소·영업시간을
+사이트 코드에 하드코딩할 필요가 없습니다.
+
+layout에 1회 렌더하면 충분합니다:
+
+```tsx
+// app/layout.tsx
+import {
+  fetchBusinessProfile,
+  localBusinessSchema,
+} from "@roottale/cms-client/server";
+
+const SITE_URL = process.env.NEXT_PUBLIC_SITE_URL!;
+
+export default async function RootLayout({ children }) {
+  // 어드민에서 미설정이면 null — 렌더를 건너뛴다.
+  const business = await fetchBusinessProfile({
+    apiKey: process.env.ROOTTALE_API_KEY!,
+  }).catch(() => null);
+
+  return (
+    <html lang="ko">
+      <body>
+        {business ? (
+          <script
+            type="application/ld+json"
+            dangerouslySetInnerHTML={{
+              __html: JSON.stringify(
+                localBusinessSchema(business, { url: SITE_URL }),
+              ),
+            }}
+          />
+        ) : null}
+        {children}
+      </body>
+    </html>
+  );
+}
+```
+
+`localBusinessSchema`가 만드는 것:
+
+- `@type`: `[업종, "LocalBusiness"]` (중복 제거) — 어드민에서 고른 업종
+  (세무·회계 = `AccountingService`, 병원·의원 = `MedicalClinic` 등)
+- `address`(PostalAddress) / `geo`(GeoCoordinates) /
+  `openingHoursSpecification` / `priceRange` / `areaServed`
+- `sameAs`: 어드민에 입력한 네이버플레이스·구글 비즈니스 프로필·카카오 채널
+  등의 URL — 검색엔진이 동일 사업장임을 연결합니다.
+
+네이버플레이스(new.smartplace.naver.com)와 구글 비즈니스 프로필
+(business.google.com) 등록 자체는 공개 API가 없어 사장님이 직접 해야 하며,
+어드민 화면에 등록 안내와 프로필 URL 입력란이 있습니다.
+
 ## Fleet 프로브 (운영 가시성)
 
 RootTale 운영 측이 배포 버전·헬스를 확인할 수 있는 well-known 라우트:
@@ -101,3 +293,44 @@ export const GET = createFleetInfoRoute({ site: "example" });
 
 `site`에는 사이트 식별용 슬러그를 넣습니다. 필수는 아니지만 운영 지원을
 받으려면 추가를 권장합니다.
+
+## AEO/GEO — llms.txt
+
+AI 검색·생성엔진(ChatGPT·Claude·Perplexity 등)의 크롤러는
+[llms.txt](https://llmstxt.org) 마크다운 인덱스로 사이트 구조와 콘텐츠를
+빠르게 파악합니다. 발행 글 목록(최대 100개)을 제목·요약과 함께 자동
+포함하므로, AI가 관련 질문에 답할 때 내 사이트의 글이 출처로 인용될
+가능성을 높입니다(AEO/GEO).
+
+```ts
+// app/llms.txt/route.ts
+import { createLlmsTxtRoute } from "@roottale/cms-renderer-next/routes";
+
+export const dynamic = "force-dynamic";
+
+export const GET = createLlmsTxtRoute({
+  apiKey: process.env.ROOTTALE_API_KEY!,
+  apiBase: process.env.ROOTTALE_API_BASE,
+  siteUrl: process.env.NEXT_PUBLIC_SITE_URL!,
+  title: "예시 사이트",
+  description: "예시 사이트 설명",
+  sections: [
+    // (선택) 서비스 소개 등 정적 페이지 링크 그룹 — 블로그 목록 앞에 출력
+    {
+      title: "주요 페이지",
+      links: [
+        {
+          title: "서비스 소개",
+          url: "https://example.com/services",
+          note: "제공 서비스 안내",
+        },
+        { title: "상담 문의", url: "https://example.com/contact" },
+      ],
+    },
+  ],
+});
+```
+
+API 조회가 실패해도 항상 200으로 헤더 부분을 반환합니다(빌드 사고 방지).
+발행 웹훅의 기본 `alsoRevalidate`에 `/llms.txt`가 포함되어 있어, 글을
+발행·수정하면 AI 크롤러용 인덱스도 자동으로 갱신됩니다.

package/docs/theme-and-settings.md

@@ -45,6 +45,31 @@ const display = resolvePostDisplay(settings, post);
 `RootTaleBlogPost` 컴포넌트를 쓰면 이 설정이 자동 반영됩니다 — 커스텀 UI를
 만들 때만 직접 조회하면 됩니다.
 
+## 비즈니스 프로필 (로컬 SEO) — fetchBusinessProfile
+
+어드민 **운영 > 비즈니스 프로필**에서 저장한 사업장 정보(이름·업종·주소·
+좌표·영업시간·네이버플레이스/구글 비즈니스 프로필 URL)를 조회합니다.
+
+```ts
+import {
+  fetchBusinessProfile,
+  localBusinessSchema,
+} from "@roottale/cms-client/server";
+
+const business = await fetchBusinessProfile({
+  apiKey: process.env.ROOTTALE_API_KEY!,
+});
+// 미설정이면 null. 설정돼 있으면 name, businessType, address, geo,
+// openingHours, priceRange, areaServed, profiles(sameAs용 URL) 포함.
+
+if (business) {
+  const jsonLd = localBusinessSchema(business, {
+    url: process.env.NEXT_PUBLIC_SITE_URL!,
+  });
+  // layout에 <script type="application/ld+json">으로 1회 렌더 (seo.md 참고)
+}
+```
+
 ## 분석 태그 — fetchAnalyticsConfig
 
 어드민에서 등록한 외부 분석 태그(GA4, Microsoft Clarity, Meta Pixel, 네이버)

package/examples/nextjs/app/blog/[slug]/opengraph-image.tsx

@@ -0,0 +1,30 @@
+// 동적 OG 이미지 — 글별 1200×630 소셜 공유 카드 (제목·날짜·브랜드).
+// 파일 컨벤션(opengraph-image.tsx)이라 Next 가 og:image meta 를 자동 주입.
+// X(트위터) 카드도 원하면 같은 내용으로 twitter-image.tsx 를 복제.
+import { ImageResponse } from "next/og";
+
+import {
+  createPostOgImage,
+  OG_IMAGE_CONTENT_TYPE,
+  OG_IMAGE_SIZE,
+} from "@roottale/cms-renderer-next/routes";
+
+export const size = OG_IMAGE_SIZE;
+export const contentType = OG_IMAGE_CONTENT_TYPE;
+
+const SITE_URL =
+  process.env.NEXT_PUBLIC_SITE_URL?.replace(/\/$/, "") || "https://example.com";
+
+export default createPostOgImage(
+  {
+    apiKey: process.env.ROOTTALE_API_KEY!,
+    apiBase: process.env.ROOTTALE_API_BASE,
+    siteUrl: SITE_URL,
+    title: "예시 사이트",
+    // 브랜드 색 커스텀 (선택):
+    // backgroundColor: "#10172a",
+    // accentColor: "#38bdf8",
+    // brandLabel: "예시",
+  },
+  { ImageResponse },
+);

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

@@ -1,8 +1,10 @@
 // 블로그 상세 페이지 — 본문은 RootTaleBlogPost(블록 JSON 렌더러)에 위임,
 // 메타데이터는 어드민 SEO 패널(metaJson.seo) 값을 우선 적용.
+// slug 변경 시: API가 옛 slug로도 글을 찾아 현재 slug로 응답 → 301 redirect.
 import type { Metadata } from "next";
-import { notFound } from "next/navigation";
+import { notFound, permanentRedirect } from "next/navigation";
 import { RootTaleBlogPost } from "@roottale/cms-renderer-next/server";
+import { postRedirectPath } from "@roottale/cms-renderer-next/routes";
 
 import { getAllPosts, getPost } from "@/lib/blog";
 
@@ -26,7 +28,9 @@ export async function generateMetadata({ params }: Props): Promise<Metadata> {
     title,
     description,
     ...(seo?.canonical ? { alternates: { canonical: seo.canonical } } : {}),
-    ...(seo?.noindex ? { robots: { index: false, follow: true } } : {}),
+    ...(seo?.noindex || seo?.nofollow
+      ? { robots: { index: !seo?.noindex, follow: !seo?.nofollow } }
+      : {}),
     openGraph: {
       type: "article",
       title,
@@ -41,6 +45,9 @@ export default async function PostPage({ params }: Props) {
   const { slug } = await params;
   const post = await getPost(slug);
   if (!post) notFound();
+  // 옛 slug 로 들어온 요청 → 현재 slug 로 301 (검색 순위 승계).
+  const redirect = postRedirectPath(post, slug);
+  if (redirect) permanentRedirect(redirect);
 
   return (
     <main>

package/examples/nextjs/app/layout.tsx

@@ -1,19 +1,44 @@
 // root layout — 렌더러 스타일은 여기서 1회 import (getting-started.md).
 import "@roottale/cms-renderer-next/styles";
 
+import {
+  fetchBusinessProfile,
+  localBusinessSchema,
+} from "@roottale/cms-client/server";
+
+const SITE_URL = process.env.NEXT_PUBLIC_SITE_URL ?? "https://example.com";
+
 export const metadata = {
   title: "예시 사이트",
   description: "RootTale CMS 연동 예시",
 };
 
-export default function RootLayout({
+export default async function RootLayout({
   children,
 }: {
   children: React.ReactNode;
 }) {
+  // 로컬 SEO — 어드민(운영 > 비즈니스 프로필)에서 사업장 정보를 저장하면
+  // LocalBusiness JSON-LD 를 자동 렌더. 미설정/실패 시 null → 렌더 건너뜀 (seo.md).
+  const business = await fetchBusinessProfile({
+    apiKey: process.env.ROOTTALE_API_KEY!,
+  }).catch(() => null);
+
   return (
     <html lang="ko">
-      <body>{children}</body>
+      <body>
+        {business ? (
+          <script
+            type="application/ld+json"
+            dangerouslySetInnerHTML={{
+              __html: JSON.stringify(
+                localBusinessSchema(business, { url: SITE_URL }),
+              ),
+            }}
+          />
+        ) : null}
+        {children}
+      </body>
     </html>
   );
 }

package/examples/nextjs/app/llms.txt/route.ts

@@ -0,0 +1,30 @@
+// llms.txt — AEO/GEO(AI 검색·생성엔진 최적화) 마크다운 인덱스.
+// AI 크롤러(ChatGPT/Claude/Perplexity 등)가 사이트 구조·발행 글을 빠르게 파악.
+import { createLlmsTxtRoute } from "@roottale/cms-renderer-next/routes";
+
+export const dynamic = "force-dynamic";
+
+const SITE_URL =
+  process.env.NEXT_PUBLIC_SITE_URL?.replace(/\/$/, "") || "https://example.com";
+
+export const GET = createLlmsTxtRoute({
+  apiKey: process.env.ROOTTALE_API_KEY!,
+  apiBase: process.env.ROOTTALE_API_BASE,
+  siteUrl: SITE_URL,
+  title: "예시 사이트",
+  description: "최신 소식과 인사이트",
+  sections: [
+    // (선택) 정적 페이지 링크 그룹 — 발행 글 목록("## 블로그")은 자동 포함됨.
+    {
+      title: "주요 페이지",
+      links: [
+        {
+          title: "서비스 소개",
+          url: `${SITE_URL}/services`,
+          note: "제공 서비스 안내",
+        },
+        { title: "상담 문의", url: `${SITE_URL}/contact` },
+      ],
+    },
+  ],
+});

package/examples/nextjs/components/site-nav.tsx

@@ -0,0 +1,46 @@
+// 헤더 네비게이션 — 어드민 "디자인 > 메뉴"(위치 핸들 primary)를 렌더.
+// 메뉴 미설정(null)이면 fallback 네비 — 항상 fallback 분기를 두세요.
+import Link from "next/link";
+
+import { fetchMenu } from "@roottale/cms-client/server";
+
+export async function SiteNav() {
+  const menu = await fetchMenu({
+    apiKey: process.env.ROOTTALE_API_KEY!,
+    baseUrl: process.env.ROOTTALE_API_BASE,
+    slug: "primary",
+  }).catch(() => null);
+
+  if (!menu) {
+    return (
+      <nav className="flex gap-4">
+        <Link href="/blog">블로그</Link>
+        <Link href="/contact">상담 문의</Link>
+      </nav>
+    );
+  }
+
+  return (
+    <nav className="flex gap-4">
+      {menu.items.map((item) => (
+        <div key={item.id} className="group relative">
+          <Link
+            href={item.url}
+            {...(item.newTab ? { target: "_blank", rel: "noopener" } : {})}
+          >
+            {item.label}
+          </Link>
+          {item.children?.length ? (
+            <div className="absolute hidden flex-col gap-2 bg-white p-3 shadow group-hover:flex">
+              {item.children.map((child) => (
+                <Link key={child.id} href={child.url}>
+                  {child.label}
+                </Link>
+              ))}
+            </div>
+          ) : null}
+        </div>
+      ))}
+    </nav>
+  );
+}

package/examples/nextjs/lib/blog.ts

@@ -30,6 +30,7 @@ export interface BlogPostMeta {
     canonical?: string;
     ogImage?: string;
     noindex?: boolean;
+    nofollow?: boolean;
   };
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@roottale/cms-mcp",
-  "version": "0.24.0",
+  "version": "0.32.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": {