@modootoday/datalab-extension-mcp 1.7.0 → 1.8.0

package/dist/cli.js

@@ -1,9 +1,11 @@
 #!/usr/bin/env node
 import {
   dispatchCli,
-  runAdapter,
+  runAdapter
+} from "./chunk-NKUU3DAF.js";
+import {
   runDaemon
-} from "./chunk-NYUIYZG6.js";
+} from "./chunk-6JBLBCLU.js";
 import "./chunk-MLKGABMK.js";
 
 // src/cli.ts
@@ -15,7 +17,7 @@ function log(message) {
 `);
 }
 async function runInstaller(sub, argv) {
-  const { createNodeIo, runInstall, runUninstall } = await import("./dist-WMNHKGZR.js");
+  const { createNodeIo, runInstall, runUninstall } = await import("./dist-JICXADYR.js");
   const opts = { version: VERSION };
   for (let i = 0; i < argv.length; i += 1) {
     const flag = argv[i];
@@ -23,6 +25,9 @@ async function runInstaller(sub, argv) {
     else if (flag === "--extension-id") opts.extensionId = argv[i += 1];
     else if (flag === "--port") opts.port = argv[i += 1];
     else if (flag === "--yes" || flag === "-y") opts.yes = true;
+    else if (flag === "--no-skills") opts.skills = false;
+    else if (flag === "--skills") opts.skills = true;
+    else if (flag === "--all-skills") opts.allSkills = true;
     else if (flag === "--host") {
       opts.hosts = opts.hosts ?? [];
       const host = argv[i += 1];
@@ -53,7 +58,62 @@ async function main() {
       // The host config pins an exact version, so without this a paired user
       // never receives a release. `--no-self-update` keeps this build.
       selfUpdate: !process.argv.slice(2).includes("--no-self-update")
-    })
+    }),
+    // Loaded lazily, like the installer: the adapter path is what an MCP host
+    // spawns and must not pay for a command only an operator types.
+    browsers: async (argv) => {
+      const { runBrowsers } = await import("./browsers-KHRZKQVP.js");
+      const { createNodeIo } = await import("./dist-JICXADYR.js");
+      const io = createNodeIo();
+      const code = await runBrowsers(argv, {
+        env: process.env,
+        // stdout, unlike everything else here. This one is a person reading
+        // a terminal, and the MCP transport is not in play on this path.
+        out: (line) => process.stdout.write(`${line}
+`),
+        // Only when somebody is there. Piped stdin gets the instruction that
+        // names the next step instead of a prompt nobody will answer.
+        ...io.isInteractive() ? { prompt: io.prompt.bind(io) } : {}
+      });
+      process.exit(code);
+    },
+    // Same lazy load, and the same reason: an MCP host spawning the adapter
+    // must not pay to resolve the installer.
+    skills: async (argv) => {
+      const { runSkills } = await import("./skills-ACWHUGX7.js");
+      const {
+        createNodeIo,
+        listSkills,
+        skillStatus,
+        attachSkill,
+        detachSkill,
+        skillsPayloadRoot
+      } = await import("./dist-JICXADYR.js");
+      const io = createNodeIo();
+      const root = skillsPayloadRoot();
+      const code = await runSkills(argv, {
+        out: (line) => process.stdout.write(`${line}
+`),
+        list: () => listSkills(io, root),
+        status: () => skillStatus(io, root),
+        // The marker records the version that placed it, so this must be the
+        // build doing the placing — not whatever the host config once pinned.
+        attach: (slug) => attachSkill(io, root, slug, VERSION),
+        detach: (slug) => detachSkill(io, root, slug)
+      });
+      process.exit(code);
+    },
+    // Said out loud and refused. Left to fall through, a typo would speak
+    // the MCP protocol at the terminal — nothing on screen, since diagnostics
+    // go to stderr — and start a connector on the way.
+    unknown: (sub) => {
+      log(`unknown command "${sub}".`);
+      log(`usage: ${NAME} [install|uninstall|serve|browsers|skills]`);
+      log(`  browsers [add <label>|list|revoke <handle>] [--token <t>]`);
+      log(`  skills [list|status|attach <slug>|detach <slug>]`);
+      log(`run with no command to serve an MCP host over stdio.`);
+      process.exit(2);
+    }
   });
 }
 main().catch((err) => {

package/dist/dist-JICXADYR.js

@@ -0,0 +1,105 @@
+import {
+  BACKUP_KEEP,
+  CLI_HOSTS,
+  CODEX_CHATGPT_NOTE,
+  DEFAULT_PORT,
+  EXTENSION_ID_RE,
+  FILE_HOSTS,
+  INSTALLABLE_CLIS,
+  INSTALL_SUBTITLE,
+  INVALID_EXTENSION_ID_MESSAGE,
+  INVALID_PORT_MESSAGE,
+  INVALID_TOKEN_MESSAGE,
+  INVALID_VERSION_MESSAGE,
+  NOTHING_CHANGED,
+  NO_HOSTS_DETECTED,
+  PACKAGE_NAME,
+  PERMISSION_DENIED_HINT,
+  PORT_RE,
+  RESTART_NOTICE,
+  SERVER_NAME,
+  SERVER_PACKAGE,
+  SNIPPET_HOSTS,
+  SUPPORTED_APPS,
+  TOKEN_PROMPT_GUIDE,
+  TOKEN_PROMPT_QUESTION,
+  TOKEN_RE,
+  TOKEN_REQUIRED_NON_INTERACTIVE,
+  UNINSTALL_DONE,
+  UNINSTALL_SUBTITLE,
+  UNINSTALL_TOKEN_REMINDER,
+  VERSION_RE,
+  attachSkill,
+  buildEnv,
+  buildFileEntry,
+  createNodeIo,
+  detachSkill,
+  detectHosts,
+  formatBackupTimestamp,
+  installQuestion,
+  listSkills,
+  packageSpec,
+  printBanner,
+  removeServerKey,
+  runInstall,
+  runUninstall,
+  skillStatus,
+  skillsPayloadRoot,
+  uninstallQuestion,
+  upsertServerKey,
+  validateInstallOptions,
+  validateUninstallOptions
+} from "./chunk-5S7RFXIU.js";
+import "./chunk-MLKGABMK.js";
+export {
+  BACKUP_KEEP,
+  CLI_HOSTS,
+  CODEX_CHATGPT_NOTE,
+  DEFAULT_PORT,
+  EXTENSION_ID_RE,
+  FILE_HOSTS,
+  INSTALLABLE_CLIS,
+  INSTALL_SUBTITLE,
+  INVALID_EXTENSION_ID_MESSAGE,
+  INVALID_PORT_MESSAGE,
+  INVALID_TOKEN_MESSAGE,
+  INVALID_VERSION_MESSAGE,
+  NOTHING_CHANGED,
+  NO_HOSTS_DETECTED,
+  PACKAGE_NAME,
+  PERMISSION_DENIED_HINT,
+  PORT_RE,
+  RESTART_NOTICE,
+  SERVER_NAME,
+  SERVER_PACKAGE,
+  SNIPPET_HOSTS,
+  SUPPORTED_APPS,
+  TOKEN_PROMPT_GUIDE,
+  TOKEN_PROMPT_QUESTION,
+  TOKEN_RE,
+  TOKEN_REQUIRED_NON_INTERACTIVE,
+  UNINSTALL_DONE,
+  UNINSTALL_SUBTITLE,
+  UNINSTALL_TOKEN_REMINDER,
+  VERSION_RE,
+  attachSkill,
+  buildEnv,
+  buildFileEntry,
+  createNodeIo,
+  detachSkill,
+  detectHosts,
+  formatBackupTimestamp,
+  installQuestion,
+  listSkills,
+  packageSpec,
+  printBanner,
+  removeServerKey,
+  runInstall,
+  runUninstall,
+  skillStatus,
+  skillsPayloadRoot,
+  uninstallQuestion,
+  upsertServerKey,
+  validateInstallOptions,
+  validateUninstallOptions
+};

package/dist/index.d.ts

@@ -15,7 +15,7 @@ import { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
 /**
  * The version the operator currently publishes as canonical.
  *
- * 🔴 Asked of OUR gateway, never of npm directly. A floating `@latest` in the
+ * Asked of OUR gateway, never of npm directly. A floating `@latest` in the
  * host config would let whoever controls the registry push code next to a
  * logged-in browser session; this keeps the decision on a surface we own, with
  * a rollback lever behind it. A failure returns null and changes nothing.
@@ -126,11 +126,29 @@ interface CliHandlers {
     install: (sub: "install" | "uninstall", argv: readonly string[]) => Promise<void>;
     serve: () => void;
     adapter: () => Promise<void>;
+    /** Registering browsers, against the connector that is running. */
+    browsers: (argv: readonly string[]) => Promise<void>;
+    /** What we ship and what is placed — reads only, runs no connector. */
+    skills: (argv: readonly string[]) => Promise<void>;
+    /**
+     * A word we do not know. Injected so the refusal is testable without a
+     * process; production prints usage and exits non-zero.
+     */
+    unknown: (sub: string) => void;
 }
 /**
- * Route argv to one of the three subcommand handlers. Kept out of the entry so
- * the routing is testable with injected handlers. The default, with no
- * recognised subcommand, is the adapter — what an MCP host spawns.
+ * Route argv to one of the subcommand handlers. Kept out of the entry so the
+ * routing is testable with injected handlers. The default, with no subcommand
+ * at all, is the adapter — what an MCP host spawns.
+ *
+ * A word we do not recognise is refused rather than treated as the default.
+ * Falling through would answer a typo by speaking the MCP protocol at a person's
+ * terminal: silent, since diagnostics go to stderr, and it would start a
+ * connector and schedule its own replacement on the way.
+ *
+ * Flags still fall through. Hosts pass those, and only those — every config
+ * this installer writes is `["-y", "<spec>"]`, so nothing it produces reaches
+ * the refusal.
  */
 declare function dispatchCli(argv: readonly string[], handlers: CliHandlers): Promise<void>;
 

package/dist/index.js

@@ -3,7 +3,8 @@ import {
   dispatchCli,
   ensureDaemonRunning,
   runAdapter
-} from "./chunk-NYUIYZG6.js";
+} from "./chunk-NKUU3DAF.js";
+import "./chunk-6JBLBCLU.js";
 import "./chunk-MLKGABMK.js";
 export {
   createAdapterServer,

package/dist/skills-ACWHUGX7.js

@@ -0,0 +1,101 @@
+import "./chunk-MLKGABMK.js";
+
+// src/skills.ts
+var USAGE = "usage: skills [list|status|attach <slug>|detach <slug>]";
+var REFUSAL_TEXT = {
+  unmarked: "\uB2E4\uB978 \uB3C4\uAD6C\uAC00 \uB9CC\uB4E0 \uD3F4\uB354",
+  foreign: "\uB2E4\uB978 \uB3C4\uAD6C\uAC00 \uC124\uCE58\uD55C \uC2A4\uD0AC",
+  unreadable: "\uD45C\uC2DD\uC744 \uC77D\uC744 \uC218 \uC5C6\uC74C"
+};
+function renderList(skills) {
+  if (skills.length === 0) {
+    return ["\uC774 \uBE4C\uB4DC\uC5D0\uB294 \uC2A4\uD0AC\uC774 \uB4E4\uC5B4 \uC788\uC9C0 \uC54A\uC544\uC694."];
+  }
+  const lines = [`\uC2A4\uD0AC ${skills.length}\uAC1C`, ""];
+  for (const s of skills) {
+    lines.push(`  ${s.slug}`);
+    if (s.description !== "") lines.push(`    ${s.description}`);
+  }
+  return lines;
+}
+function renderDir(d) {
+  const lines = ["", `  ${d.dir}`, `    ${d.hosts.join(" \xB7 ")}`];
+  if (d.ours.length === 0 && d.refused.length === 0) {
+    lines.push("    \uC124\uCE58\uB41C \uC2A4\uD0AC \uC5C6\uC74C");
+    return lines;
+  }
+  const versions = [...new Set(d.ours.map((o) => o.version))];
+  if (d.ours.length > 0) {
+    lines.push(`    \uC124\uCE58\uB428 ${d.ours.length}\uAC1C \xB7 ${versions.join(", ")}`);
+  }
+  if (d.absent.length > 0) {
+    lines.push(`    \uC774 \uBE4C\uB4DC\uC5D0 \uC788\uC73C\uB098 \uC5EC\uAE30 \uC5C6\uC74C ${d.absent.length}\uAC1C`);
+  }
+  for (const r of d.refused) {
+    lines.push(`    ${r.slug} \u2014 ${REFUSAL_TEXT[r.refusal] ?? r.refusal}`);
+  }
+  return lines;
+}
+function renderStatus(status) {
+  const lines = [];
+  if (status.dirs.length === 0) {
+    lines.push("\uC2A4\uD0AC\uC744 \uC77D\uB294 \uC571\uC744 \uCC3E\uC9C0 \uBABB\uD588\uC5B4\uC694.");
+  } else {
+    lines.push("\uC2A4\uD0AC \uC0C1\uD0DC");
+    for (const d of status.dirs) lines.push(...renderDir(d));
+  }
+  if (status.unsupported.length > 0) {
+    lines.push("", "  \uC2A4\uD0AC\uC744 \uC77D\uC9C0 \uC54A\uB294 \uC571");
+    for (const u of status.unsupported) {
+      lines.push(`    ${u.host} \u2014 ${u.reason}`);
+    }
+  }
+  return lines;
+}
+function renderMove(slug, verb, result) {
+  if (result.kind === "unknown-slug") {
+    return [
+      `"${slug}" \uC740 \uC774 \uBE4C\uB4DC\uC5D0 \uC5C6\uB294 \uC2A4\uD0AC\uC774\uC5D0\uC694.`,
+      ...result.shipped.map((s) => `  ${s}`)
+    ];
+  }
+  if (result.outcomes.length === 0) {
+    return ["\uC2A4\uD0AC\uC744 \uC77D\uB294 \uC571\uC744 \uCC3E\uC9C0 \uBABB\uD588\uC5B4\uC694."];
+  }
+  const lines = [];
+  for (const o of result.outcomes) {
+    const where = `${o.dir} (${o.hosts.join(" \xB7 ")})`;
+    lines.push(
+      o.refusal === void 0 ? `  ${verb} \u2014 ${where}` : `  \uAC74\uB108\uB700 \u2014 ${where}: ${REFUSAL_TEXT[o.refusal] ?? o.refusal}`
+    );
+  }
+  return lines;
+}
+async function runSkills(argv, deps) {
+  const action = argv[0] ?? "list";
+  const slug = argv[1] ?? "";
+  if (action === "list") {
+    for (const line of renderList(await deps.list())) deps.out(line);
+    return 0;
+  }
+  if (action === "status") {
+    for (const line of renderStatus(await deps.status())) deps.out(line);
+    return 0;
+  }
+  if (action === "attach" || action === "detach") {
+    if (slug === "") {
+      deps.out(`usage: skills ${action} <slug>`);
+      return 2;
+    }
+    const result = action === "attach" ? await deps.attach(slug) : await deps.detach(slug);
+    const verb = action === "attach" ? "\uB123\uC5C8\uC5B4\uC694" : "\uBE90\uC5B4\uC694";
+    for (const line of renderMove(slug, verb, result)) deps.out(line);
+    return result.kind === "unknown-slug" ? 2 : 0;
+  }
+  deps.out(USAGE);
+  return 2;
+}
+export {
+  USAGE,
+  runSkills
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modootoday/datalab-extension-mcp",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",
@@ -15,7 +15,8 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "skills"
   ],
   "scripts": {
     "build": "tsup",
@@ -29,9 +30,6 @@
     "node": ">=22.0.0",
     "bun": ">=1.3.0"
   },
-  "publishConfig": {
-    "access": "public"
-  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/modootoday/datalab-extension-mcp.git",

package/skills/datalab-ad-disclosure-check/SKILL.md

@@ -0,0 +1,74 @@
+---
+name: datalab-ad-disclosure-check
+description: 블로그·SNS 글에 협찬/광고 표시 문구가 필요한지 확인한다. 붙여넣은 초안을 번들된 공정위 심사지침·표시광고법 원문에 대조해 표시 문구 유무를 점검한다. 위반 여부를 판정하지 않고, 원문에 없는 조항은 인용하지 않는다.
+license: Proprietary
+---
+
+# 광고 표시 문구 점검
+
+협찬·광고성 글에 표시 문구가 있어야 하는지, 있다면 초안에 그 문구가 실제로 있는지를
+확인한다. **판정 도구가 아니다.** 표시 문구가 있는지 없는지를 원문 인용과 함께 사실대로
+보여주는 것까지가 이 스킬의 일이다.
+
+## 무엇을 읽고 시작하나
+
+사용자가 붙여넣은 글이 유일한 입력이다. 도구로 에디터를 대신 읽지 않는다 — 광고 표시
+여부는 결과가 무거운 판단이라, 사용자가 무엇을 검토 대상으로 삼았는지 스스로 알고 있어야
+한다.
+
+글이 없으면 붙여넣어 달라고 하고 멈춘다. **지어내지 않는다.**
+
+## 절차
+
+**1. 경제적 이해관계가 있는지 먼저 확인한다.**
+현금·제품·상품권·적립포인트·할인·고용 관계·판매 수수료 중 하나라도 광고주로부터 받았는지
+사용자에게 확인한다. 없다고 답하면 표시 의무 논의 자체가 필요 없다 —
+`references/ad-disclosure-rules.md` §1 의 예외 항목을 인용하고 종료한다.
+
+**2. 있다면 어떤 매체인지 확인한다.**
+글(블로그 본문) / 사진 / 동영상 / 실시간 방송 — 매체마다 표시 위치와 형식 요건이 다르다.
+`references/ad-disclosure-rules.md` §3 에서 해당 매체 항목만 인용한다.
+
+**3. 초안을 대조한다.**
+붙여넣은 글에서 표시 문구를 찾는다. 찾았으면 그 문장을 그대로 인용하고 §3 의 요건과
+비교해 위치·명확성 조건을 충족하는지 **사실만** 말한다 (예: "제목이 아니라 본문 중간에
+있다", "'체험단'이라고만 쓰여 있는데 §2 는 이것을 명확한 표시로 보지 않는 예로 든다").
+못 찾았으면 "표시 문구를 찾지 못했다"고만 말한다.
+
+**4. 결과를 낸다.**
+
+```
+## 표시 의무
+{예/아니오/불명확} — 근거: {ad-disclosure-rules.md 해당 절 인용}
+
+## 초안 대조
+- 발견한 표시 문구: {"..." 그대로 인용} 또는 "찾지 못함"
+- 매체별 요건 대조: {§3 항목과 비교한 사실}
+
+## 확인이 필요한 부분
+{판단하지 않고 사용자가 직접 확인해야 하는 지점}
+```
+
+## 지어내지 않는다
+
+- `references/` 두 파일에 없는 조항 번호·고시명·판례 번호는 **쓰지 않는다.** 모른다고
+  말하고 멈춘다.
+- "위반입니다" / "괜찮습니다" / "안전합니다" 라는 최종 판정을 **내리지 않는다.** 표시
+  문구가 안 보인다는 것은 사실이지 위반 판정이 아니다 — 사진 안이나 첫 댓글처럼 이 스킬이
+  못 보는 곳에 있을 수 있다.
+- 위험도 점수·과징금 예상액·적발 확률 같은 수치를 만들지 않는다. 셀 방법이 없다.
+
+## 없는 것 (찾지 마라)
+
+- 이용약관·개인정보처리방침·면책조항을 **작성**하는 기능은 없다. 이미 쓴 글을 점검만 한다.
+- 부동산·금융상품·환경 표시광고, 임시중지명령, 과징금 산정은 다루지 않는다.
+  `references/ad-disclosure-rules.md` 밖의 질문이 오면 범위 밖이라고 말한다.
+- 글을 대신 고치거나 에디터에 적용하는 기능은 없다. 무엇이 필요한지만 말한다.
+
+## 면책
+
+이 스킬의 결과는 법률 자문이 아니다. 실제 위반 여부와 제재 수준 판단은 변호사 또는
+공정거래위원회 상담을 통해 확인해야 한다.
+
+번들된 원문은 **특정 시점의 사본**이고 법령은 개정된다. 매 답변에서 인용이 사본
+기준임을 밝히고, 실제 판단 전에 현행 조문을 확인하라고 안내한다.

package/skills/datalab-ad-disclosure-check/references/ad-disclosure-rules.md

@@ -0,0 +1,98 @@
+# 광고 표시 의무 원문 발췌
+
+출처: 표시·광고의 공정화에 관한 법률(표시광고법) 제3조 / 추천·보증 등에 관한 표시·광고
+심사지침 §5. **이 문서에 있는 조항만 인용한다.** 여기 없는 조항 번호를 만들어내지 않는다.
+
+**이 발췌는 특정 시점의 사본이고 시행일이 확인되지 않았다.** 법령과 고시는 개정된다 —
+이 문서가 현행과 다를 수 있다. 답변할 때마다 다음을 함께 말한다: 인용은 번들된 사본
+기준이며, 실제 판단 전에 국가법령정보센터나 공정거래위원회에서 **현행 조문을 확인해야
+한다.** 사용자가 개정 여부를 물으면 확인할 방법이 없다고 말한다 — 최신이라고 단정하지
+않는다.
+
+## §0. 부당한 표시·광고 행위의 금지 (표시광고법 제3조)
+
+> 제3조(부당한 표시·광고 행위의 금지) ① 사업자등은 소비자를 속이거나 소비자로 하여금
+> 잘못 알게 할 우려가 있는 표시·광고 행위로서 공정한 거래질서를 해칠 우려가 있는 다음
+> 각 호의 행위를 하거나 다른 사업자등으로 하여금 하게 하여서는 아니 된다.
+>
+> 1. 거짓·과장의 표시·광고
+> 2. 기만적인 표시·광고
+> 3. 부당하게 비교하는 표시·광고
+> 4. 비방적인 표시·광고
+
+경제적 이해관계를 숨기고 자발적 후기처럼 쓴 협찬글이 "기만적인 표시·광고"에 해당할 수
+있다는 것이 아래 §1 의 근거다. 표시광고법 자체에는 "광고표시 의무"라는 이름의 독립 조항이
+없다 — 의무의 실체는 아래 심사지침에서 나온다.
+
+## §1. 경제적 이해관계 공개 의무 — 언제 필요한가
+
+> 가. 광고주와 추천·보증인과의 사이에 추천·보증 등의 내용이나 신뢰도 등에 영향을 미칠 수
+> 있는 경제적 이해관계가 존재하는 경우에는 광고주 또는 추천·보증인은 이러한 경제적
+> 이해관계를 공개하여야 한다.
+>
+> 예를 들어 추천·보증인이 광고주로부터 현금이나 해당 제품, 상품권, 적립포인트, 할인 혜택
+> 등 경제적 대가를 받거나 광고주로부터 직접 고용된 상태에서 추천·보증, 공동구매 주선 등을
+> 하는 경우, 추천·보증 등을 하는 매 건마다 당해 추천·보증 등이 상업적 표시 또는 광고에
+> 해당된다는 사실을 소비자들이 알 수 있도록 경제적 이해관계를 명확히 표시하여야 한다.
+
+**표시가 필요한 경우의 예시** (원문):
+
+- 광고주로부터 상품권을 받고 SNS 상에서 해당 상품의 후기를 작성한 경우
+- 상품 구매 시 할인 혜택을 받고 후기를 작성하기로 한 후 사용후기를 작성한 경우
+- 할인코드나 구매링크를 포함해 추천글을 작성하고 판매실적에 따라 수수료를 받는 경우
+- 자신의 비용으로 구매했지만 추천글 게재 후 구매대금을 환급받는 경우
+
+**표시하지 않을 수 있는 예외** (원문):
+
+> 다만, 경제적 이해관계가 존재하더라도 추천·보증 등의 내용이나 신뢰도 등에 영향을 미치지
+> 아니하는 예외적인 경우에는 이를 표시하지 않을 수 있다.
+
+- 신청자 전원에게 지급되는 샘플을 받아 사용 후 자발적으로 후기를 게재한 경우
+- 행사 참가자 전원에게 지급된 기념품을 받은 후 자발적으로 참가후기를 게재한 경우
+
+## §2. 표시 문구가 "명확한 내용"인지 판단하는 기준
+
+> (3) 명확한 내용으로 표시한다. 금전적 지원, 할인, 협찬 등 경제적 이해관계의 내용을
+> 소비자가 이해하기 쉽도록 명확하게 표시한다.
+
+**명확한 표시로 인정되는 표현** (원문): '위 상품을 추천하면서 대가(현금, 상품권, 수수료,
+포인트, 무료 상품 등)를 받았음', '금전적 지원', '대가성 광고', '무료 상품', '상품 협찬',
+'상품 할인', '#광고', '#협찬'
+
+**명확한 표시로 인정되지 않는 표현** (원문): '체험 후기', '일주일 동안 사용해 보았음',
+'체험단', '이 글은 정보/홍보성 글임', '선물', '~에서 보내주셨어요', '소정의 수수료를
+지급받을 수 있음', 브랜드·상품명만 해시태그로 언급, '[브랜드명]×[계정명]' 같은 협업 표기,
+'Sponsor' · 'AD' · 'Collabo' 등 외국어만 사용한 경우
+
+## §3. 매체별 표시 위치·형식 요건
+
+**글 (블로그·카페 게시물)**
+
+- 표시문구는 게시물의 제목 또는 첫 부분에 게재한다.
+- 첫 부분에 게재하는 경우 글자 크기를 본문보다 크게 하거나 색을 달리한다.
+- 적절한 예: "소정의 수수료를 지급받음", "소정의 원고료를 지급받았지만, 저의 솔직한
+  후기입니다"
+- 부적절한 예: 본문 중간에 본문과 구분 없이 삽입, 댓글로만 작성, '더보기'를 눌러야만
+  보이는 경우
+
+**사진**
+
+- 표시문구를 사진 내에 게재하거나, 본문과 연결되어 쉽게 인식되면 글 첫 부분에 게재한다.
+- 해시태그로 표시할 경우 원칙적으로 첫 번째 해시태그에 넣는다.
+- 적절한 예: 업로드 사진 속에 "협찬 받았음"을 배경과 구분되게 삽입
+
+**동영상**
+
+- 게시물 제목 또는 영상 시작·끝부분에 표시문구를 넣고, 해당 구간 동안 반복 표시한다.
+- 적절한 예: 제목에 "[광고] ○○ 솔직 리뷰", 시작·끝에 "소정의 광고료를 지급받았습니다"
+  및 5분마다 자막 반복
+- 부적절한 예: 제목이 길어 모바일에서 표시문구 부분이 잘려 보이지 않는 경우
+
+**실시간 방송**
+
+- 원칙은 동영상과 같다. 자막 삽입이 어려우면 음성으로 시작·끝부분에 반복 언급한다.
+- 적절한 예: 방송 중간부터 보는 시청자도 알 수 있도록 5분마다 "광고료를 지급받았음" 언급
+- 부적절한 예: 30분 방송에서 단 한 차례만 언급
+
+부동산·금융상품·환경 표시광고, 임시중지명령, 과징금 산정 등은 이 문서에 없다 — 그 범위의
+질문은 지원 대상이 아니다.

package/skills/datalab-ad-disclosure-check/references/naver-terms-excerpt.md

@@ -0,0 +1,28 @@
+# 네이버 약관 발췌 — 협찬·광고 관련 조항만
+
+출처: 네이버 통합 이용약관, 네이버 서비스 블로그 운영정책. 전문이 아니라 협찬·광고 표시와
+직접 관련된 조항만 발췌했다. **여기 없는 조항을 인용하지 않는다.**
+
+## 통합 이용약관 — 광고 포함
+
+> 네이버 서비스에는 광고가 포함될 수 있으며, 광고 열람으로 인한 데이터 통신요금 등은
+> 이용자가 부담합니다.
+
+## 블로그 운영정책 — 내돈내산 리뷰 콘텐츠 조건
+
+> 〈블로그 내돈내산 리뷰 콘텐츠〉 기능 이용 시: 네이버 서비스 내 이용 내역이 확인되는
+> 경우에만 사용 가능하며, 광고주로부터 경제적 이익을 제공받고 작성한 경우 이용할 수
+> 없습니다.
+>
+> 그 밖의 유의사항: 경제적 이익을 제공받고 작성한 리뷰는 관련 법규에 따라 그 사실을
+> 밝혀야 합니다.
+
+이 조건은 사실 확인으로 답할 수 있다: 사용자가 경제적 이익을 받았다고 답했다면 "내돈내산"
+태그는 이 조항에 따라 쓸 수 없다는 것을 그대로 알려준다 — 해석이 아니라 원문의 조건이다.
+
+## 블로그 운영정책 — 전자상거래 관련
+
+> 블로그를 통한 판매 활동은 전자상거래법 등 관련 법령을 준수해야 합니다.
+
+전자상거래법 조문 자체는 이 스킬의 범위 밖이다(표시광고법만 다룬다). 판매 활동이 섞인
+글이면 전자상거래법 검토가 별도로 필요하다는 사실만 안내하고 조문을 인용하지 않는다.

package/skills/datalab-blog-widget/SKILL.md

@@ -0,0 +1,65 @@
+---
+name: datalab-blog-widget
+description: 네이버 블로그 사이드바 위젯·프로필 소개·최근글 목록·카테고리 메뉴를 네이버가 허용하는 HTML로 만든다. "블로그 위젯 만들어줘", "사이드바에 프로필 넣고 싶다", "카테고리 메뉴 HTML" 요청에 사용한다. 붙여넣을 코드가 산출물이다.
+license: Proprietary
+metadata:
+  tools: my_daily_brief, my_realtime, my_top_content
+---
+
+# 네이버 블로그 위젯 HTML
+
+사용자가 자기 네이버 블로그 사이드바나 본문에 붙여넣는 HTML 조각을 만든다. 이 확장의
+편집기 컴포넌트와는 무관한 이름이다 — 헷갈리지 않는다.
+
+## 이 스킬이 만들지 않는 것
+
+- **동작하는 위젯.** 계산기·타이머·날씨·투표 — 네이버 블로그는 스크립트와 모든 이벤트
+  핸들러를 막는다. 숫자 버튼만 있고 계산은 안 되는 가짜 계산기를 만들지 않는다.
+- **발행이나 설치.** 이 확장은 사용자의 블로그 스킨에 아무것도 쓰지 않는다. 산출물은
+  사용자가 네이버 블로그 "위젯 만들기" 또는 글쓰기 HTML 모드에 직접 붙여넣는 텍스트다.
+- **점수 매긴 검증 리포트.** 통과·실패 체크리스트만 준다.
+- **hover 효과.** 네이버는 `<style>` 태그도 `onmouseover` 도 막아서 구현할 방법이 없다.
+  링크는 정적 스타일로만 표현한다.
+
+## 무엇을 만드나
+
+1. **위젯** — 170px 고정폭 사이드바용: 프로필 카드, 최근 게시물, 방문자 카운터, 카테고리
+   메뉴, 소셜 링크
+2. **프로필·소개 섹션** — 본문에 넣는 섹션
+3. **게시물 목록** — 본문·사이드바 겸용
+4. **카테고리 메뉴** — 링크 목록 패턴
+
+넷 다 같은 제약을 따른다 — `references/naver-constraints.md`.
+
+## 절차
+
+1. 유형(위젯·프로필·목록·카테고리)과 들어갈 내용을 확인한다. 모호하면 먼저 묻는다.
+2. `references/naver-constraints.md` 의 태그·바이트 규칙을 따른다.
+3. `references/templates.md` 에서 가장 가까운 템플릿을 골라 변형한다. 새 유형이면 `span`
+   전용 구조로 새로 짠다.
+4. **숫자가 들어갈 자리**(방문자 수, 조회수, 게시물 수):
+   - 사용자가 실제 값을 요청했으면 `my_daily_brief` · `my_realtime` · `my_top_content` 로
+     값을 가져와 채운다. 채운 숫자 옆에는 **반드시 기준 날짜를 작게 붙인다** — 이 위젯은
+     붙여넣는 순간 정지 화면이 되고 자동으로 갱신되지 않는다. 최신 상태를 유지하려면
+     다시 생성해서 교체해야 한다고 안내한다.
+   - 그 외에는 `0000` 처럼 한눈에 가짜임을 알 수 있는 자리표시자를 쓰고 "실제 숫자로
+     바꾸세요"라고 옆에 적는다. `1,234` 처럼 그럴듯한 값은 쓰지 않는다 — 사용자가 그대로
+     붙여넣으면 진짜 통계처럼 보인다.
+5. 바이트를 센다(위젯 2,000바이트). 초과하면 장식부터 줄인다.
+6. HTML 코드 블록으로 낸다 — 이게 유일한 전달 방식이다. 대화 본문에 같은 HTML을 다시
+   풀어쓰지 않는다.
+7. 마지막에 한 줄: "네이버 블로그 관리 > 꾸미기 설정 > 위젯 만들기(또는 글쓰기 HTML
+   모드)에 붙여넣고 미리보기로 확인 후 저장하세요."
+
+## 하드 룰
+
+근거는 `references/naver-constraints.md`.
+
+- 태그는 `span` · `br` · `hr` · `img` · `a` 다섯 개만.
+- 모든 링크에 `target="_top"`. 없거나 `_blank` 면 깨진다.
+- 인라인 `style` 외 스타일 금지 — `<style>`, `<link>`, class 없음.
+- 이벤트 핸들러, `javascript:`, 스크립트 전부 금지. 대체 수단 없음.
+- 이모지는 HTML 엔티티로 — 문자 그대로 쓰지 않는다.
+
+2,000바이트 제한은 사용자가 붙여넣기 실패나 잘림을 보고하면 이 문서보다 **실제 네이버
+에디터의 반응을 믿는다.**