headless

// ai agent

내 도구가 위에 없다면

claude.ai (Cowork · Projects) · ChatGPT 웹 · Perplexity 등은 plugin marketplace 도, 로컬 stdio MCP 도 붙일 수 없습니다. 대신 터미널에서 @h6s-ai/cli 한 줄로 결과를 받아 챗에 그대로 붙여 넣으면 됩니다. 자격증명 등록 · 수집 요청 폴링 · 결과 정리까지 CLI 가 처리합니다.

처음이라면 먼저 headless 콘솔에 가입해 주세요. 가입 후 아래 4단계를 순서대로 따라오면 됩니다.

단계 1 — Node.js 설치

CLI 는 Node.js 20 이상에서 동작합니다. 이미 설치돼 있다면 node -v 로 버전만 확인하고 다음 단계로 넘어가세요.

터미널을 처음 여신다면 — Mac: 응용 프로그램 → 유틸리티 → 터미널, Windows: 시작 메뉴 → PowerShell 을 실행한 뒤 아래 명령을 붙여 넣으세요.

terminal — node.js 설치
# macOS — Homebrew
brew install node

# Windows — winget
winget install OpenJS.NodeJS.LTS

# macOS · Linux — nvm (버전 매니저)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
nvm install --lts

# 그 외 OS / 수동 설치는 https://nodejs.org/ko/download 의 LTS

# 설치 확인 — Node 20 이상이면 OK
node -v

단계 2 — CLI 설치 및 로그인

h6s init 은 Device Flow 로 브라우저 로그인 → 토큰을 ~/.h6s/config.json 에 저장 → 가용 schema 목록 안내까지 한 번에 처리합니다.

terminal — @h6s-ai/cli 설치
# 1. CLI 전역 설치
npm i -g @h6s-ai/cli

# 2. 첫 설정 (Device Flow 로그인 + 가용 schema 안내까지 자동)
h6s init

# 일회성으로 쓰고 싶다면 설치 없이 npx 로도 가능
npx @h6s-ai/cli init

단계 3 — 한 줄로 데이터 받기

h6s fetch 매크로가 schema 검증 → credential 매칭 → 수집 요청 생성 → 폴링 → 결과 회수까지 한 번에 처리합니다. --output 는 markdown / json / csv 중 챗에 붙이기 좋은 형식을 고르세요.

terminal — h6s fetch
# 한 줄 — markdown 으로 받아 챗에 그대로 붙이기
h6s fetch bank.transactions.cb.v1 --provider CB_KB --month 2026-03 --output markdown

# 기간을 직접 지정
h6s fetch bank.transactions.cb.v1 \
  --provider CB_KB \
  --from 2026-01-01 --to 2026-03-31 \
  --output markdown

# 매출 세금계산서 — 분기
h6s fetch hometax.tax-invoices.sales.v1 \
  --from 2026-01-01 --to 2026-03-31 \
  --output markdown

# 법인카드 승인내역 — 분기
h6s fetch card.approvals.corp.v1 \
  --provider CCD_SHINHAN \
  --from 2026-01-01 --to 2026-03-31 \
  --output markdown

# 파일로 떨어뜨려 두기
h6s fetch bank.transactions.cb.v1 --provider CB_KB --month 2026-03 \
  --output markdown --save ./out/

출력은 아래와 같은 markdown 표입니다. 그대로 챗에 붙여 넣으면 됩니다.

output — markdown 미리보기
| 거래일자     | 적요               |       입금 |     출금 |           잔액 |
|--------------|--------------------|-----------:|---------:|---------------:|
| 2026-03-02   | 거래처 A 입금      | 1,200,000  |        0 |   12,340,000   |
| 2026-03-05   | 카드대금           |         0  |  540,000 |   11,800,000   |
| 2026-03-08   | 거래처 B 입금      |   780,000  |        0 |   12,580,000   |
| 2026-03-15   | 임차료             |         0  |  900,000 |   11,680,000   |
| 2026-03-22   | 거래처 A 입금      | 1,500,000  |        0 |   13,180,000   |

공동인증서를 한 번 등록해 두면 --provider 만 바꿔가며 은행·홈택스 전체에 같은 인증서가 자동으로 매칭됩니다. 자격증명이 아직 없다면 CLI 가 친절한 에러로 h6s credentials create --interactive --cert 명령을 다음 단계로 안내합니다.

단계 4 — 결과를 챗에 붙여 넣고 분석 요청

단계 3 에서 받은 출력을 그대로 챗에 붙여 넣고 후속 작업을 자연어로 요청하면 됩니다. markdown 표 형식이면 claude.ai · ChatGPT · Perplexity 모두 표 구조를 그대로 인식합니다.

ai chat — 후속 프롬프트
# 위 명령의 출력 (markdown 표) 을 챗에 붙여 넣고 후속 요청
이 입출금내역을 거래일자 기준으로 정렬해서 표로 정리해줘.
이 중 30일 이상 미수된 입금건만 추려서 거래처별로 합계 내줘.
1월 매출 세금계산서와 대조해서 미회수 금액을 정리해줘.

향후

앞으로는 챗 안에서 headless 를 도구로 직접 부를 수 있도록 준비 중입니다 (claude.ai Connectors · ChatGPT Connectors 같은 hosted MCP endpoint 연결). 그때까지는 위 4단계로 같은 데이터를 챗에 가져올 수 있습니다.

다음 단계