// getting started
5분 안에 첫 수집 요청
데이터는 어떤 시나리오든 API 키 + REST 호출 하나로 받습니다. CLI · AI Agent · 정기 자동화는 그 위에 얹는 편의 채널입니다.
대부분의 사용자가 시작하는 두 채널
시나리오에 맞으면 얹어 쓰는 채널
예제 — 국민은행 입출금내역 1개월
공동인증서를 등록했다면 providerCode 를 생략해도 은행 · 홈택스 전체에 자동 매칭됩니다.
terminal — curl
# 0. 콘솔에서 자격증명 등록 + API 키 발급 (한 번만, UI 안내 따라 5분)
# https://h6s.ai/console/credentials → 기관 선택 + 자격증명 입력
# https://h6s.ai/console/api-keys → API 키 발급
export H6S_API_KEY=h6s_live_...
# 1. 수집 요청 생성 (API 키 하나로 자격증명 자동 매칭)
curl -sS -X POST 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": { "dateRangeStart": "2026-03-01", "dateRangeEnd": "2026-03-31" }
}'
# 2. 결과 조회 (status=SUCCEEDED 후)
curl -sS https://api.h6s.ai/api/v1/data-jobs/<job-id>/results \
-H "Authorization: Bearer $H6S_API_KEY"terminal — @h6s-ai/cli
# 1. 설치
npm i -g @h6s-ai/cli
# 2. 시작 (로그인 + 가용 schema 확인 + 다음 명령 안내까지 한 번에)
h6s init
# 3. 데이터 수집 요청
h6s fetch bank.transactions.cb.v1 --provider CB_KB --month 2026-03 --output markdownterminal — @h6s-ai/toolkit (AI 에이전트)
# Claude Code
/plugin marketplace add bolta-io/h6s-toolkit
/plugin install h6s-data@h6s
# 이후 자연어로:
# "1월 국민은행 입출금내역 받아줘"
# "매출 세금계산서랑 국민은행 입금내역 대조해서 30일 이상 미수금 정리해줘"
# "1월 매출/매입 세금계산서로 월간 손익 요약 HTML 보고서 만들어줘"
# Cursor / Gemini / 일반 MCP 클라이언트
npx @h6s-ai/toolkit install --target=cursor # 또는 gemini / mcp