@roottale/cms-mcp 0.37.0 → 0.39.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @roottale/cms-mcp
 
+## 0.39.0
+
+### Patch Changes
+
+- chore: linked cms-\* 그룹 버전 정렬 — cms-media(0.27.0)·cms-mcp(0.37.0) 이
+  부분 릴리스로 그룹(0.38.0)에서 드리프트. 6개 linked 패키지를 한 릴리스에 묶어
+  공통 버전으로 재정렬한다.
+
 ## 0.37.0
 
 ### Minor Changes

package/dist/index.js

@@ -279,7 +279,7 @@ function registerTools(server2) {
 }
 
 // src/server.ts
-var VERSION = true ? "0.37.0" : "dev";
+var VERSION = true ? "0.39.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/theme-and-settings.md

@@ -88,6 +88,53 @@ const config = await fetchAnalyticsConfig({
 `enabled: true`인 태그만 렌더링하세요. 태그 ID는 어드민에서 변경될 수
 있으므로 하드코딩하지 말고 본 API로 조회하는 것을 권장합니다.
 
+## 조회수 / first-party 비콘
+
+RootTale 비콘은 쿠키리스 first-party 분석(방문수·클릭)과 **글별 조회수**를
+수집합니다. **API 키 하나로** 동작합니다 — 별도 사이트 ID 환경변수가 필요 없습니다.
+`fetchAnalyticsConfig`가 돌려주는 `siteId`를 비콘에 그대로 넘기세요.
+
+```tsx
+// app/layout.tsx (Next.js) — 서버 컴포넌트
+import { renderBeaconScript } from "@roottale/analytics-runtime";
+import { fetchAnalyticsConfig } from "@roottale/cms-client/server";
+
+const cfg = await fetchAnalyticsConfig({ apiKey: process.env.ROOTTALE_API_KEY! });
+// ...<body> 안에:
+<script
+  dangerouslySetInnerHTML={{
+    __html: renderBeaconScript({
+      collectUrl: "https://api.roottale.com/v1/collect",
+      siteId: cfg.siteId, // ← API 키에서 유도. 별도 env 불필요.
+    }),
+  }}
+/>
+```
+
+**글별 조회수**가 정확히 집계되려면, 글 상세 페이지가 자신의 글 ID를
+`<meta name="rt:content-id">`로 노출해야 합니다. 비콘이 이 값을 읽어 조회를 해당
+글에 귀속시킵니다(URL·경로가 바뀌어도 안정적).
+
+```tsx
+// app/blog/[slug]/page.tsx — generateMetadata
+export async function generateMetadata({ params }): Promise<Metadata> {
+  const post = await fetchPost({ apiKey: process.env.ROOTTALE_API_KEY!, slugOrId: slug });
+  return {
+    title: post.title,
+    other: { "rt:content-id": post.id }, // ← 조회수 식별자
+  };
+}
+```
+
+> `@roottale/cms-renderer-next`의 `buildPostMetadata(post, …)`를 쓰면 이 meta가
+> **자동으로** 들어갑니다(별도 작업 불필요). 프레임워크 무관 환경(Astro 등)에서는
+> `@roottale/cms-client/server`의 `contentIdMeta(post.id)`가 같은 `<meta>` 태그
+> 문자열을 만들어 줍니다.
+
+수집은 익명·쿠키리스이며 비콘은 클릭(`data-track`)과 pageview만 보냅니다. 봇
+트래픽은 서버에서 제외됩니다. 공개 사이트에 "조회 N"을 표시하는 옵션은 어드민의
+사이트 설정에서 켤 수 있습니다(켜면 글 응답에 `view_count`가 포함됩니다).
+
 ## 사이트 지식 — 브랜드 보이스 (AI 에이전트용)
 
 이 사이트의 **브랜드 보이스**(어조·톤·화자)와 **용어 규칙**(금지어·교정어)을

package/package.json

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