headless

Financial data,
headless.

홈택스 · 은행 · 카드사.
78개 기관의 데이터를 하나의 API로.

terminal

curl -X POST https://api.h6s.ai/api/v1/data-jobs \
  -H "Authorization: Bearer h6s_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "providerCode": "CB_SHINHAN",
    "schema": "bank.transactions.cb.v1",
    "params": {
      "dateRangeStart": "2026-03-01",
      "dateRangeEnd": "2026-03-31"
    }
  }'

78+

금융기관

데이터 액션

표준 데이터 형식

// features

Why headless

Unified Endpoint

다양한 인증 방식을 하나의 엔드포인트로 통합. 기관별 차이를 추상화합니다.

POST /api/v1/data-jobs HTTP/1.1
Host: api.h6s.ai
Authorization: Bearer h6s_live_***
Content-Type: application/json

Standardized Schema

6개 표준 데이터 형식으로 데이터 정규화. 기관이 달라도 응답 구조는 하나입니다.

{
  "schema": "bank.transactions.cb.v1"
}

Auto-Chunking

긴 기간 요청을 chunk 단위로 자동 분할 · 병렬 실행 후 결과를 합쳐 한 번에 돌려줍니다.

{
  "dateRangeStart": "2026-01-01",
  "dateRangeEnd":   "2026-12-31",
  "totalTaskCount": 12,
  "chunkSizeDays":  30
}

// advantages

기존 API와 다릅니다

운영 부담을 줄입니다

기관 인터페이스가 변경되어도 headless가 대응합니다. 재시도, 청킹, 장애 복구를 지원합니다.

기관 변경 시 자동 대응 — 고객 코드 수정 불필요
네트워크 오류·타임아웃 자동 재시도
대용량 조회 자동 청킹 처리
수집 상태 실시간 모니터링

접근 정보, 철저하게 보호합니다

인증서·비밀번호·접근 정보를 봉투 암호화해 보관하고, 스크래핑 실행 시점에만 복호화합니다. 평문은 영속 저장소에 남지 않습니다.

인증서·비밀번호 AES-256 암호화 저장
복호화 키와 분리해 봉투 암호화 보관
고객사 서버에 민감 정보 보관 불필요
접근 로그 감사 추적

코드 변경 없이 확장

새로운 기관이나 액션이 추가되어도 기존 연동 코드는 그대로 유지됩니다. API 스펙 변경 없이 사용할 수 있습니다.

새 기관 추가 시 동일 API로 지원
액션 추가 시 SDK·코드 업데이트 불필요
하위 호환성 보장
78개 기관 동일 스펙으로 연동

원하는 방식으로 연동하세요

시스템 아키텍처에 맞는 인터페이스를 선택할 수 있습니다. 동기부터 비동기, 메시지 큐까지.

동기 HTTP — 요청 후 응답
비동기 HTTP (Polling) — 상태 조회
비동기 HTTP (Webhook) — 완료 시 콜백
Queue (SQS, Kafka) — 메시지 기반 연동

// api

Simple API

하나의 엔드포인트. 표준 데이터 형식. 5분이면 첫 API 호출.

request.http

POST /api/v1/data-jobs
Authorization: Bearer h6s_live_...
Content-Type: application/json

{
  "providerCode": "CB_SHINHAN",
  "schema": "bank.transactions.cb.v1",
  "params": {
    "dateRangeStart": "2026-03-01",
    "dateRangeEnd": "2026-03-31"
  }
}

GET /api/v1/data-jobs/{id}/results
Authorization: Bearer h6s_live_...

response.json

{
  "kind": "SUCCEEDED",
  "id": "0193e6f0-2c8a-7c4e-9f1b-1a2b3c4d5e6f",
  "providerCode": "CB_SHINHAN",
  "schema": "bank.transactions.cb.v1",
  "status": "SUCCEEDED",
  "totalTaskCount": 2,
  "completedTaskCount": 2,
  "succeededRecordCount": 124
}

{
  "jobId": "0193e6f0-2c8a-7c4e-9f1b-1a2b3c4d5e6f",
  "schema": "bank.transactions.cb.v1",
  "totalCount": 124,
  "data": [
    {
      "schema": "bank.transactions.cb.v1",
      "transactionAt": "2026-03-15T14:32:00+09:00",
      "accountNumber": "140014167889",
      "accountType": "CHECKING",
      "currencyCode": "KRW",
      "amount": -1500000,
      "description": "(주)클라우드인프라 3월 사용료",
      "balance": 32450000
    }
  ]
}

request.http

POST /api/v1/data-jobs
Authorization: Bearer h6s_live_...
Content-Type: application/json

{
  "providerCode": "CB_SHINHAN",
  "schema": "bank.transactions.cb.v1",
  "params": {
    "dateRangeStart": "2026-03-01",
    "dateRangeEnd": "2026-03-31"
  }
}

GET /api/v1/data-jobs/{id}/results
Authorization: Bearer h6s_live_...

response.json

{
  "kind": "SUCCEEDED",
  "id": "0193e6f0-2c8a-7c4e-9f1b-1a2b3c4d5e6f",
  "providerCode": "CB_SHINHAN",
  "schema": "bank.transactions.cb.v1",
  "status": "SUCCEEDED",
  "totalTaskCount": 2,
  "completedTaskCount": 2,
  "succeededRecordCount": 124
}

{
  "jobId": "0193e6f0-2c8a-7c4e-9f1b-1a2b3c4d5e6f",
  "schema": "bank.transactions.cb.v1",
  "totalCount": 124,
  "data": [
    {
      "schema": "bank.transactions.cb.v1",
      "transactionAt": "2026-03-15T14:32:00+09:00",
      "accountNumber": "140014167889",
      "accountType": "CHECKING",
      "currencyCode": "KRW",
      "amount": -1500000,
      "description": "(주)클라우드인프라 3월 사용료",
      "balance": 32450000
    }
  ]
}

// workflow

How it works

Connect

금융 기관 인증서를 등록하고 자격증명을 설정합니다.

POST /api/v1/credentials

{ "providerCode": "CB_SHINHAN", "authMethod": "ID", "displayName": "신한 메인", "credentials": { ... } }

Collect

요청 한 번으로 데이터를 수집합니다. 기간이 길면 구간을 나눠 요청하고, 실패하면 다시 시도합니다.

POST /api/v1/data-jobs

{ "providerCode": "CB_SHINHAN", "schema": "bank.transactions.cb.v1", "params": { "dateRangeStart": "2026-03-01", "dateRangeEnd": "2026-03-31" } }

Normalize

정규화된 표준 데이터 형식으로 데이터를 활용합니다. 기관별 차이는 headless가 처리합니다.

GET /api/v1/data-jobs/{id}/results

{ "schema": "bank.transactions.cb.v1", "totalCount": 124, "data": [...] }

// use cases

받게 되는 결과

한 번 받아보기부터 정기 자동화 · 팀 워크플로우 · 업종별 시나리오까지.

둘러보기

데이터 한 번 받아보기

API Key 와 자격증명만 있으면 명령 한 줄로 데이터를 받아본다. 응답 모양과 자격증명 상태를 같이 확인하는 첫 단계.

은행 입출금내역 1개월 받기
매출 세금계산서 한 번 받기

전체 시나리오 보기

정기 자동화

저장소로 받기

GitHub Actions cron + h6s-action 으로 데이터를 PR · Artifact 형태로 무인 수신.

월말 입출금내역을 PR 로 받기
주간 다종 수집 — 한 PR 합본
수집 후 Slack 알림

전체 시나리오 보기

팀 워크플로우에 녹여내기

수집 결과를 Slack · Notion · Gmail로 전송해 결산 · 대사 · 미수금 추적까지 한 번에.

일일 거래 요약 + 분개 후보 제안
자체 정산 어드민에 매월 적재
매출 대사 (세금계산서 ↔ 입금)

전체 시나리오 보기

업종별

그대로 따라가는 시나리오

1인 사장님 · 이커머스 셀러 · 회계법인 · SaaS 스타트업 네 페르소나가 자기 환경에서 바로 돌릴 수 있는 사례. 카드별로 복붙 스니펫 + 5분 quickstart + 데모 영상이 따라온다.

법인카드 — 주간 승인내역 지출 모니터링
1인 사장님 — 분기 부가세 신고 자료
1인 사장님 — 종합소득세 월별 누적

전체 시나리오 보기

// providers

78+ 금융기관

은행, 카드사, 홈택스. 하나의 API로 모두 연결합니다.

국민

신한

하나

우리

농협

기업

SC제일

카카오뱅크

토스뱅크

케이뱅크

수협

대구

부산

광주

전북

경남

제주

새마을

신협

우체국

삼성카드

신한카드

현대카드

KB국민카드

롯데카드

우리카드

하나카드

BC카드

NH카드

씨티카드

홈택스

+47

78+ 금융기관. 하나의 API.

// security

보안은 기능이 아니라 전제입니다.

AES-256 암호화

인증서·비밀번호 등 자격증명은 AES-256으로 암호화해 저장합니다.

인증서 보호

공동인증서·기관 인증 파일도 자격증명과 동일하게 암호화해 보관합니다.

민감정보 마스킹·최소 권한

운영 로그로 나가는 민감 값은 마스킹하고, 인프라 권한을 최소화합니다.

API 키 기반 접근 제어

API 키 단위로 권한과 호출량을 세밀하게 제어합니다.

// deep dive

클로드로 우리 회사의 재무 데이터를 분석하려면?

매일 아침 홈택스와 은행 사이트에서 엑셀을 다운로드하던 시대는 끝났습니다. 이제 채팅 한 줄이면 우리 회사의 모든 재무 데이터를 실시간으로 연결할 수 있습니다.

“은행마다 인증 방식이 다르고, 카드사마다 응답 포맷이 다르다. 3개월에서 6개월을 연동에 쏟고도 유지보수에 허덕이는 팀을 수없이 봐왔다. 이 인프라를 모든 팀이 매번 새로 만드는 건 낭비라는 것을 확신하게 됐다.”

금융 데이터, 하나의 API로 — Headless Finance Platform을 공개합니다

dataportal.kr

// developers

원하는 방식으로 호출하세요

REST · CLI · AI 에이전트 — 같은 데이터를 네 가지 채널로 제공합니다.

API Reference

OpenAPI 스펙 그대로

검색 · 태그 · 언어별 코드 샘플을 갖춘 라이브 레퍼런스. 모든 엔드포인트와 스키마를 한눈에.

레퍼런스 열기 openapi.json

CLI

@h6s-ai/cli

터미널 한 줄로 시작. `h6s init` 한 번이면 로그인 · 자격증명 · 첫 수집 요청까지 자동.

npm i -g @h6s-ai/cli && h6s init

npm 에서 보기

AI Toolkit

@h6s-ai/toolkit

Claude Code · Cursor · Gemini 에서 자연어로 호출. MCP 서버 매니페스트가 같이 들어있습니다.

npx @h6s-ai/toolkit install --target=cursor

npm 에서 보기

코드 샘플

REST 호출 한 번

curl 한 줄로 수집 요청 + 정규화된 JSON 응답을 바로 확인합니다. 표준 데이터 형식.

샘플 보기

// pricing

Pricing

무료

₩0/월

동시 처리 1건
월 수집 요청 20건 · 스크래핑 단계 100건
무제한 API 키 · 자격증명
이메일 지원

무료로 시작하기

스탠다드 1x

₩1,000,000/월 (VAT 별도)

연 결제 시 ₩900,000/월 · 10% 할인

동시 처리 2건 — 통장·카드 등 주요 계정 동시 갱신
무제한 수집 요청 · 무제한 스크래핑 단계
무제한 API 키 · 자격증명
실시간 지원 (슬랙)

스탠다드 1x 시작하기

엔터프라이즈

커스텀

동시 처리 협의 (2x · 4x · 8x · 16x+)
전담 엔지니어 배정
전담 지원

요금제 자세히 보기

headless

Get started

지금 가입하고 API 키를 발급받으세요.

회원가입

Financial data,headless.

Why headless

Unified Endpoint

Standardized Schema

Auto-Chunking

기존 API와 다릅니다

운영 부담을 줄입니다

접근 정보, 철저하게 보호합니다

코드 변경 없이 확장

원하는 방식으로 연동하세요

Simple API

How it works

Connect

Collect

Normalize

받게 되는 결과

둘러보기

정기 자동화

팀 워크플로우에 녹여내기

업종별

78+ 금융기관

보안은 기능이 아니라 전제입니다.

AES-256 암호화

인증서 보호

민감정보 마스킹·최소 권한

API 키 기반 접근 제어

클로드로 우리 회사의 재무 데이터를 분석하려면?

원하는 방식으로 호출하세요

OpenAPI 스펙 그대로

@h6s-ai/cli

@h6s-ai/toolkit

REST 호출 한 번

Pricing

무료

스탠다드 1x

엔터프라이즈

Get started

Simple API

Financial data,
headless.