AGENT SKILL

hipass-receipt

공식 하이패스 홈페이지에서 사용자가 직접 로그인한 Chrome 세션을 재사용해 사용내역 조회와 영수증 팝업 진입을 돕는다.

License 许可
MIT
最近更新
2026-07-18
Stars
★ 0
Forks
1

01 前言 Front Matter

name
hipass-receipt
license
MIT
metadata
{ "phase": "v1", "locale": "ko-KR", "category": "transport" }
description
공식 하이패스 홈페이지에서 사용자가 직접 로그인한 Chrome 세션을 재사용해 사용내역 조회와 영수증 팝업 진입을 돕는다.

02 资源文件 1

03 SKILL.md 正文

하이패스 영수증 발급

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를 선택해 영수증 팝업 진입을 시도할 수 있다.
  • 세션 종료 응답을 감지하면 재로그인을 요구한다.

04 同仓库更多 Skills

om-scogo
om-scogo/skillsh-scraper

arxiv-search

Search arXiv physics, math, and computer science preprints using natural language queries. Powered by Valyu semantic search.

★ 0
om-scogo
om-scogo/skillsh-scraper

arxiv-search

Search arXiv physics, math, and computer science preprints using natural language queries. Powered by Valyu semantic search.

★ 0
om-scogo
om-scogo/skillsh-scraper

working-with-legacy-code

Safely change and test untested codebases using Feathers' "Working Effectively with Legacy Code". Use when the user mentions "legacy code", "no tests", "untested codebase", "how do I test this", "seams", "characterization tests", "golden master", "sprout method", "afraid to change this code", "monster method", "dependency breaking", or "inherited a messy codebase". Also trigger when changing code without tests safely, getting a class under test when constructors, statics, or singletons block it, adding features to tangled modules, or planning incremental test coverage for an old codebase. Covers the legacy-code change algorithm, seams, characterization tests, sprout/wrap, and dependency-breaking techniques. For refactoring code that already has tests, see refactoring-patterns. For day-to-day code quality, see clean-code.

★ 0
om-scogo
om-scogo/skillsh-scraper

working-with-legacy-code

Safely change and test untested codebases using Feathers' "Working Effectively with Legacy Code". Use when the user mentions "legacy code", "no tests", "untested codebase", "how do I test this", "seams", "characterization tests", "golden master", "sprout method", "afraid to change this code", "monster method", "dependency breaking", or "inherited a messy codebase". Also trigger when changing code without tests safely, getting a class under test when constructors, statics, or singletons block it, adding features to tangled modules, or planning incremental test coverage for an old codebase. Covers the legacy-code change algorithm, seams, characterization tests, sprout/wrap, and dependency-breaking techniques. For refactoring code that already has tests, see refactoring-patterns. For day-to-day code quality, see clean-code.

★ 0
om-scogo
om-scogo/skillsh-scraper

web-typography

Select, pair, and implement typefaces for web projects. Use when the user mentions "font pairing", "which typeface", "line height", "responsive typography", "web font loading", "type hierarchy", "variable fonts", "FOUT/FOIT", "typographic scale", or "the text is hard to read". Also trigger when choosing between system fonts and web fonts, optimizing font-loading performance, or designing readable long-form content. Covers readability evaluation, CSS implementation, and performance optimization. For overall UI design systems, see refactoring-ui. For dramatic typographic experiences, see top-design.

★ 0
om-scogo
om-scogo/skillsh-scraper

web-typography

Select, pair, and implement typefaces for web projects. Use when the user mentions "font pairing", "which typeface", "line height", "responsive typography", "web font loading", "type hierarchy", "variable fonts", "FOUT/FOIT", "typographic scale", or "the text is hard to read". Also trigger when choosing between system fonts and web fonts, optimizing font-loading performance, or designing readable long-form content. Covers readability evaluation, CSS implementation, and performance optimization. For overall UI design systems, see refactoring-ui. For dramatic typographic experiences, see top-design.

★ 0