claw-hancomdocs

한컴독스(Hancom Docs) 웹 뷰어/에디터(webhwp)를 Playwright 로 드라이브 — .hwp / .hwpx 업로드 → 렌더 페이지 캡처 / 영역 확대 / 텍스트 검색 / (Phase 2) 직접 편집 까지.

Playwright headless — 보이는 창 없음, 물리 마우스/키보드 안 건드림, 백그라운드 가능
로그인 1회 — 비밀번호 저장 없이 세션(auth.json)만 재사용
A4 페이지만 깔끔히 — 툴바·여백 없이, 페이지 잘림 없이, 방향(세로/가로) 자동 인식
열 수 없는 파일 감지 — 손상/형식오류는 cannot_open 상태로 보고
Local-machine only — 사용자 Mac / Windows / Linux 머신에서 직접 실행 (Cowork sandbox proxy 차단)

상태

Phase 1 (capture) — 작동 검증됨. 아래 사용법 그대로
Phase 2 (edit) — 구현 중. 한컴독스 web UI 를 직접 클릭/타이핑하여 셀 채우기 / 텍스트 삽입 / 표 생성 등 자동화

데모 — 영역 확대(zoom)

전체 페이지에서 원하는 영역을 골라(왼쪽) 고해상도로 잘라냅니다(오른쪽).

`capture --grid` 로 좌표 잡기	`zoom --clip` 결과

30쪽짜리 문서의 29쪽에서 [B] 문단 모양 섹션(B1~B8)만 zoom --clip "35,300,715,510" --scale 3 으로 추출.

설치 (환경마다 1회)

# 1) 스킬을 Claude Code 스킬 폴더로
git clone <this-repo> ~/.claude/skills/hancomdocs-capture

# 2) 의존성
cd ~/.claude/skills/hancomdocs-capture/scripts
npm install
npx playwright install chromium     # Chromium 다운로드 (~수백 MB)

# 3) 로그인 (브라우저 창에서 한컴독스 로그인 → auth.json 자동 저장)
node login.js

스킬로 쓸 때는 위 과정을 SKILL.md가 자동 점검·안내합니다 — 사용자는 "이 hwp 한컴독스에 올려서 보여줘"라고만 하면 됩니다.

사용

cd scripts

# 첫 페이지(또는 N쪽) A4 한 장 깔끔히 캡처
node hancom.js capture --file /abs/report.hwp --page 1

# 좌표 격자를 얹어서 (확대할 영역 좌표 읽기용)
node hancom.js capture --file /abs/report.hwp --page 9 --grid

# 페이지 안의 특정 영역 확대 (페이지 왼쪽위=0,0 기준 CSS px)
node hancom.js zoom --name report.hwp --page 9 --clip "60,420,670,260" --scale 3

# 텍스트를 찾아 그 페이지 캡처
node hancom.js around --name report.hwp --text "지원대상"

결과는 마지막 줄 RESULT_JSON={...}. 자세한 명령 명세는 ORDER_SPEC.txt.

좌표 흐름 (캔버스 렌더라 텍스트 위치 자동탐색 불가)

capture --grid 로 격자 입힌 페이지를 받고 →
원하는 영역의 x, y, width, height를 눈으로 읽어 →
zoom --clip "x,y,w,h" 로 확대.

열 수 없는 파일

{ "status": "cannot_open", "docName": "broken.hwp",
  "reason": "webhwp가 파일을 열 수 없습니다(손상/형식 오류). hwp·hwpx 동일 에러." }

(한계: 절단/부분손상 일부는 에러 없이 깨진 바이트가 렌더되는 '조용한 가비지' 모드가 있어 미감지.)

보안

비밀번호는 저장하지 않습니다. 로그인 세션 토큰만 auth.json에 저장됩니다.
auth.json은 현재 로그인 세션 그 자체라 민감 → .gitignore로 커밋 차단됨. 유출 주의, 만료 시 node login.js 재실행.

문서

SKILL.md — Claude Code 스킬 정의 (트리거 · 온보딩 · 명령)
ORDER_SPEC.txt — 에이전트 주문(명령) 명세
DEBUG_NOTES.md — 개발 노트 (접근법, webhwp 내부 발견, 안전 교훈, 실패 모드)

라이선스

MIT

FilesExpand file tree

README.md

Latest commit

History