kordoc

Name: kordoc
Author: chrisryugj

bychrisryugj· 6 MCP servers

Installs

47k

Stars

1.6k

Forks

291

How to install kordoc?

chrisryugj/kordoc

$git clone https://github.com/chrisryugj/kordoc

Installs into the current project.

›Prefer a prompt? Paste this to your agent

Install & use

Install kordoc by running `git clone https://github.com/chrisryugj/kordoc`, then use it for the current task and follow its documentation at https://github.com/chrisryugj/kordoc.

Files · 1

View on GitHub

README.md

1	# kordoc
2
3	모두 파싱해버리겠다.
4
5	[![npm version](https://img.shields.io/npm/v/kordoc.svg)](https://www.npmjs.com/package/kordoc)
6	[![license](https://img.shields.io/npm/l/kordoc.svg)](https://github.com/chrisryugj/kordoc/blob/main/LICENSE)
7
8	> 대한민국에서 둘째가라면 서러울 문서지옥. 거기서 7년 버틴 공무원이 만들었습니다.
9
10	HWP 3.x/5.x, HWPX, HWPML, PDF, XLS, XLSX, DOCX, 이미지(PNG/JPG/WebP) — 관공서에서 쏟아지는 모든 문서를 파싱하고, 비교하고, 분석하고, 생성합니다.
11
12	[English](./README-EN.md)
13
14	[![Kordoc 활용하기 — 영상 보기](./docs/video-demo.jpg)](https://youtu.be/Q13GmgDcIw0)
15
16	<sub>▶ 클릭하면 유튜브에서 재생됩니다.</sub>
17
18	---
19
20	## ⚡ 30초 설치 (AI 에이전트 연동)
21
22	macOS / Linux / Windows 공용. Node.js 18+ 만 있으면 됩니다.
23
24	```bash
25	npx -y kordoc setup
26	```
27
28	대화형 마법사가:
29	1. 사용 중인 AI 클라이언트 번호 선택 (Claude Desktop / Cursor / Claude Code / Windsurf / VS Code / Gemini CLI / Zed / Antigravity / Codex — 설치된 건 `[감지됨]` 표시)
30	2. 설정 파일 자동 패치 → 클라이언트 재시작
31
32	Windows 도 자동으로 `cmd /c npx` 래핑. 수동 JSON 편집 불필요. 재시작하면 15개 문서 도구 (`parse_document`, `parse_table`, `fill_form`, `patch_document`, `generate_document` 등) 활성화.
33
34	> CLI 로만 쓸 거면 설치 없이 `npx kordoc <파일>` 바로 사용. 아래 [CLI](#cli) 섹션 참고.
35
36	> `MODULE_NOT_FOUND` / `Cannot find module ...\dist\cli.js` 가 뜨면: 과거에 깨진 글로벌 설치가 남아있는 상태입니다. 아래로 해결:
37	> ```powershell
38	> npm uninstall -g kordoc
39	> npx -y kordoc@latest setup
40	> ```
41
42	> Windows PowerShell 에서 `npx.ps1 파일을 로드할 수 없습니다 · PSSecurityException` 이 뜨면: PowerShell 기본 보안 정책이 서명 없는 `.ps1` 을 차단하는 표준 동작입니다 (kordoc 무관). 아래 중 하나 쓰시면 됩니다.
43	>
44	> 방법 1 — 명령 프롬프트(cmd) 창에서 실행 (가장 안전)
45	> 윈도우 키 → `cmd` 검색 → Enter → 검은 창에서 그대로:
46	> ```
47	> npx -y kordoc setup
48	> ```
49	>
50	> 방법 2 — PowerShell 실행 정책 한 번만 완화
51	> 관리자 권한 PowerShell:
52	> ```powershell
53	> Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
54	> ```
55	> 이후 PowerShell 재시작 → `npx -y kordoc setup` 그대로 됨.
56
57	### Claude Code 플러그인으로 설치
58
59	MCP 등록 대신 스킬(SKILL.md) 형태로 쓰려면:
60
61	```
62	/plugin marketplace add chrisryugj/kordoc
63	/plugin install kordoc@kordoc
64	```
65
66	`.hwp`/`.hwpx` 언급이나 공문서 생성·서식 채우기 요청 시 kordoc 스킬이 자동 활성화됩니다
67	(내부에서 `npx -y kordoc@^4` CLI 호출 — 별도 설치 불필요).
68
69	---
70
71	## 💡 kordoc으로 무엇을 할 수 있나요?
72
73	단순한 텍스트 추출을 넘어, 공문서 처리를 위한 모든 과정을 자동화합니다.
74
75	* 📄 어떤 문서든 마크다운으로: `HWP3` (구버전), `HWP`(5.x), `HWPX`, `HWPML`, `PDF`, `XLS`, `XLSX`, `DOCX` 파일은 물론 `PNG`/`JPG`/`WebP` 이미지(자동 OCR)까지 즉시 `Markdown`으로 변환합니다. AI(LLM)가 문서를 읽고 분석하기 가장 좋은 상태로 만들어줍니다.
76	* 📊 복잡한 표(Table) 완벽 재현: 선이 없는 PDF나 복잡하게 병합된 HWP 표도 구조를 분석하여 정확한 마크다운 테이블로 복원합니다. 법령 개정안 PDF의 신구조문대비표도 통째로 살립니다 (v3.16.2).
77	* 🔍 신구대조표 자동 생성: 두 문서의 차이점을 분석하여 무엇이 바뀌었는지 한눈에 보여줍니다. (HWP와 HWPX 간의 비교도 가능!)
78	* 📝 마크다운을 다시 HWPX로: AI가 작성한 내용을 다시 보고서 양식(`HWPX`)으로 되돌려줍니다. 이제 복사-붙여넣기 노가다에서 해방되세요.
79	* 🏛️ 정부 표준 공문서 생성 (v4.0): 실제 정부 양식 16종 + 실결재 기안문 60건을 전수 디코드·대조해 만든 공문서 엔진. 개조식 보고서(표지·목차 배너·로마숫자 장헤더·쪽번호·결재란), 기안문(별지 제1호서식 두문·결문, "끝." 자동), 공고문·보도자료 프리셋, 항목부호 8단계(1. 가. 1) 가)…) 자동, 공문서 표기법 검수 13룰(`kordoc lint`)까지 — 한글 COM 실렌더로 조판까지 실측 검증했습니다.
80	* 🔄 서식 보존 무손실 라운드트립 (v3.0): 변환된 마크다운을 편집해서 `patchHwpx`(HWPX) / `patchHwp`(HWP 5.x 바이너리)에 넘기면, 원본 서식을 1바이트도 건드리지 않고 바뀐 문단/표 셀의 텍스트만 원본 안에서 교체합니다. v3.7부터는 표에 행을 추가/삭제하는 편집도 원본 서식을 승계하며 반영되고, v3.8부터는 HWP 5.x의 빈 셀에 값 넣기도 지원합니다.
81	* 🖼️ 레이아웃 보존 렌더 (v3.10~3.15): 한컴이 저장한 조판 캐시 좌표로 원본 레이아웃을 SVG로 재현하고, 캐시가 없는 파일(AI가 만든 HWPX·편집본)은 순수 TS reflow 엔진이 직접 조판합니다. 다페이지·표·그리기 도형·검색어 형광펜까지. 서버에 한컴 없이 HWPX 미리보기를 만들 수 있습니다.
82	* 📊 차트 생성 (v3.16): 마크다운의 ```chart 펜스(type/cat/계열 라인)가 한컴 네이티브 차트(OOXML chartSpace)로 생성됩니다 — 막대·선·원·도넛·영역·분산·방사형 등 20종, 계열/조각 색 지정 가능.
83	* 🔴 도장/서명 자동 날인 (v3.16): "(인)"·"서명 또는 인" 같은 앵커 문구를 찾아 도장 PNG를 글 앞 부유로 배치합니다. 표/페이지를 키우지 않아 날인 후 서식이 밀리지 않습니다 (`kordoc seal`).
84	* ✏️ 양식 자동 채우기: 공문서 양식 템플릿(신청서, 보고서)에 값을 넣으면 자동으로 빈칸을 채웁니다. 원본 서식(글꼴, 크기, 정렬)을 100% 보존합니다.
85	* 🤖 AI 에이전트 연동 (MCP): `Claude Desktop`, `Cursor`, `Codex`와 같은 도구에서 직접 `kordoc`을 호출해 문서를 읽고 코딩할 수 있습니다.
86
87	---
88
89	## v4.2.6 변경사항
90
91	- 📐 개조식·보고서 본문 왼쪽정렬: 개조식·보고서 공문서의 본문 항목(□/○/-)을 양쪽정렬에서 왼쪽정렬로 바꿨습니다. 어절 유지 + 양쪽정렬이 겹치면 다음 어절이 길어 짧게 끊긴 줄(예: 25자 줄을 34자 폭으로)의 어절 간격이 과하게 벌어져 문단이 깨진 것처럼 보이던 문제입니다. 「행정업무운영편람」 개조식 예시의 왼쪽정렬 관례와도 일치합니다. 기안문(official) 등 서술형 본문의 양쪽정렬은 그대로 유지합니다.
92
93	## v4.2.3 변경사항

6 picks

Type

kordoc

bychrisryugj· 6 MCP servers

Installs

47k

Stars

1.6k

Forks

291

How to install kordoc?

chrisryugj/kordoc

$git clone https://github.com/chrisryugj/kordoc

Installs into the current project.

›Prefer a prompt? Paste this to your agent

Install & use

Install kordoc by running `git clone https://github.com/chrisryugj/kordoc`, then use it for the current task and follow its documentation at https://github.com/chrisryugj/kordoc.

Files · 1

View on GitHub

README.md

1	# kordoc
2
3	모두 파싱해버리겠다.
4
5	[![npm version](https://img.shields.io/npm/v/kordoc.svg)](https://www.npmjs.com/package/kordoc)
6	[![license](https://img.shields.io/npm/l/kordoc.svg)](https://github.com/chrisryugj/kordoc/blob/main/LICENSE)
7
8	> 대한민국에서 둘째가라면 서러울 문서지옥. 거기서 7년 버틴 공무원이 만들었습니다.
9
10	HWP 3.x/5.x, HWPX, HWPML, PDF, XLS, XLSX, DOCX, 이미지(PNG/JPG/WebP) — 관공서에서 쏟아지는 모든 문서를 파싱하고, 비교하고, 분석하고, 생성합니다.
11
12	[English](./README-EN.md)
13
14	[![Kordoc 활용하기 — 영상 보기](./docs/video-demo.jpg)](https://youtu.be/Q13GmgDcIw0)
15
16	<sub>▶ 클릭하면 유튜브에서 재생됩니다.</sub>
17
18	---
19
20	## ⚡ 30초 설치 (AI 에이전트 연동)
21
22	macOS / Linux / Windows 공용. Node.js 18+ 만 있으면 됩니다.
23
24	```bash
25	npx -y kordoc setup
26	```
27
28	대화형 마법사가:
29	1. 사용 중인 AI 클라이언트 번호 선택 (Claude Desktop / Cursor / Claude Code / Windsurf / VS Code / Gemini CLI / Zed / Antigravity / Codex — 설치된 건 `[감지됨]` 표시)
30	2. 설정 파일 자동 패치 → 클라이언트 재시작
31
32	Windows 도 자동으로 `cmd /c npx` 래핑. 수동 JSON 편집 불필요. 재시작하면 15개 문서 도구 (`parse_document`, `parse_table`, `fill_form`, `patch_document`, `generate_document` 등) 활성화.
33
34	> CLI 로만 쓸 거면 설치 없이 `npx kordoc <파일>` 바로 사용. 아래 [CLI](#cli) 섹션 참고.
35
36	> `MODULE_NOT_FOUND` / `Cannot find module ...\dist\cli.js` 가 뜨면: 과거에 깨진 글로벌 설치가 남아있는 상태입니다. 아래로 해결:
37	> ```powershell
38	> npm uninstall -g kordoc
39	> npx -y kordoc@latest setup
40	> ```
41
42	> Windows PowerShell 에서 `npx.ps1 파일을 로드할 수 없습니다 · PSSecurityException` 이 뜨면: PowerShell 기본 보안 정책이 서명 없는 `.ps1` 을 차단하는 표준 동작입니다 (kordoc 무관). 아래 중 하나 쓰시면 됩니다.
43	>
44	> 방법 1 — 명령 프롬프트(cmd) 창에서 실행 (가장 안전)
45	> 윈도우 키 → `cmd` 검색 → Enter → 검은 창에서 그대로:
46	> ```
47	> npx -y kordoc setup
48	> ```
49	>
50	> 방법 2 — PowerShell 실행 정책 한 번만 완화
51	> 관리자 권한 PowerShell:
52	> ```powershell
53	> Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
54	> ```
55	> 이후 PowerShell 재시작 → `npx -y kordoc setup` 그대로 됨.
56
57	### Claude Code 플러그인으로 설치
58
59	MCP 등록 대신 스킬(SKILL.md) 형태로 쓰려면:
60
61	```
62	/plugin marketplace add chrisryugj/kordoc
63	/plugin install kordoc@kordoc
64	```
65
66	`.hwp`/`.hwpx` 언급이나 공문서 생성·서식 채우기 요청 시 kordoc 스킬이 자동 활성화됩니다
67	(내부에서 `npx -y kordoc@^4` CLI 호출 — 별도 설치 불필요).
68
69	---
70
71	## 💡 kordoc으로 무엇을 할 수 있나요?
72
73	단순한 텍스트 추출을 넘어, 공문서 처리를 위한 모든 과정을 자동화합니다.
74
75	* 📄 어떤 문서든 마크다운으로: `HWP3` (구버전), `HWP`(5.x), `HWPX`, `HWPML`, `PDF`, `XLS`, `XLSX`, `DOCX` 파일은 물론 `PNG`/`JPG`/`WebP` 이미지(자동 OCR)까지 즉시 `Markdown`으로 변환합니다. AI(LLM)가 문서를 읽고 분석하기 가장 좋은 상태로 만들어줍니다.
76	* 📊 복잡한 표(Table) 완벽 재현: 선이 없는 PDF나 복잡하게 병합된 HWP 표도 구조를 분석하여 정확한 마크다운 테이블로 복원합니다. 법령 개정안 PDF의 신구조문대비표도 통째로 살립니다 (v3.16.2).
77	* 🔍 신구대조표 자동 생성: 두 문서의 차이점을 분석하여 무엇이 바뀌었는지 한눈에 보여줍니다. (HWP와 HWPX 간의 비교도 가능!)
78	* 📝 마크다운을 다시 HWPX로: AI가 작성한 내용을 다시 보고서 양식(`HWPX`)으로 되돌려줍니다. 이제 복사-붙여넣기 노가다에서 해방되세요.
79	* 🏛️ 정부 표준 공문서 생성 (v4.0): 실제 정부 양식 16종 + 실결재 기안문 60건을 전수 디코드·대조해 만든 공문서 엔진. 개조식 보고서(표지·목차 배너·로마숫자 장헤더·쪽번호·결재란), 기안문(별지 제1호서식 두문·결문, "끝." 자동), 공고문·보도자료 프리셋, 항목부호 8단계(1. 가. 1) 가)…) 자동, 공문서 표기법 검수 13룰(`kordoc lint`)까지 — 한글 COM 실렌더로 조판까지 실측 검증했습니다.
80	* 🔄 서식 보존 무손실 라운드트립 (v3.0): 변환된 마크다운을 편집해서 `patchHwpx`(HWPX) / `patchHwp`(HWP 5.x 바이너리)에 넘기면, 원본 서식을 1바이트도 건드리지 않고 바뀐 문단/표 셀의 텍스트만 원본 안에서 교체합니다. v3.7부터는 표에 행을 추가/삭제하는 편집도 원본 서식을 승계하며 반영되고, v3.8부터는 HWP 5.x의 빈 셀에 값 넣기도 지원합니다.
81	* 🖼️ 레이아웃 보존 렌더 (v3.10~3.15): 한컴이 저장한 조판 캐시 좌표로 원본 레이아웃을 SVG로 재현하고, 캐시가 없는 파일(AI가 만든 HWPX·편집본)은 순수 TS reflow 엔진이 직접 조판합니다. 다페이지·표·그리기 도형·검색어 형광펜까지. 서버에 한컴 없이 HWPX 미리보기를 만들 수 있습니다.
82	* 📊 차트 생성 (v3.16): 마크다운의 ```chart 펜스(type/cat/계열 라인)가 한컴 네이티브 차트(OOXML chartSpace)로 생성됩니다 — 막대·선·원·도넛·영역·분산·방사형 등 20종, 계열/조각 색 지정 가능.
83	* 🔴 도장/서명 자동 날인 (v3.16): "(인)"·"서명 또는 인" 같은 앵커 문구를 찾아 도장 PNG를 글 앞 부유로 배치합니다. 표/페이지를 키우지 않아 날인 후 서식이 밀리지 않습니다 (`kordoc seal`).
84	* ✏️ 양식 자동 채우기: 공문서 양식 템플릿(신청서, 보고서)에 값을 넣으면 자동으로 빈칸을 채웁니다. 원본 서식(글꼴, 크기, 정렬)을 100% 보존합니다.
85	* 🤖 AI 에이전트 연동 (MCP): `Claude Desktop`, `Cursor`, `Codex`와 같은 도구에서 직접 `kordoc`을 호출해 문서를 읽고 코딩할 수 있습니다.
86
87	---
88
89	## v4.2.6 변경사항
90
91	- 📐 개조식·보고서 본문 왼쪽정렬: 개조식·보고서 공문서의 본문 항목(□/○/-)을 양쪽정렬에서 왼쪽정렬로 바꿨습니다. 어절 유지 + 양쪽정렬이 겹치면 다음 어절이 길어 짧게 끊긴 줄(예: 25자 줄을 34자 폭으로)의 어절 간격이 과하게 벌어져 문단이 깨진 것처럼 보이던 문제입니다. 「행정업무운영편람」 개조식 예시의 왼쪽정렬 관례와도 일치합니다. 기안문(official) 등 서술형 본문의 양쪽정렬은 그대로 유지합니다.
92
93	## v4.2.3 변경사항

6 picks

Type

kordoc

How to install kordoc?

Related

kordoc

How to install kordoc?

Related