은행 데이터까지 명령어 하나면 돼요.
바이너리 하나를 설치하고 로그인한 뒤, 터미널에서 거래 내역을 가져오거나 피드를 동기화하세요. 사람에게는 표로, 스크립트와 에이전트에는 안정적인 JSON으로 제공해요.
$banksync tx list --bank chase --from 2026-10-01DATE DESCRIPTION AMOUNT2026-10-08 Trader Joe’s -84.202026-10-07 Uber -24.502026-10-05 Delta Air Lines -412.00거래 42건 · Chase Checking ••4021$banksync feeds sync fed_123 --watch✓ 동기화 완료: 412행 기록
설치하고, 로그인하고, 시작하세요.
- 01
CLI 설치하기
macOS, Linux, Windows용 독립 실행형 단일 바이너리예요. Node도, 런타임도 필요 없어요.
macOS 및 Linux
curl -fsSL https://banksync.io/install.sh | sh# Windowsirm https://banksync.io/install.ps1 | iex
- 02
로그인하기
브라우저가 열리면 CLI를 승인해요. 스크립트와 CI에서는 대신 API 키를 사용해요.
터미널
banksync loginAcme Inc에 로그인했어요(프로필: default).
- 03
첫 명령어 실행하기
이름으로 찾을 수 있으므로 --bank chase로 Chase 연결을 찾아요.
터미널
banksync banks listbnk_a1b2 Chase ● activebnk_c3d4 CommBank ◐ syncing
처음부터 끝까지 살펴보는 CLI.
스크립트와 에이전트를 위해 만들었어요.
작업에 맞는 출력
$banksync tx list --bank chase -o csv > october.csv$banksync tx list --bank chase -o ndjson --fields date,amount{"date":"2026-10-08","amount":-84.2}{"date":"2026-10-07","amount":-24.5}$banksync tx list --bank chase | jq '.data | length'42
에이전트를 위한 셸 도구
$export BANKSYNC_API_KEY=bsk_live_…$banksync commands --json | jq '.commands | length'131$banksync commands --json | jq -r .api_versionv1
CLI로 할 수 있는 일.
- 설치
- macOS, Linux, Windows용 단일 바이너리이고 Node가 필요 없어요. 설치 가이드
- 로그인
- banksync login으로 브라우저 OAuth 로그인을 하거나, --api-key 또는 BANKSYNC_API_KEY로 API 키를 사용해요. 암호화되어 저장되고 로그에서는 가려져요.
- 명령
- 은행, 계좌, 거래, 잔액, 피드, 작업, Tables, Dashboards, Automations를 다루고, 원시 엔드포인트에는 banksync api를 사용해요.
- 출력
- table, json, csv, ndjson, toon을 지원하고, --fields로 점 표기 경로의 열을 지정해요.
- 계약
- REST API와 동일한 OpenAPI 명세에서 생성돼요. 둘이 어긋나면 CI 게이트가 빌드를 실패 처리해요.
- 은행
- banksync banks connect를 실행하면 웹 앱에서 은행 자체의 동의 화면이 열려요. 은행 로그인 정보는 CLI를 거치지 않아요.
하나의 계좌, 세 가지 접근 방법.
CLI, API, MCP에서 이어지는 연결된 데이터
자주 묻는 질문
BankSync CLI란 무엇인가요?
BankSync API를 위한 공식 명령줄 도구예요. 터미널에서 은행을 조회하고, 거래 내역을 가져오고, 피드를 관리하고, 동기화를 실행할 수 있어요. 사람에게는 표로, 스크립트와 에이전트에는 안정적인 JSON으로 결과를 보여 줘요.
BankSync CLI는 어떻게 설치하나요?
macOS나 Linux에서는 curl -fsSL https://banksync.io/install.sh | sh를, Windows에서는 irm https://banksync.io/install.ps1 | iex를 실행하세요. Node가 필요 없는 단일 바이너리예요. 설치 후 Workspace > Developers에서 발급한 키로 banksync login --api-key bsk_...를 실행하세요.
BankSync CLI는 AI 에이전트에 적합한가요?
네. 안정적인 JSON 엔벨로프, stderr로 출력되는 기계 판독 가능한 오류, 일관된 종료 코드와 banksync commands --json 카탈로그를 제공하므로 에이전트가 모든 명령어, 플래그, 필드를 스스로 찾을 수 있어요.
CLI는 어떤 출력 형식을 지원하나요?
-o로 table, json, csv, ndjson, toon 중 하나를 선택해요. 터미널에서는 기본적으로 표로, 파이프로 넘기면 JSON으로 출력되고, --fields로 점 표기 경로(dot-path)를 사용해 열을 선택할 수 있어요.
CLI는 어떻게 인증하나요?
banksync login을 실행하면 브라우저가 열리고 OAuth로 로그인해요. 스크립트와 CI에서는 banksync login --api-key 또는 BANKSYNC_API_KEY 변수로 API 키를 사용해요. 자격 증명은 암호화된 로컬 파일에 저장되고, 상세 로그에서는 가려져요.
CLI는 BankSync API와 항상 일치하나요?
네. 타입이 지정된 코어와 명령어 레퍼런스는 REST API와 동일한 OpenAPI 계약에서 생성되고, 둘이 어긋나면 CI 게이트가 빌드를 실패 처리해요.
CLI, REST API, MCP 서버를 함께 사용할 수 있나요?
네. 세 가지 모두 하나의 API 키와 하나의 데이터 세트를 공유해요. 스크립트와 에이전트에는 CLI, 코드에는 REST, 대화에는 MCP를 사용해요.
CLI에서 은행을 어떻게 연결하나요?
banksync banks connect를 실행하세요. 오픈뱅킹 연결 절차를 위해 BankSync 웹 앱이 열리고, 은행이 표시될 때까지 CLI가 상태를 확인해요. 은행 로그인 정보는 CLI를 거치지 않아요.

