@roottale/cms-mcp 0.66.0 → 0.67.1

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @roottale/cms-mcp
 
+## 0.67.1
+
+### Patch Changes
+
+- 7eeb714: 공통 메타데이터·주소 이동 편집 조건 문서에 루트테일의 사이트별 기능 허용·제한을 반영하고, 메타데이터 수정 API의 403 코드(`upgrade_required`·`site_denied`·`billing_locked`)를 명시한다.
+
+## 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

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.66.0" : "dev";
+var VERSION = true ? "0.67.1" : "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.