---
id: daily-hipass-receipt
name: "hipass-receipt"
url: https://skills.yangsir.net/skill/daily-hipass-receipt
author: nomadamas
domain: finance
tags: ["automation", "finance", "receipts", "korea", "expense-tracking"]
install_count: 1900
rating: 4.30 (6 reviews)
github: https://github.com/nomadamas/k-skill
---

# hipass-receipt

> 韩国高速公路 Hi-Pass 电子收费收据自动获取工具。登录韩国高速公团官网，查询通行记录并下载 PDF 收据。支持批量查询和历史记录归档。适用于个人报销和企业车队管理。

**Stats**: 1,900 installs · 4.3/5 (6 reviews)

## Before / After 对比

### Hi-Pass收据获取效率提升

**Before**:

获取Hi-Pass通行收据通常需要用户手动完成一系列繁琐步骤。首先，您必须打开浏览器，访问Hi-Pass官网，然后手动输入ID、密码，并可能处理OTP或共同认证等复杂登录流程。登录后，您需要手动导航至“使用内역 조회”页面，输入起始和结束日期，点击查询。接着，您必须在查询结果中逐一查找并点击所需收据对应的“영수증”或“출력”按钮，这会弹出一个新窗口供您打印或保存。对于多张收据，此过程需重复多次，耗时且易出错，尤其在会话过期时，需要重新登录并从头开始。

**After**:

使用`hipass-receipt`技能，获取收据流程得到显著简化。用户只需通过`hipass-receipt chrome-command`启动一个专用Chrome浏览器，并进行一次手动登录，此登录会话即可被技能复用。之后，您可以通过简单的CLI命令`hipass-receipt list`，指定日期范围，自动查询并获取结构化的使用记录列表。要获取特定记录的收据，只需使用`hipass-receipt receipt`命令并提供行索引，技能将自动打开收据打印弹出窗口，并返回其URL。技能还能智能检测会话过期，并及时提示用户重新登录，避免了手动排查和重复操作，大大提升了效率和便利性。

| Metric | Before | After | Change |
|---|---|---|---|
| 单张收据获取时间（登录后） | 90秒 | 15秒 | -83.33% |
| 手动交互步骤（登录后） | 6次 | 0次 | -100% |
| 10张收据获取时间（登录后） | 900秒 | 110秒 | -87.78% |

## Readme

# 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 프로필로 로그인 브라우저를 띄운다

```
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. 사용내역을 조회한다

```
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의 영수증 팝업을 연다

```
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를 선택해 영수증 팝업 진입을 시도할 수 있다.

- 세션 종료 응답을 감지하면 재로그인을 요구한다.

Weekly Installs510Repository[nomadamas/k-skill](https://github.com/nomadamas/k-skill)GitHub Stars3.1KFirst Seen6 days agoSecurity Audits[Gen Agent Trust HubPass](/nomadamas/k-skill/hipass-receipt/security/agent-trust-hub)[SocketPass](/nomadamas/k-skill/hipass-receipt/security/socket)[SnykWarn](/nomadamas/k-skill/hipass-receipt/security/snyk)Installed onantigravity508codex508opencode507github-copilot507kimi-cli507amp507

---
*Source: https://skills.yangsir.net/skill/daily-hipass-receipt*
*Markdown mirror: https://skills.yangsir.net/api/skill/daily-hipass-receipt/markdown*