$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.0042 笔交易 · 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 login已登录 Acme 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 密钥。加密存储,并从日志中隐去。
- 命令
- 银行、账户、交易、余额、数据源、任务、表格、仪表板和自动化规则,另有 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 可用点路径选择列。
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。

