headless

// getting started

5분 안에 첫 수집 요청

headless 는 같은 데이터를 네 가지 채널로 제공합니다. 시나리오에 맞춰 골라 쓰세요. API 키 하나면 모든 채널에서 동등하게 동작합니다.

채널 비교

Web Console

GUI 로 한 번씩 수동 수집. 회원가입 → API 키 발급 → 자격증명 등록 → 수집 요청.

콘솔 열기
Open REST API

백엔드 / 스크립트에서 직접 호출. API 키 1개로 모든 채널 공통.

API Reference
CLI

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

@h6s-ai/cli
AI Agent

Claude Code · Cursor · Gemini 에서 자연어로. MCP 매니페스트 포함.

Claude Code 로 시작하기
Showcase

PR · Slack · Notion · AI 분개 — 산출물 모양 그대로 보는 16가지 활용 사례.

사례 보기

예제 — 국민은행 입출금내역 1개월

공동인증서를 등록했다면 providerCode 를 생략해도 은행 · 홈택스 전체에 자동 매칭됩니다.

terminal — curl
# 0. 콘솔에서 발급한 API 키
export H6S_API_KEY=h6s_live_...

# 1. 자격증명 등록 (응답에 credentialHealth 즉시 포함)
curl -sS -X POST https://api.h6s.ai/api/v1/credentials \
  -H "Authorization: Bearer $H6S_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "providerCode": "CB_KB",
    "authMethod": "ID",
    "displayName": "KB 법인",
    "credentials": { "userId": "...", "password": "..." }
  }'

# 2. 수집 요청 생성
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" }
  }'

# 3. 결과 조회 (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 markdown
terminal — @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

다음 단계