Hipass Receipt
Pull South Korea Hi-pass toll usage and open official receipt print flows by reusing your own logged-in Chrome session—no credential automation.
Overview
Hi-pass Receipt is an agent skill for the Operate phase that semi-automates official Hi-pass usage lookup and receipt print entry using a user-owned logged-in Chrome session.
Install
npx skills add https://github.com/nomadamas/k-skill --skill hipass-receiptWhat is this skill?
- Reuses user-logged Chrome via Playwright persistent context or remote debugging—not stored JSESSIONID-only hacks
- Hard limits: no auto login, OTP, or certificate input; stops and prompts re-login on session expiry
- CLI `hipass-receipt chrome-command` for dedicated profile and debugging port 9222
- Flow mirrors official site: usage search list then `/usepculr/UsePculrReceiptPrint.do` popup
- Session signals documented (`session_time=1200`, sessionCheck/sessionout, mgs_type 11/12)
- Session exposure notes session_time=1200 on public pages
- v1 scope: logged-in Chrome session reuse only
Adoption & trust: 2.2k installs on skills.sh; 5.4k GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You need Hi-pass toll receipts for reimbursement but manual portal clicking every billing cycle is slow and easy to mis-session.
Who is it for?
Korea-based builders or operators who already use Hi-pass and can log in once per session in a dedicated Chrome profile.
Skip if: Anyone expecting fully unattended login, credential vaulting, or non-Chrome environments without remote debugging.
When should I use this skill?
User needs Hi-pass usage inquiry or official receipt print after self-service login on hipass.co.kr.
What do I get? / Deliverables
You reach the official receipt print popup for chosen usage rows with session-expiry detection and clear re-login steps instead of brittle cookie replay.
- Usage list navigation assistance
- Receipt popup/print screen entry
- Session expiry and re-login guidance
Recommended Skills
Journey fit
How it compares
Official-session browser assistant, not a third-party toll API or receipt OCR service.
Common Questions / FAQ
Who is hipass-receipt for?
Solo builders and operators in Korea who file expenses from personal or business Hi-pass toll usage and want agent-guided browser steps on the official site.
When should I use hipass-receipt?
During Operate when you periodically reconcile toll charges and need usage lists plus receipt print screens after you have logged in manually in Chrome.
Is hipass-receipt safe to install?
It requires browser and shell access to your machine; review the Security Audits panel on this page and never share profiles that contain active banking or government sessions.
SKILL.md
READMESKILL.md - Hipass Receipt
# 하이패스 영수증 발급 ## What this skill does 공식 하이패스 홈페이지(`https://www.hipass.co.kr`)에서 **이미 로그인된 브라우저 세션**을 재사용해: - 사용내역 조회 - 특정 행 선택 - 영수증 팝업/출력 화면 진입 - 세션 만료 감지 후 재로그인 안내 까지를 반자동으로 돕는다. ## Hard limits - **로그인은 반드시 사용자가 직접 해야 한다.** - 이 스킬은 **로그인된 세션에서만** 동작한다. - ID/PW, 인증코드, OTP, 공동인증서 절차를 자동 입력하지 않는다. - `JSESSIONID` 쿠키만 저장해 장시간 재사용하는 방식은 지원하지 않는다. - 권장 세션 형태는 **Playwright persistent context** 또는 Chrome `user-data-dir` / remote-debugging 재사용이다. - **세션이 만료되면 즉시 중단하고 다시 로그인**해야 한다. ## Why this design 현재 공개 페이지 기준으로: - 로그인 페이지와 메인 페이지에 `session_time=1200` 이 노출된다. - 세션 연장은 `/comm/sessionCheck.do` - 세션 종료는 `/comm//sessionout.do` - 미로그인/세션 종료 보호 응답은 `mgs_type 11/12` 후 `/comm/lginpg.do` 로 이동한다. - 사용내역 조회는 `/usepculr/InitUsePculrTabSearch.do` → `hpForm` submit → `/usepculr/UsePculrTabSearchList.do` 흐름이다. - 영수증은 `/usepculr/UsePculrReceiptPrint.do` 팝업 진입으로 이어진다. 즉 v1은 **“로그인된 Chrome 세션 재사용”** 이 가장 현실적이다. ## Prerequisites - macOS 또는 Chrome 실행 가능한 환경 - `npm install hipass-receipt` 또는 이 레포에서 `npm install` (`playwright-core` 포함) - Chrome 원격 디버깅 포트 사용 가능 - 사용자가 직접 하이패스 로그인 가능 ## Workflow ### 1. 전용 Chrome 프로필로 로그인 브라우저를 띄운다 ```bash hipass-receipt chrome-command --profile-dir "$HOME/.cache/k-skill/hipass-chrome" --debugging-port 9222 ``` 위 명령이 출력한 Chrome 실행문으로 브라우저를 띄운 뒤, 사용자가 직접 `https://www.hipass.co.kr/comm/lginpg.do` 에 로그인한다. ### 2. 사용내역을 조회한다 ```bash hipass-receipt list \ --cdp-url http://127.0.0.1:9222 \ --start-date 2026-04-01 \ --end-date 2026-04-07 \ --page-size 30 ``` - 카드사/암호화 카드번호를 알고 있으면 `--encrypted-card-number` 등으로 더 좁힐 수 있다. - `--encrypted-card-number` 는 CLI의 기존 `--ecd-no` 별칭이다. - 결과 JSON에서 `rowIndex` 를 확인한다. ### 3. 특정 row의 영수증 팝업을 연다 ```bash hipass-receipt receipt \ --cdp-url http://127.0.0.1:9222 \ --start-date 2026-04-01 \ --end-date 2026-04-07 \ --row-index 1 ``` - 선택한 행의 `영수증`/`출력` control 을 클릭한다. - 팝업이 열리면 URL/title 을 반환한다. ## Response policy - “로그인 필수”, “세션 만료 시 재로그인 필요”를 항상 명확히 적는다. - 하이패스 계정 비밀번호를 받아 저장하거나 새 env var를 만들지 않는다. - 세션이 만료됐으면 즉시 실패시키고 `/comm/lginpg.do` 재로그인만 안내한다. - v1 범위를 넘어서는 완전 무인 로그인 유지/백그라운드 재인증은 약속하지 않는다. ## Verification - 자동 검증: fixture 기반 query/parser/session-detection 테스트 - smoke 검증: `hipass-receipt fixture-demo --fixture ...` - 최종 실서비스 검증: **로그인된 세션으로 수동 smoke test** ## Done when - 로그인된 세션으로 사용내역 조회가 가능하다. - 특정 row를 선택해 영수증 팝업 진입을 시도할 수 있다. - 세션 종료 응답을 감지하면 재로그인을 요구한다.