@clazic/kordoc 2.1.0 → 2.1.2

package/README.md

@@ -2,14 +2,11 @@
 
 **모두 파싱해버리겠다.**
 
-[![npm version](https://img.shields.io/npm/v/kordoc.svg)](https://www.npmjs.com/package/kordoc)
-[![license](https://img.shields.io/npm/l/kordoc.svg)](https://github.com/chrisryugj/kordoc/blob/main/LICENSE)
+[![npm version](https://img.shields.io/npm/v/@clazic/kordoc.svg)](https://www.npmjs.com/package/@clazic/kordoc)
+[![license](https://img.shields.io/npm/l/@clazic/kordoc.svg)](https://github.com/clazic/kordoc/blob/main/LICENSE)
 
 HWP, HWPX, PDF, XLSX, DOCX — 관공서에서 쏟아지는 모든 문서를 파싱하고, 비교하고, 분석하고, 생성합니다.
 
-[English](./README-EN.md)
-
-![kordoc 데모](./demo.gif)
 
 ---
 
@@ -108,7 +105,7 @@ HWP, HWPX, PDF, XLSX, DOCX — 관공서에서 쏟아지는 모든 문서를 파
 ## 설치
 
 ```bash
-npm install kordoc
+npm install @clazic/kordoc
 
 # PDF 파싱이 필요하면 (선택)
 npm install pdfjs-dist
@@ -119,7 +116,7 @@ npm install pdfjs-dist
 ### 문서 파싱
 
 ```typescript
-import { parse } from "kordoc"
+import { parse } from "@clazic/kordoc"
 import { readFileSync } from "fs"
 
 const buffer = readFileSync("사업계획서.hwpx")
@@ -135,7 +132,7 @@ if (result.success) {
 ### 문서 비교 (신구대조표)
 
 ```typescript
-import { compare } from "kordoc"
+import { compare } from "@clazic/kordoc"
 
 const diff = await compare(구버전Buffer, 신버전Buffer)
 // diff.stats → { added: 3, removed: 1, modified: 5, unchanged: 42 }
@@ -147,7 +144,7 @@ HWP vs HWPX 크로스 포맷 비교도 가능합니다.
 ### 양식 필드 추출
 
 ```typescript
-import { parse, extractFormFields } from "kordoc"
+import { parse, extractFormFields } from "@clazic/kordoc"
 
 const result = await parse(buffer)
 if (result.success) {
@@ -160,7 +157,7 @@ if (result.success) {
 ### HWPX 생성 (역변환)
 
 ```typescript
-import { markdownToHwpx } from "kordoc"
+import { markdownToHwpx } from "@clazic/kordoc"
 
 const hwpxBuffer = await markdownToHwpx("# 제목\n\n본문 텍스트\n\n| 이름 | 직급 |\n| --- | --- |\n| 홍길동 | 과장 |")
 writeFileSync("출력.hwpx", Buffer.from(hwpxBuffer))
@@ -186,23 +183,45 @@ const result = await parse(buffer, {
 ## CLI
 
 ```bash
-npx kordoc 사업계획서.hwpx                          # 터미널 출력
-npx kordoc 보고서.hwp -o 보고서.md                  # 파일 저장
-npx kordoc *.pdf -d ./변환결과/                     # 일괄 변환
-npx kordoc 검토서.hwpx --format json               # JSON (blocks + metadata 포함)
-npx kordoc 보고서.hwpx --pages 1-3                  # 페이지 범위
-npx kordoc watch ./수신함 -d ./변환결과              # 폴더 감시 모드
-npx kordoc watch ./문서 --webhook https://api/hook  # 웹훅 알림
+# 전역 설치 (권장)
+npm install -g @clazic/kordoc
+
+kordoc 사업계획서.hwpx                          # 터미널 출력
+kordoc 보고서.hwp -o 보고서.md                  # 파일 저장
+kordoc *.pdf -d ./변환결과/                     # 일괄 변환
+kordoc 검토서.hwpx --format json               # JSON (blocks + metadata 포함)
+kordoc 보고서.hwpx --pages 1-3                  # 페이지 범위
+kordoc watch ./수신함 -d ./변환결과              # 폴더 감시 모드
+kordoc watch ./문서 --webhook https://api/hook  # 웹훅 알림
 ```
 
 ## MCP 서버 (Claude / Cursor / Windsurf)
 
+### 원격 MCP (설치 불필요 — 파일을 base64로 전송)
+
 ```json
 {
   "mcpServers": {
     "kordoc": {
-      "command": "npx",
-      "args": ["-y", "kordoc-mcp"]
+      "serverUrl": "https://kordoc-mcp.clazic.workers.dev"
+    }
+  }
+}
+```
+
+> HWPX, XLSX, DOCX, PDF 지원. HWP 5.x는 로컬 MCP 사용.
+
+### 로컬 MCP (HWP 5.x 포함 전 포맷, 파일 경로 직접 접근)
+
+```bash
+npm install -g @clazic/kordoc
+```
+
+```json
+{
+  "mcpServers": {
+    "kordoc": {
+      "command": "kordoc-mcp"
     }
   }
 }
@@ -253,7 +272,7 @@ import type {
   DiffResult, BlockDiff, CellDiff, DiffChangeType,
   FormField, FormResult,
   OcrProvider, WatchOptions,
-} from "kordoc"
+} from "@clazic/kordoc"
 ```
 
 ## 지원 포맷
@@ -272,8 +291,8 @@ import type {
 
 ## 만든 사람
 
-대한민국 지방공무원. 광진구청에서 7년간 HWP 파일과 싸우다가 이걸 만들었습니다.
-5개 공공 프로젝트에서 수천 건의 실제 관공서 문서를 파싱하며 검증했습니다.
+chrisryugj님의 kordoc을 fork해서 수정하고 사용하고 있습니다.
+
 
 ## 라이선스
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clazic/kordoc",
-  "version": "2.1.0",
+  "version": "2.1.2",
   "description": "Parse Korean documents (HWP, HWPX, PDF, XLSX, DOCX) to Markdown",
   "type": "module",
   "exports": {
@@ -14,8 +14,8 @@
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "bin": {
-    "kordoc": "./dist/cli.js",
-    "kordoc-mcp": "./dist/mcp.js"
+    "kordoc": "dist/cli.js",
+    "kordoc-mcp": "dist/mcp.js"
   },
   "files": [
     "dist"
@@ -48,7 +48,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/clazic/kordoc.git"
+    "url": "git+https://github.com/clazic/kordoc.git"
   },
   "engines": {
     "node": ">=18"
@@ -59,16 +59,9 @@
     "cfb": "1.2.2",
     "commander": "^13.0.0",
     "jszip": "^3.10.1",
+    "pdfjs-dist": "^4.10.38",
     "zod": "^3.23.0"
   },
-  "peerDependencies": {
-    "pdfjs-dist": ">=4.0.0"
-  },
-  "peerDependenciesMeta": {
-    "pdfjs-dist": {
-      "optional": true
-    }
-  },
   "devDependencies": {
     "@types/node": "^18.19.130",
     "pdfjs-dist": "^4.10.38",