메뉴
공공기관 출장·여비·교통비 정산에 필요한 하이패스, 코레일, SRT 영수증을 공식 사이트 또는 승인된 제공자 경로에서 수집하고 PDF와 PNG 증빙 파일로 정리할 때 사용한다.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | transport-receipt-collector |
| description | 공공기관 출장·여비·교통비 정산에 필요한 하이패스, 코레일, SRT 영수증을 공식 사이트 또는 승인된 제공자 경로에서 수집하고 PDF와 PNG 증빙 파일로 정리할 때 사용한다. |
| license | See docs/attribution.md |
| metadata | {"category":"utility","locale":"ko-KR","phase":"v0.3"} |
출장·여비 정산에 필요한 교통비 증빙을 월별로 모으고, 제출 가능한 파일명과 형식으로 정리한다. 현재 지원 대상은 하이패스, SRT, KTX/Korail 3종이다.
핵심 원칙은 간단하다.
이 스킬은 기관별 처리를 provider 단위로 나눈다.
| provider | 상태 | 기본 인증 방식 | 역할 |
|---|---|---|---|
hipass-idpw-login | v0.3 지원 | 로컬 실행 환경에서 읽은 계정 정보 | 추가 본인확인 없이 로그인 가능한 경우 자동 로그인 후 조회·저장 |
hipass-browser-session | 대체 방식 | 사용자가 직접 로그인한 Chrome 세션 재사용 | ID/PW 자동 로그인이 막힐 때 같은 Chrome 세션으로 조회·저장 |
korail-local-connector | v0.3 지원 | ktx-booking 스킬 helper + KTX 계정 환경변수 | 공개 저장소에는 내부 호출 세부사항을 두지 않고, ktx-booking helper를 사용하는 로컬/private connector로 영수증 PNG/JSON 저장 |
korail-browser-session | v0.2 대체 지원 | 사용자 직접 로그인 세션 | 코레일/KTX 웹 구입이력 영수증 화면을 PNG로 크롭 저장 |
srt-browser-session | v0.3 지원 | 사용자 직접 로그인 세션 또는 로컬 계정 정보 | SRT 승차권 구입이력 영수증 화면을 PNG로 저장 |
새 provider를 붙일 때는 아래 항목을 먼저 정한다.
provider id기본 산출물은 provider별 특성에 맞춰 같은 base name으로 저장한다.
outputs/receipts/YYYY-MM/
YYYY-MM-DD_provider_route_or_train_amount.pdf
YYYY-MM-DD_provider_route_or_train_amount.png
YYYY-MM-DD_provider_route_or_train_amount.json
예시:
outputs/receipts/2026-05/
2026-05-03_hipass_서울TG-동대구TG_12800.pdf
2026-05-03_hipass_서울TG-동대구TG_12800.png
PNG 생성 우선순위:
ktx-booking 스킬을 먼저 설치하고, 그 helper를 사용하는 로컬/private connector에서 반환받은 공식 영수증 데이터로 확정된 v3 코레일톡 스타일 PNG를 렌더링한다.중심 스크립트는 아래 파일이다. 기존 hipass-receipt 패키지에 의존하지 않고, 하이패스 조회·파싱·저장 로직을 이 스킬 안에서 직접 처리한다. 단, Chrome 제어를 위해 실행 환경에 playwright-core 또는 playwright는 필요하다.
node skills\transport-receipt-collector\scripts\collect_transport_receipts.cjs --help
공식 사이트 로그인용 Chrome 실행문 출력:
node skills\transport-receipt-collector\scripts\collect_transport_receipts.cjs chrome-command --provider hipass --debugging-port 9222
node skills\transport-receipt-collector\scripts\collect_transport_receipts.cjs chrome-command --provider korail --debugging-port 9222
node skills\transport-receipt-collector\scripts\collect_transport_receipts.cjs chrome-command --provider srt --debugging-port 9222
하이패스 사용내역 조회 기본값은 로컬 계정 환경변수 기반 자동 로그인이다. 스크립트는 기본적으로 KGOV_ENV_FILE 또는 사용자 홈 아래의 환경파일($HOME/.openclaw/.env)을 로드하며, 아래 키를 사용한다.
KGOV_HIPASS_ID=...
KGOV_HIPASS_PW=...
node skills\transport-receipt-collector\scripts\collect_transport_receipts.cjs list --provider hipass --start-date 2026-05-01 --end-date 2026-05-31 --cdp-url http://127.0.0.1:9222
이미 브라우저에서 직접 로그인한 세션을 쓰려면 --auth-mode session을 붙인다.
node skills\transport-receipt-collector\scripts\collect_transport_receipts.cjs list --provider hipass --start-date 2026-05-01 --end-date 2026-05-31 --cdp-url http://127.0.0.1:9222 --auth-mode session
하이패스 영수증 PDF와 PNG 저장:
node skills\transport-receipt-collector\scripts\collect_transport_receipts.cjs collect --provider hipass --start-date 2026-05-01 --end-date 2026-05-31 --row-index 1 --cdp-url http://127.0.0.1:9222 --output-dir outputs\receipts\2026-05
KTX/SRT 자동 로그인 후 구입이력/영수증 화면 진입:
node skills\transport-receipt-collector\scripts\collect_transport_receipts.cjs open-history --provider korail --cdp-url http://127.0.0.1:9222
node skills\transport-receipt-collector\scripts\collect_transport_receipts.cjs open-history --provider srt --cdp-url http://127.0.0.1:9222
KTX/SRT 현재 영수증 화면 크롭 저장:
node skills\transport-receipt-collector\scripts\collect_transport_receipts.cjs capture-current --provider korail --cdp-url http://127.0.0.1:9222 --output-dir outputs\receipts\2026-05
node skills\transport-receipt-collector\scripts\collect_transport_receipts.cjs capture-current --provider srt --cdp-url http://127.0.0.1:9222 --output-dir outputs\receipts\2026-05
SRT 자동 로그인 → 이용내역 조회 → 선택 행 영수증 PNG 저장:
node skills\transport-receipt-collector\scripts\collect_transport_receipts.cjs collect-latest --provider srt --start-date 2026-02-09 --end-date 2026-05-09 --row-index 1 --output-dir outputs\receipts\2026-05
KTX/Korail ktx-booking helper 기반 영수증 저장:
KTX/Korail은 먼저 기본 connector와 help를 확인한다. 공개 저장소에는 실사용 korail_receipt_connector.py를 포함한다. KGOV_KORAIL_CONNECTOR는 개인 수정 connector를 쓸 때만 지정한다.
cd C:\path\to\k-gov-skills
Test-Path .\skills\transport-receipt-collector\scripts\korail_receipt_connector.py
python .\skills\transport-receipt-collector\scripts\korail_receipt_connector.py --help
경로가 확인되면 목록 조회부터 실행한다.
node skills\transport-receipt-collector\scripts\collect_transport_receipts.cjs collect-latest --provider korail --start-date 2026-02-09 --end-date 2026-05-09 --list-only
목록이 보이면 저장을 실행한다.
node skills\transport-receipt-collector\scripts\collect_transport_receipts.cjs collect-latest --provider korail --start-date 2026-02-09 --end-date 2026-05-09 --row-index 1 --output-dir outputs\receipts\2026-05
위 명령은 기본적으로 최종 확정된 코레일톡 스타일 영수증 PNG와 redacted JSON을 저장한다.
ktx-booking 스킬을 설치한 뒤, 기본 korail_receipt_connector.py가 그 helper를 불러 쓰는 방식으로 실행한다.KGOV_KORAIL_CONNECTOR 또는 --connector로 지정한다. 이 connector는 --start-date, --end-date, --row-index, --output-dir, --list-only, --render-local 인자를 처리하고 JSON 요약을 stdout으로 출력해야 한다.Korail connector not found는 기본 connector 누락 또는 개인 connector 파일 경로 오류다.--output-dir 상대경로가 헷갈리면 절대경로를 사용한다.v3 템플릿을 최종 기준으로 확정했다. 기준은 코레일톡 실제 저장본에서 QR 상단 영역을 제외한 짧은 영수증 본문 이미지다.collect-latest --provider korail 실행은 ktx-booking helper 기반 connector가 KGOV_KORAIL_CONNECTOR로 설정된 경우 이 최종 템플릿 PNG를 생성한다. 데이터 점검만 할 때는 --list-only 또는 --no-render-local을 사용한다.자동 로그인부터 현재 화면 캡처까지 한 번에 시도:
node skills\transport-receipt-collector\scripts\collect_transport_receipts.cjs collect-current --provider srt --cdp-url http://127.0.0.1:9222 --output-dir outputs\receipts\2026-05
화면 자동 감지가 맞지 않으면 수동 크롭 좌표를 준다.
node skills\transport-receipt-collector\scripts\collect_transport_receipts.cjs capture-current --provider korail --crop 120,180,760,620 --output-dir outputs\receipts\2026-05 --base-name 2026-05-09_korail_receipt
v2 headless 모드:
node skills\transport-receipt-collector\scripts\collect_transport_receipts.cjs collect --provider hipass --start-date 2026-05-01 --end-date 2026-05-31 --row-index 1 --headless --output-dir outputs\receipts\2026-05
--headless는 ID/PW 자동 로그인 전용이다.--auth-mode session과 함께 쓰지 않는다.확인할 값:
hipass, korail, srt, 또는 allYYYY-MM-DD 시작일과 종료일outputs/receipts/YYYY-MM/pdf,pngprovider별로 가능한 자동 로그인 경로를 먼저 사용한다.
하이패스 상세 절차가 필요하면 references/hipass.md를 읽는다.
코레일/KTX 또는 SRT 승차권 구입이력 영수증 크롭 절차가 필요하면 references/korail-srt.md를 읽는다.
작업이 끝나면 아래만 짧게 보고한다.
references/hipass.mddocs/attribution.md출장, 출장서류, 출장증빙, 출장증빙자료, 출장비 정산서, 교통비 영수증, SRT/KTX 영수증을 바탕으로 공개 배포용 출장증빙 HWP 패키지를 작성할 때 사용한다. transport-receipt-collector와 연계해 영수증 PNG/PDF를 모으고, 출장비 정산서 HWP의 텍스트 필드와 영수증 이미지 슬롯을 검증한다.
출처 있는 심층조사와 판단 브리프가 필요할 때 사용하는 OpenClaw 맞춤 리서치 스킬. 단순 검색 답변이 아니라 정책·시장·기업·기술·제도·문헌·공공기관 보고서 근거를 여러 출처로 교차확인하고, 출처 등급·첨부 PDF 확인·반대검토·합의점/쟁점·의사결정 포인트까지 정리한다. Windows/OpenClaw 환경에서는 web_search, web_fetch, browser, pdf, korean-law 도구를 사용하고, 특정 로컬 환경 전용 검색 스크립트나 저장 경로는 사용하지 않는다.
공공기관 보고서, 결과보고, 계획보고, 검토보고, 회의결과 보고, 공문서 초안 작성에 사용하는 스킬. 사용자가 메모, 개요, 추진 경과, 계약 내용, 수요조사, 운영계획, 배분안, 붙임 자료 등을 주고 공공기관 결재문서 형태로 정리해 달라고 할 때 사용한다. 특히 계약 체결 결과와 향후 운영계획이 함께 들어가는 내부 결재문서는 상위 목차를 단순하게 유지하고, 세부 내용은 `주요 내용` 아래에 묶어 정리한다.
나라장터(g2b.go.kr) 입찰공고 Open API로 용역·물품·공사 공고를 검색하고 공고명, 수요기관, 공고기관, 추정가격·배정예산, 입찰마감, 개찰일시, 계약방법, 낙찰방법, 첨부 규격서 URL, 상세 URL을 정리한다. Use when the user asks to monitor Korean public procurement bids, AI/software/service tenders, consulting opportunities, or public-sector procurement notices.
열린국회정보 Open API와 국회 공식 시스템으로 특정 키워드 관련 법률안·의안 진행상태를 검색하고 제안일, 소관위원회, 처리결과, 대표발의자, 공동발의자, 상세 의안정보 링크, 회의록·입법예고 확인 링크를 정리한다. Use when the user asks to track Korean National Assembly bills, legislation changes, committee discussion clues, or public-sector regulatory impact by keyword.
공공데이터포털(data.go.kr) 목록개방현황 API로 공공기관이 개방한 파일데이터·오픈API·표준데이터를 키워드, 제공기관, 분류체계 기준으로 검색하고 목록유형, API 유형, 갱신주기, 조회수, 목록 URL, 설명을 출처와 함께 정리한다. Use when the user asks to find public datasets or APIs for a Korean public-sector project, policy report, data-based service idea, or administrative evidence search.