// 둘러보기 — 데이터 한 번 받아보기

은행 입출금내역 1개월 받기

터미널에 4월 입출금 거래 N건이 표 형태로 — 적요 · 금액 · 잔액 컬럼 그대로.

CLIClaude Code임의 (한 번)

이런 분께 — 처음 headless 를 둘러보는 모든 사용자.

terminal

$ h6s fetch bank.transactions.cb.v1 --provider CB_KB --month 2026-04✓ 132건 수신 (2026-04-01 ~ 2026-04-30)거래일 적요 금액 잔액2026-04-29 ㈜에이클라이언트 +1,540,000 8,420,300▍

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실행

실행 방식한 가지만 고르면 된다. 결과는 같다.

한 줄이면 끝. 기본 출력은 터미널 표.

terminal

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. 소문자로 주면 백엔드가 거부한다.

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_KEY

API Key 가 어디에도 설정돼 있지 않다.

해결 h6s init 또는 export H6S_API_KEY=h6s_live_...

API_RATE_LIMITED (429)

분/시간당 호출 한도를 넘었다.

해결 잠시 후 재시도. CLI 는 Retry-After 를 존중해 1회 자동 재시도한다.

05변형

같은 사례에서 자주 바꾸는 옵션. 다른 사례는 아래 이전/다음에서.

임의 기간 (월 단위가 아닐 때)

terminal

h6s fetch bank.transactions.cb.v1 --provider CB_KB --from 2026-04-15 --to 2026-04-22

CSV 파일로 저장

terminal

h6s fetch bank.transactions.cb.v1 --provider CB_KB --month 2026-04 --output csv --save bank-2026-04.csv

CLI 없이 raw HTTP (cURL)

terminal

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 를 완료까지 폴링

h6s-data skill 전체 흐름

다음매출 세금계산서 한 번 받기