✨ 무엇을 해 주나요
산재보험은 청구주의입니다. 재해자나 대리인이 급여 종류마다 다른 서식과 첨부를 직접 챙겨야 합니다.
이 도구는 그 「챙기는 일」을 돕습니다.
[!IMPORTANT]
승인 여부는 다루지 않습니다. 결과의 READY_TO_SUBMIT 은 「제출할 수 있는 상태」이지 승인이 아닙니다.
결과를 점치는 표현은 코드 필터가 출력 단계에서 막습니다.
[!NOTE]
입력값을 저장하지 않습니다. 로컬 설치는 PC 밖으로 아무것도 보내지 않습니다. 주민등록번호 같은 칸은 비워 두고 출력한 뒤 손으로 적어도 됩니다.
🚀 30초 설치 (내 PC, 토큰 없음)
Node.js 20 이상만 있으면 됩니다. 단계별 따라 하기와 문제 해결은 사용 매뉴얼에 있습니다.
Claude Code
Claude Desktop
claude_desktop_config.json 에 추가합니다.
🪟 Windows 에서 Claude Desktop 이 npx 를 못 찾을 때
cmd /c 로 감쌉니다.
🧩 Cursor · Windsurf · 그 밖의 MCP 호스트
같은 command / args 를 각 도구의 MCP 설정에 넣습니다. stdio 전송이면 전부 됩니다.
붙이고 나서 AI 에게 이렇게 말해 보세요.
「출퇴근 중 교통사고인데 상대 운전자가 있어요. 요양급여 신청하려면 뭐가 필요해요?」
「요양급여신청서에 이 값으로 채워서 PDF 로 줘.」
💻 명령줄로 쓰기
values.json 의 칸 이름은 catalog <FORM_ID> 결과의 slots 에 나옵니다. PDF 와 한글은 칸 이름이 같습니다. 서식이 갱신되면 npx -y sanjae-apply@latest 로 받습니다.
🔏 도장(날인)은 어떻게 되나
--stamp 이름 이면 성명인(원형 기본, --stamp-shape square|ellipse)을 만들어 찍고 --stamp-png 면 가진 도장 PNG(투명 배경, 4096px 이하)를 검사한 뒤 그대로 찍습니다. 인주색 적색, 지름 42pt(약 1.5cm). 동봉 글꼴(나눔고딕)에 없는 글자(한자 등)는 빈 도장이 되지 않도록 오류로 멈춥니다. 그런 이름은 --stamp-png 로 가진 도장을 넣어 주세요.
- 자리는 서식마다 지도에 정해져 있고
catalog <FORM_ID> 의 stamps 에 이름이 나옵니다. 비우면 신청인 본인 자리 전부(applicant 본문 · delegation 위임장 · consent 개인정보 동의)에 찍고 --stamp-spot a,b 로 고릅니다. 타인 서명란(confirm 확인자 · commute_reporter 신고인 · choice_confirmer 등)은 이름을 적어 줄 때만 찍습니다. 지도에 없는 자리는 건너뛰고 결과의 stamps_skipped 에 적습니다.
- PDF 와 한글(hwpx) 출력 둘 다 찍힙니다. 한글에서는 서명란 문단에 「글 앞으로」 떠 있는 그림으로 들어가 글자를 밀지 않습니다(쪽 밀림 0, 11종 실측). 한글에서 열어 옮기거나 지울 수 있습니다.
- 도장은 명의자의 인격 표지입니다. 본인 또는 명의자 동의가 있는 이름만 넣어 주세요. 등록 인감을 흉내 내는 용도가 아닙니다(사용인감 성격).
🖨️ 한글(hwpx) 출력은 어떻게 되나
- 공단이 배포한 HWP 원본을 한글에서 hwpx 로 한 번 변환해 동봉했습니다(
forms/hwpx/). 채울 때는 한글이 필요 없습니다. zip 안 XML 의 표 칸에 값을 넣는 순수 TypeScript 입니다. 윈도우·맥·리눅스 어디서나 돕니다.
- 결과는 .hwpx 입니다. 한글 2014 이상에서 열어 고치고 인쇄할 수 있습니다. 서식의 글꼴·표·쪽 구성은 공단 원본 그대로입니다.
- 빈 서식에 숨어 있던 자리표시자 글자색(회색·파랑)과 1pt 상자 글자는 검정 정체로 바꿔 넣습니다. 값이 칸보다 길면 글자를 줄입니다(PDF 와 같은 규칙).
- 재활보조기구 처방전은 공단이 PDF 만 배포해 한글 출력이 없습니다.
- 새 서식을 한글로 채우게 만드는 법은
docs/한글지도_작성법.md 에 있습니다.
🔧 MCP 도구 8개
산업재해조사표 쓰는 법과 관할 데이터는 docs/산업재해조사표_작성방법.md, data/labor-offices/README.md.
📄 채울 수 있는 서식 13종
- 정본은 근로복지공단 서식자료실 파일을 씁니다. 산업재해조사표만 법제처 국가법령정보센터의 별지 서식을 씁니다. 좌표 지도는 정본의
sha256 에 묶여 있어 서식이 바뀌면 시험이 먼저 깨집니다.
- 공단이 HWP 만 주는 서식은 한글에서 PDF 로 바꿔 동봉했습니다.
- 이 도구의 범위는 채운 출력물을 만드는 것까지입니다. 온라인 접수(토탈서비스)는 범위 밖입니다.
🌐 원격 MCP (운영자가 토큰을 주는 경우)
같은 도구 8개가 원격으로 돕니다. 입력은 서버에 저장되지 않지만 네트워크를 거칩니다.
🏠 직접 호스팅하기(Vercel)
이 레포를 Vercel 에 올리고 환경변수를 넣으면 /api/mcp/mcp 가 열립니다.
🧪 검증 수준
전부 합성 값으로만 돌렸습니다. 실제 사건으로는 검증하지 않았습니다.
설치부터 활용까지 따라 하는 사용 매뉴얼과 실측 기록은 docs/사용_매뉴얼.md 에 있습니다.
새 서식의 좌표 지도는 docs/좌표지도_작성법.md, 한글 지도는 docs/한글지도_작성법.md, 배포·연결 전체는 docs/패키징_배포_연결_가이드.md.
🗂️ 구조
⚖️ 경계
- 공인노무사법 제27조에 따라 청구의 대행·대리와 서류의 작성·확인은 공인노무사의 직무입니다. 이 도구는 그 일을 돕는 도구이지 대신하지 않습니다.
- 규칙은 산재 실무 메모(산재창고 블로그, 2025.1.14 기준)를 옮기고 법 조문으로 근거를 붙인 것입니다. 공단 내부 규정과는 대조하지 않았습니다. 출력물은 담당 노무사가 확인한 뒤 쓰십시오.
- 서식 개정은 공단이 예고 없이 합니다.
catalog 로 개정일을 한 번씩 확인하세요.
🤝 기여
- 새 서식 좌표 지도는
docs/좌표지도_작성법.md, 한글 지도는 docs/한글지도_작성법.md 를 따라 만들고 test/samples/ 에 합성 값을 함께 넣어 주세요.
- 규칙(S-xx)을 고칠 때는 실패하는 시험을 먼저 추가합니다.
- 실제 사건의 값·실명·주민등록번호는 이슈·PR 어디에도 올리지 마세요.
📜 라이선스
MIT. 동봉 글꼴 나눔고딕은 SIL OFL 1.1(fonts/OFL.txt). 공단 서식 PDF 는 근로복지공단 공개 자료이고, 산업재해조사표는 법제처 국가법령정보센터에 실린 법령 서식입니다. 관할 관서 연락처는 고용노동부 누리집 관서 안내 화면에서 확인한 공개 정보입니다(직원 성명 없음).