plaid

💳 终端直连银行,掌控每一笔流水

通过 Plaid 连接银行账户,安全查询余额与交易记录,支持多机构聚合与本地化数据筛选。

收藏
9.8k
安装
2.6k
版本
0.0.3
CLS 安全性认证2026-06-04
点击查看完整报告 >

使用说明

核心用法

plaid-cli 是一款开源命令行工具,基于 Plaid 金融数据平台,支持用户从终端安全连接银行账户、查询实时余额及历史交易。核心工作流包括:

1. 账户关联:执行 plaid-cli link 启动浏览器 OAuth 流程,完成机构授权后可设置易记别名(alias)便于后续调用
2. 余额查询plaid-cli accounts <alias> 返回账户列表及可用余额、账户类型等元数据

3. 交易检索:支持按日期范围(--from/--to)、特定账户(--account-id)过滤,输出 JSON/CSV 格式,可配合 jq 实现本地复杂筛选

4. 交易监控:通过比对 transaction_id 快照实现增量检测,适合对接 cron 实现自动化财务监控

显著优点

  • 多机构聚合:单一接口覆盖北美及欧洲主流金融机构(Chase、Bank of America、Revolut 等)
  • 隐私可控:敏感凭证(client_id、secret、access tokens)仅存储于本地 ~/.plaid-cli,支持环境变量或 TOML 配置灵活管理
  • 开源透明:Go 语言实现,源码可审计,无第三方闭源依赖
  • 开发者友好:JSON 输出原生适配管道操作,便于与记账软件、数据看板集成

潜在局限

  • Plaid 依赖:实际数据新鲜度与覆盖范围受 Plaid API 及合作机构制约,部分小型信用社可能不支持
  • OAuth 重认证:部分机构要求定期重新授权(ITEM_LOGIN_REQUIRED),虽工具自动触发 relink,仍可能中断自动化流程
  • 沙盒/生产切换:开发测试与正式环境配置分离,误配可能导致请求失败或数据污染
  • 本地化计算:复杂财务分析(如分类统计、趋势预测)需用户自行用 jq/Python 实现,工具本身仅提供原始数据

适合人群

  • 技术型个人用户:偏好终端操作、需要自定义财务工作流(如自动记账、预算警报)
  • 开发者/DBA:构建个人财务数据湖,或为企业内部工具原型验证 Plaid 集成方案
  • 隐私敏感者:不愿使用云端理财 App,希望数据留在本地设备

常规风险

  • 凭证泄露:若 ~/.plaid-cli 目录权限配置不当或误执行 plaid-cli tokens 命令,访问令牌可能暴露;建议目录权限设为 700,生产环境禁用 tokens 子命令
  • Plaid 费用:生产环境 API 调用超出免费额度后产生费用,高频监控场景需评估成本
  • 数据残留:交易历史存储于本地文件,共享设备需定期清理 /tmp 及状态快照文件

> 注:本评估基于工具公开文档,未执行动态安全审计;生产部署前建议审查源码依赖及 Plaid 安全最佳实践。

安全解读

核心用法

该 Skill 是 plaid-cli 工具的纯文档型使用指南,自身无可执行代码。核心功能依赖用户本地安装的第三方 CLI 工具 github.com/jverdi/plaid-cli,用于与 Plaid 金融平台交互:

  • 账户关联plaid-cli link 通过浏览器 OAuth 流程关联金融机构,支持别名管理便于后续引用
  • 余额查询plaid-cli accounts <alias> 列出关联账户及实时余额
  • 交易检索plaid-cli transactions 支持按日期范围、账户 ID 筛选,输出 JSON/CSV 格式,可配合 jq 进行本地过滤
  • 交易监控:通过轮询交易 ID 比对实现增量检测,适合配合 cron 定时任务使用

显著优点

1. 零代码风险:T-MD 纯 Markdown 类型,无可执行代码块,攻击面极小
2. 金融级 API:基于 Plaid 官方服务,支持 12,000+ 金融机构,覆盖北美、欧洲主要银行

3. 灵活的本地处理:交易数据以标准格式输出,便于与现有工具链(jq、csvkit、pandas)集成

4. 沙箱支持:内置 sandbox 环境,无需真实凭证即可开发和测试

潜在缺点与局限性

1. 外部依赖重:需自行安装 Go 环境和 plaid-cli,版本锁定在 0.0.2,更新滞后
2. 凭证管理复杂:需手动配置 PLAID_CLIENT_IDPLAID_SECRET 等环境变量,初学者易出错

3. 无实时通知:交易监控依赖轮询,非 Webhook 推送,延迟取决于 cron 频率

4. 地域限制:仅支持美、加、英、爱、西、法、荷等国,亚太金融机构覆盖有限

5. 功能边界:Skill 本身仅提供文档指引,不处理任何实际 API 调用

适合人群

  • 开发者/工程师:需要将银行数据导入自建系统或自动化工作流
  • 高级用户:熟悉命令行、环境变量配置和基础脚本编写
  • 隐私敏感者:偏好本地处理交易数据,不愿使用云端记账软件
  • 不适合:无技术背景的普通消费者、追求即装即用的移动端用户

常规风险

  • 凭证泄露:Plaid API 密钥权限等同于银行只读访问,需严格保护 ~/.plaid-cli 目录权限
  • 依赖项风险plaid-cli 为个人维护项目(T3 来源),更新频率和长期维护存疑
  • 数据残留:交易数据以明文 JSON/CSV 形式输出,需妥善管理临时文件
  • 合规注意:自行处理金融数据需确保符合 PCI-DSS、GDPR 等法规要求

plaid 内容

手动下载zip · 1.5 kB
SKILL.mdtext/markdown
请选择文件