// product
은행 입출금내역
23개 은행에서 입출금 내역을 동일 스키마로. CLI · GitHub Action · MCP 세 채널로.
// schemas
사용 스키마
bank.accounts.cb.v1bank.transactions.cb.v1
// scenario
은행 입출금내역 1개월 받기
터미널에 4월 입출금 거래 N건이 표 형태로 — 적요 · 금액 · 잔액 컬럼 그대로.
- 주기
- 임의 (한 번)
- 대상
- 처음 headless 를 둘러보는 모든 사용자.
- 채널
- CLI · Claude Code
01사전 점검
아래 명령을 그대로 붙여넣어 지금 내 환경이 준비됐는지 확인한다.
CLI 가 설치돼 있다
h6s --version버전 문자열이 출력된다
아니면 —
npm i -g @h6s-ai/cli로그인(또는 API Key)이 돼 있다
h6s whoami워크스페이스와 사용량이 출력된다
아니면 —
h6s init # 또는 export H6S_API_KEY=h6s_live_...대상 은행에 매칭되는 자격증명이 있다
h6s credentials list공동인증서 또는 그 은행 자격증명이 1건 이상 보인다
아니면 —
h6s credentials create --interactive --cert
02실행
한 줄이면 끝. 기본 출력은 터미널 표.
h6s fetch bank.transactions.cb.v1 --provider CB_KB --month 2026-04 --output markdown이렇게 보이면 성공
✓ 132건 수신 (2026-04-01 ~ 2026-04-30) 거래일 적요 금액 잔액 2026-04-29 ㈜에이클라이언트 +1,540,000 8,420,300
provider 코드는 대문자 고정 — 국민은행 CB_KB · 기업은행 CB_IBK · 신한 CB_SHINHAN. 소문자로 주면 백엔드가 거부한다.
provider 코드를 모르거나 한국어로 부르고 싶을 때. h6s-data skill 이 자동 발동한다.
4월 국민은행 입출금내역 받아줘
03검증
- 터미널에 거래일·적요·금액·잔액 4개 컬럼 표가 N건 출력된다.
- 명령 종료 후 echo $? 가 0 (성공). 1=비즈니스 에러·3=인증 에러.
- --save ./out/ 를 붙이면 ./out/ 아래에 자동 파일명으로 저장된다.
04흔한 에러
CREDENTIAL_INSUFFICIENT_FOR_PROVIDER그 provider 에 매칭되는 자격증명이 워크스페이스에 없다.
해결 h6s credentials create --interactive --cert (공동인증서 1개로 전 기관 공용).
CERT_EXPIRED · CERT_WRONG_PASSWORD등록된 공동인증서가 만료됐거나 비밀번호가 틀렸다.
해결 h6s credentials update 로 인증서/비밀번호 갱신 후 재실행.
DATE_RANGE_EXCEEDED요청 기간이 그 기관이 허용하는 한 번 조회 범위를 넘었다.
해결 --month 또는 더 짧은 --from/--to 로 나눠서 호출.
NO_API_KEYAPI Key 가 어디에도 설정돼 있지 않다.
해결 h6s init 또는 export H6S_API_KEY=h6s_live_...
API_RATE_LIMITED (429)분/시간당 호출 한도를 넘었다.
해결 잠시 후 재시도. CLI 는 Retry-After 를 존중해 1회 자동 재시도한다.
05변형
같은 사례에서 자주 바꾸는 옵션. 다른 사례는 아래 이전/다음에서.
임의 기간 (월 단위가 아닐 때)
h6s fetch bank.transactions.cb.v1 --provider CB_KB --from 2026-04-15 --to 2026-04-22CSV 파일로 저장
h6s fetch bank.transactions.cb.v1 --provider CB_KB --month 2026-04 --output csv --save bank-2026-04.csvCLI 없이 raw HTTP (cURL)
curl -s https://api.h6s.ai/api/v1/data-jobs \
-H "Authorization: Bearer $H6S_API_KEY" \
-H "Content-Type: application/json" \
-d '{"providerCode":"CB_KB","schema":"bank.transactions.cb.v1","params":{"month":"2026-04"}}'
# 응답의 id 로 GET /api/v1/data-jobs/{id}/results 를 완료까지 폴링// related