用途:这是一个命令行工具(simplefin-pp-cli)与本地 SQLite 数据库,用于以只读方式同步 SimpleFIN 账户数据,并离线进行跨机构财务分析。区别于其他把数据导入第三方应用的 SimpleFIN 工具,它强调数据由用户自己掌控。
主要能力:networth 统计跨机构净资产及余额趋势;cashflow 按月汇总收入与支出并按商户排序;recurring 通过识别重复收款方检测订阅与固定支出;portfolio 计算各券商持仓市值、成本基础与总盈亏;categorize 用确定性的关键词或正则规则为交易分类;reconcile 用内容哈希合并 SimpleFIN 不稳定镜像 ID 产生的重复交易;since 汇总某日期或上次同步后的新交易与余额变化;export 导出为 ledger、beancount、csv 或 qif。accounts 与 info 可实时拉取账户集和服务器元数据。
使用方式:需先安装 CLI。安装命令:npx -y @mvanhorn/printing-press-library install simplefin --cli-only,验证:simplefin-pp-cli --version。若失败可用 Go 安装(需 Go 1.26.6 或更新):go install github.com/mvanhorn/printing-press-library/library/payments/simplefin/cmd/simplefin-pp-cli@latest。认证无 API key,需用 base64 Setup Token 换取 Access URL:simplefin-pp-cli auth claim <setup-token>,也可设 SIMPLEFIN_ACCESS_URL。典型流程:auth claim、sync --since 90d、networth。加 --agent 可展开为 --json --compact --no-input --no-color --yes,支持 --select 筛选字段、--deliver 路由输出。可用 simplefin-pp-cli which "<能力描述>" 查找命令。MCP 安装:go install .../simplefin-pp-mcp@latest,再用 claude mcp add simplefin-pp-mcp -- simplefin-pp-mcp 注册。路径可用 --home 或 SIMPLEFIN_HOME 等环境变量重定位。
适用场景:cron 任务、智能体工作流、需要本地可控账本的纯文本记账管线。
限制:SimpleFIN 严格只读,不能转账、支付账单或发起资金操作;首次在浏览器连接银行属于 SimpleFIN Bridge 的 /create 流程,本 CLI 只消费其生成的令牌;它不是预算应用界面,完整预算应使用 Actual Budget 或 Lunch Money。价格、费用与平台支持范围等资料暂未提供。