kordoc
installs/mo · npmstarsforks
How to install kordoc?
chrisryugj/kordoc
$git clone https://github.com/chrisryugj/kordoc모두 파싱해버리겠다.
README.md
| 1 | # kordoc |
| 2 | |
| 3 | **모두 파싱해버리겠다.** |
| 4 | |
| 5 | [](https://www.npmjs.com/package/kordoc) |
| 6 | [](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 | [](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 변경사항 |
People who liked this also viewed
6 picksType
- markitdown-mcp📄 Professional MCP server for converting 29+ file formats to Markdown - Perfect for Claude Desktop and AI workflows!MCP ServersJun 2026
- python-mcp-server-client支持查询主流agent框架技术文档的MCP server（支持stdio和sse两种传输协议）, 支持 langchain、llama-index、autogen、agno、openai-agents-sdk、mcp-doc、camel-ai 和 crew-aiMCP ServersMay 2025
- PDFMathTranslate[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译，支持 Google/DeepL/Ollama/OpenAI 等服务，提供 CLI/GUI/MCP/Docker/ZoteroMCP ServersMay 2026
- jdocmunch-mcpThe leading, most token-efficient MCP server for documentation exploration and retrieval via structured section indexingMCP ServersJul 2026
- Keenable Web SearchDocs: https://docs.keenable.ai/mcp-server Keenable is a free, remote MCP server that gives agents access to the web index. Search the web with ranked results and date/site filters, then fetch any indexed page as clean markdown. Works out oMCP Serversrecently
- apple-docs-mcpMCP server for Apple Developer Documentation - Search iOS/macOS/SwiftUI/UIKit docs, WWDC videos, Swift/Objective-C APIs & code examples in Claude, Cursor & AI assistantsMCP ServersMar 2026
