@roottale/cms-mcp 0.24.0 → 0.25.0

package/CHANGELOG.md

@@ -1,5 +1,50 @@
 # @roottale/cms-mcp
 
+## 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.25.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

@@ -155,12 +155,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/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,135 @@ export default createSitemap(
 );
 ```
 
+## 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,
+} 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: "예시",
+  },
+  { ImageResponse },
+);
+```
+
+- `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 +189,7 @@ export default createSitemap(
 | `articleSchema(input)` | 블로그 글 상세 페이지 Article |
 | `breadcrumbSchema(items)` | 빵부스러기 |
 | `organizationSchema(input)` | 조직/사업체 |
+| `localBusinessSchema(profile, opts)` | 사업장 LocalBusiness (로컬 SEO — 아래 섹션) |
 | `websiteSchema(input)` | 웹사이트 |
 | `faqSchema(items)` | FAQ |
 
@@ -88,6 +213,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 +283,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.25.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": {