@roottale/cms-mcp 0.65.1 → 0.67.0

package/CHANGELOG.md

@@ -1,5 +1,52 @@
 # @roottale/cms-mcp
 
+## 0.67.0
+
+### Minor Changes
+
+- 30d26ac: 공통 메타데이터 해석기·고유 경로 조회·Next SSR 빌더와 캐시 태그를 추가합니다. 기존 canonical과 강제 robots 정책을 보존하고 공유 이미지 대체 텍스트를 OG·X에 동일하게 적용합니다. 분류의 공유 전용 설정과 메타데이터 조회·수정 MCP 도구, Pro 하향 후 공개 적용 유지 계약을 문서와 예제에 반영합니다. 분류 색인 전환을 선언한 사이트가 공개 분류 응답의 `category_index_activated`를 확인한 뒤에만 분류 검색 제외를 적용하도록 안내합니다.
+
+### Patch Changes
+
+- ddaa23f: 고정 페이지에서 검색 제목·설명·공유 이미지를 편집하고 저장값을 복원하도록 연결한다. 공개 사이트의 페이지 SEO 조회와 캐시 갱신 계약을 안내한다.
+- 6c8785c: 사이트 코드에 고정 연결된 이미지 블록의 관리자 미리보기·편집 범위 선언과 배포 순서를 안내한다. 배치 규칙을 사용하는 기존 사이트의 동작은 유지한다.
+- 94af63e: 문의 폼 설정을 루트테일 관리자 전용 메뉴로 분리하고, 고객은 받은 문의에서 접수 내용을 관리하도록 연동 안내와 예제를 갱신합니다.
+
+## 0.66.0
+
+### Minor Changes
+
+- 7532c0f: 글을 여러 개 담는 활성 `data_only` 모델(`page` 프리셋 제외)은 저장할 때 `presentation.listPaths`가
+  1개 이상 있어야 합니다(관리 API `400 bad_request`, `details.reason: "list_paths_required"`).
+  이런 모델의 글 변경 웹훅은 더 이상 예전 `/blog` 경로로 떨어지지 않고 `listPaths`만 보냅니다.
+  공개 반영 확인은 `listPaths[0]`을 기준 화면으로 보고, 상세 모델이 적은 추가 화면도 확인합니다.
+- 716dc9b: 콘텐츠 모델 presentation에 `listPaths`(글을 목록으로 보여 주는 고정 화면)를 추가합니다.
+  `data_only`·`detail`·`category_tree`에서 쓸 수 있고, 글 변경 웹훅 `paths`에 함께 실립니다.
+  상세 주소가 없는 `data_only` 모델은 이 화면만 갱신하고, ROOT-ADMIN은 그 화면에서 현재
+  제목으로 공개 반영을 확인합니다. 공개 콘텐츠 모델 API 응답에도 `listPaths`가 포함됩니다.
+- bb7b516: 검색엔진 소유 확인 코드를 공개 테마 응답 `siteVerification`으로 내보냅니다.
+  고객이 ROOT-ADMIN 설정 → 연동에서 Google Search Console·네이버 서치어드바이저 코드를
+  붙여 넣으면 `theme.updated` 웹훅으로 바로 반영되고, 사이트는
+  `siteVerificationMetadata(theme.siteVerification)`를 루트 metadata `verification`에 넣어
+  메타태그로 출력합니다.
+
+### Patch Changes
+
+- da23c9e: AVCD 본문 기준으로 기본 읽기 폭을 720px, 행간을 1.7로 맞추고 제목 위계와 문단 간격을 정리합니다. 가져온 HTML 내부 문단에도 24px 간격을 적용하며 모바일 제목 크기를 조정합니다. 기존 테마 변수 재정의는 유지합니다.
+
+  글머리표·번호는 li에 적용되는 CSS reset에서도 유지됩니다. 강조·기울임·인용·코드·이미지·표까지 AVCD의 서식 체계를 적용하며 독립 본문과 가져온 HTML에도 적용합니다. 번호 목록의 시작 번호도 보존합니다. 모바일 제목은 AVCD 실측값인 22/20/18px입니다.
+
+  Pretendard(SIL OFL)를 포함하고 헤더 높이를 고려한 sticky 목차 오프셋과 hover/focus 링크 밑줄을 적용합니다. 제목 내부 고정 크기 마크도 반응형 제목 크기를 따릅니다.
+
+  글 제목은 데스크톱 44px/700/1.3, 모바일 28px/600/1.3으로 통일하고 제목 아래 12px 간격을 적용합니다. 문단에 저장된 고정 글자 크기·행간도 모바일 본문과 소제목 크기를 따르게 합니다. 데스크톱의 문단 서식과 모바일 색상·강조는 유지합니다. 모바일 목차는 닫힌 높이를 52px로 줄입니다.
+
+  본문 이미지를 읽기 폭까지 크게 표시하고 클릭·Enter·Space로 확대할 수 있습니다. 확대 화면은 2배 확대, Esc·닫기, 포커스 복귀를 지원합니다. 독립 본문용 `image-lightbox` 진입점도 제공합니다.
+
+- 1d2be30: 빈 분류 변경도 전체 분류 캐시와 레이아웃을 갱신합니다. 미디어 삭제의 CDN 정리·자동 재시도와 삭제 완료 응답 계약을 문서화합니다.
+- 8c6d6c1: 외부 문의 원장의 전체 스냅샷을 사이트별 전용 권한으로 동기화한다. 원본 접수일·유입·상태를 보존하고 중복·알림 재발송을 막으며, 원본에서 삭제된 문의를 사본에서도 제거한다. 관리자에서는 연결된 문의를 읽기 전용으로 제공한다.
+- e3ac05b: CMS 관리 API(`/v1/cms/posts…`, 분류 연결·삭제, 관련 콘텐츠)로 쓴 글 변경도 어드민 저장과 같은 발송 대기열을 거친다고 문서에 적었습니다. 웹훅 이벤트·`paths`는 어드민과 같고, 실패하면 자동 재시도하며 발행 알림 기록과 공개 화면 반영 확인에 남습니다. 관리 API의 분류 삭제는 이제 연결된 글마다 `post.updated`를 보내지 않고 `taxonomy.updated`를 한 번 보냅니다.
+- 5d52bbf: 글 미리보기 응답(`fetchPostPreview`)이 저장 전 커스텀 필드와 대표 이미지도 편집 중인 값으로 담는다는 점과, 편집기의 '공유 링크 복사'가 없어지고 '사이트 화면 미리보기' 하나만 남았다는 점을 문서에 반영합니다.
+
 ## 0.65.1
 
 ### Patch Changes

package/README.md

@@ -98,6 +98,9 @@ npx -y @roottale/cms-mcp cli entries publish "<post-id>"
 | `getTopSeoKeywords` | Google Search Console 상위 검색어 조회 |
 | `analyzeCmsPostSeo` | ROOT-ADMIN과 같은 규칙으로 글 SEO·가독성 분석 |
 | `getCmsPostSeoScores` | 발행 글의 최신 SEO 점수·등급 조회 |
+| `listCmsMetadata` | 메타데이터 대상 검색·페이지 조회 |
+| `getCmsMetadata` | 직접 설정·자동값·지원 필드·수정 버전 조회 |
+| `updateCmsMetadata` | Pro/Premium 메타데이터 부분 변경·자동값 복귀 |
 
 ## 사람용 문서 (브라우저 열람)
 

package/dist/index.js

@@ -1045,8 +1045,8 @@ async function callManagementTool(name, args) {
       return assertNever2(name);
   }
 }
-function get(pathname, query) {
-  return requestRootTaleApi({ method: "GET", pathname, query: optionalQuery2(query) });
+function get(pathname, query2) {
+  return requestRootTaleApi({ method: "GET", pathname, query: optionalQuery2(query2) });
 }
 function modelPath(modelKey) {
   return `/v1/cms/content-models/${encodeURIComponent(modelKey)}`;
@@ -1329,7 +1329,7 @@ import {
   ListToolsRequestSchema,
   McpError
 } from "@modelcontextprotocol/sdk/types.js";
-import { z as z5 } from "zod";
+import { z as z6 } from "zod";
 
 // src/docs.ts
 import { readdir, readFile as readFile3 } from "fs/promises";
@@ -1384,8 +1384,8 @@ async function readDoc(relPath) {
     return null;
   }
 }
-async function searchDocs(query) {
-  const regex = new RegExp(query, "i");
+async function searchDocs(query2) {
+  const regex = new RegExp(query2, "i");
   const matches = [];
   for (const doc of await listDocs()) {
     const content = await readDoc(doc.path);
@@ -1550,16 +1550,132 @@ function optionalQuery3(values) {
   );
 }
 
-// src/tools.ts
-var ReadDocInput = z5.object({ path: z5.string().min(1) }).strict();
-var SearchDocsInput = z5.object({ query: z5.string().min(1) }).strict();
-var ListPostsInput = z5.object({
+// src/metadata-tools.ts
+import { z as z5 } from "zod";
+var scopeProperties = {
+  siteId: { type: "string", description: "\uC0AC\uC774\uD2B8 ID" },
+  locale: { type: "string", description: "locale, \uC0DD\uB7B5\uD558\uBA74 \uC0AC\uC774\uD2B8 \uAE30\uBCF8 \uC5B8\uC5B4" }
+};
+var targetProperties = {
+  ...scopeProperties,
+  kind: { type: "string", enum: ["route", "post", "term"] },
+  key: { type: "string", description: "routeKey \uB610\uB294 \uAE00\xB7\uBD84\uB958 ID. \uBAA9\uB85D \uC751\uB2F5\uC758 key\uB97C \uC0AC\uC6A9" }
+};
+var METADATA_TOOL_DEFINITIONS = [
+  {
+    name: "listCmsMetadata",
+    description: "\uC0AC\uC774\uD2B8 \uBA54\uD0C0\uB370\uC774\uD130 \uB300\uC0C1\uC744 \uAC80\uC0C9\uD558\uACE0 cursor\uB85C \uC870\uD68C\uD569\uB2C8\uB2E4. \uAE30\uBCF8 \uC694\uAE08\uC81C\uC5D0\uC11C\uB3C4 \uC870\uD68C\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4.",
+    inputSchema: {
+      type: "object",
+      additionalProperties: false,
+      properties: {
+        ...scopeProperties,
+        kind: targetProperties.kind,
+        query: { type: "string", description: "\uC81C\uBAA9\xB7\uACF5\uAC1C \uC8FC\uC18C \uAC80\uC0C9" },
+        cursor: { type: "string" },
+        limit: { type: "integer", minimum: 1, maximum: 100 },
+        customized: { type: "boolean", description: "\uC9C1\uC811 \uC124\uC815 \uC5EC\uBD80 \uD544\uD130" }
+      }
+    }
+  },
+  {
+    name: "getCmsMetadata",
+    description: "\uBA54\uD0C0\uB370\uC774\uD130 \uC9C1\uC811 \uC124\uC815\xB7\uC790\uB3D9\uAC12\xB7\uCD5C\uC885\uAC12\xB7\uC9C0\uC6D0 \uD544\uB4DC\uC640 \uC218\uC815 \uBC84\uC804\uC744 \uC870\uD68C\uD569\uB2C8\uB2E4. \uC218\uC815 \uC804\uC5D0 \uC774 \uC751\uB2F5\uC744 \uD655\uC778\uD558\uC138\uC694.",
+    inputSchema: { type: "object", properties: targetProperties, required: ["kind", "key"], additionalProperties: false }
+  },
+  {
+    name: "updateCmsMetadata",
+    description: "Pro/Premium \uC0AC\uC774\uD2B8\uC758 \uD5C8\uC6A9\uB41C \uBA54\uD0C0\uB370\uC774\uD130\uB97C \uBD80\uBD84 \uBCC0\uACBD\uD569\uB2C8\uB2E4. expectedVersion\uC740 \uC9C1\uC804 \uC870\uD68C\uAC12\uC744 \uC4F0\uC138\uC694. null\uC740 \uC790\uB3D9\uAC12 \uBCF5\uADC0, \uBBF8\uC804\uC1A1\uC740 \uC720\uC9C0\uC774\uBA70 false\uB3C4 \uC800\uC7A5\uB429\uB2C8\uB2E4. \uACF5\uAC1C \uC0AC\uC774\uD2B8\uC5D0 \uBC18\uC601\uB420 \uC218 \uC788\uC2B5\uB2C8\uB2E4.",
+    inputSchema: {
+      type: "object",
+      additionalProperties: false,
+      required: ["kind", "key", "expectedVersion", "patch"],
+      properties: {
+        ...targetProperties,
+        expectedVersion: { type: "string", description: "\uC870\uD68C\uD55C \uB300\uC0C1\uC758 version. \uC9C1\uC811 \uB9CC\uB4E4\uAC70\uB098 \uC99D\uAC00\uC2DC\uD0A4\uC9C0 \uC54A\uC74C" },
+        patch: {
+          type: "object",
+          additionalProperties: false,
+          properties: {
+            title: { type: ["string", "null"], maxLength: 300 },
+            description: { type: ["string", "null"], maxLength: 2e3 },
+            ogImage: { type: ["string", "null"], maxLength: 2048 },
+            ogImageAlt: { type: ["string", "null"], maxLength: 500 },
+            noindex: { type: ["boolean", "null"] },
+            nofollow: { type: ["boolean", "null"] }
+          }
+        }
+      }
+    }
+  }
+];
+function isMetadataToolName(name) {
+  return METADATA_TOOL_DEFINITIONS.some((tool4) => tool4.name === name);
+}
+var Scope = z5.object({ siteId: z5.string().optional(), locale: z5.string().optional() });
+var Kind = z5.enum(["route", "post", "term"]);
+var Target = Scope.extend({ kind: Kind, key: z5.string().min(1) });
+var List = Scope.extend({
+  kind: Kind.optional(),
+  query: z5.string().optional(),
+  cursor: z5.string().optional(),
   limit: z5.number().int().min(1).max(100).optional(),
-  type: z5.enum(["post", "page"]).optional(),
-  cursor: z5.string().optional()
+  customized: z5.boolean().optional()
 }).strict();
-var GetPostInput = z5.object({ slugOrId: z5.string().min(1) }).strict();
-var GetSiteKnowledgeInput = z5.object({ siteId: z5.string().optional() }).strict();
+var nullableText = (max) => z5.string().trim().min(1).max(max).nullable().optional();
+var Update = Target.extend({
+  expectedVersion: z5.string().min(1),
+  patch: z5.object({
+    title: nullableText(300),
+    description: nullableText(2e3),
+    ogImage: nullableText(2048),
+    ogImageAlt: nullableText(500),
+    noindex: z5.boolean().nullable().optional(),
+    nofollow: z5.boolean().nullable().optional()
+  }).strict()
+}).strict();
+async function callMetadataTool(name, args) {
+  if (name === "listCmsMetadata") {
+    const input2 = List.parse(args);
+    return requestRootTaleApi({ method: "GET", pathname: "/v1/cms/metadata", query: query({
+      site_id: input2.siteId,
+      locale: input2.locale,
+      kind: input2.kind,
+      q: input2.query,
+      cursor: input2.cursor,
+      limit: input2.limit,
+      customized: input2.customized
+    }) });
+  }
+  if (name === "getCmsMetadata") {
+    const input2 = Target.strict().parse(args);
+    return requestRootTaleApi({ method: "GET", pathname: targetPath(input2), query: query({ site_id: input2.siteId, locale: input2.locale }) });
+  }
+  const input = Update.parse(args);
+  return requestRootTaleApi({ method: "PATCH", pathname: targetPath(input), body: {
+    ...input.siteId !== void 0 ? { site_id: input.siteId } : {},
+    ...input.locale !== void 0 ? { locale: input.locale } : {},
+    expected_version: input.expectedVersion,
+    patch: input.patch
+  } });
+}
+function targetPath(input) {
+  return `/v1/cms/metadata/${input.kind}/${encodeURIComponent(input.key)}`;
+}
+function query(input) {
+  return Object.fromEntries(Object.entries(input).flatMap(([key, value]) => value === void 0 ? [] : [[key, String(value)]]));
+}
+
+// src/tools.ts
+var ReadDocInput = z6.object({ path: z6.string().min(1) }).strict();
+var SearchDocsInput = z6.object({ query: z6.string().min(1) }).strict();
+var ListPostsInput = z6.object({
+  limit: z6.number().int().min(1).max(100).optional(),
+  type: z6.enum(["post", "page"]).optional(),
+  cursor: z6.string().optional()
+}).strict();
+var GetPostInput = z6.object({ slugOrId: z6.string().min(1) }).strict();
+var GetSiteKnowledgeInput = z6.object({ siteId: z6.string().optional() }).strict();
 var DOCUMENTATION_TOOL_DEFINITIONS = [
   {
     name: "listRootTaleDocs",
@@ -1639,7 +1755,8 @@ var TOOL_DEFINITIONS = [
   ...DOCUMENTATION_TOOL_DEFINITIONS,
   ...AUTOMATION_TOOL_DEFINITIONS,
   ...MANAGEMENT_TOOL_DEFINITIONS,
-  ...SEO_TOOL_DEFINITIONS
+  ...SEO_TOOL_DEFINITIONS,
+  ...METADATA_TOOL_DEFINITIONS
 ];
 function textResponse(text) {
   return { content: [{ type: "text", text }] };
@@ -1662,6 +1779,9 @@ function registerTools(server) {
       if (isSeoToolName(request.params.name)) {
         return jsonResponse(await callSeoTool(request.params.name, args));
       }
+      if (isMetadataToolName(request.params.name)) {
+        return jsonResponse(await callMetadataTool(request.params.name, args));
+      }
       if (isManagementToolName(request.params.name)) {
         return jsonResponse(await callManagementTool(request.params.name, args));
       }
@@ -1735,7 +1855,7 @@ function registerTools(server) {
 }
 
 // src/server.ts
-var VERSION = true ? "0.65.1" : "dev";
+var VERSION = true ? "0.67.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\uACE0
 \uAE00\xB7\uC378\uB124\uC77C\xB7\uBCF8\uBB38 \uC774\uBBF8\uC9C0\uB97C \uC790\uB3D9\uD654\uD558\uAE30 \uC704\uD55C \uBB38\uC11C\xB7\uC608\uC2DC \uCF54\uB4DC\xB7API tool\uC744 \uC81C\uACF5\uD569\uB2C8\uB2E4.