用途:通过 Plaid 连接并读取用户已关联的金融机构数据,覆盖账户元数据、余额、交易、周期性收支、负债和投资。所有命令以 plaid <command> 运行并返回 JSON,供读取使用,不直接展示给用户;任意命令加 --help 查看选项。读取默认覆盖全部已关联机构,可用 --credential-id <id> 缩小到某家银行,部分读取支持可重复的 --account-id <id>。
连接:先运行 plaid status。若未连接,将返回的 connect_url 原样作为 Connect Plaid 发出,等待用户完成关联后再运行 plaid status。新增机构时用 add_account_url,不要复用 connect_url。断开全部机构用 plaid disconnect,若有 disconnect_url 则发出并等待确认;单家机构解绑需用户在设置中操作。
主要能力:plaid accounts 列出账户名称、类型、掩码及余额(available/current/limit),余额为 Plaid 最近上报值而非实时。plaid transactions-get --start-date YYYY-MM-DD --end-date YYYY-MM-DD 读取交易历史,日期含端点,无需手动分页;正数为流出,负数为流入。plaid transactions-sync 仅用于维护持久化交易存储与游标的场景。plaid transactions-recurring 返回周期性流入与流出,用于订阅和账单。plaid liabilities 返回信用卡、学生贷款和房贷的余额、利率、最低还款与到期日。plaid investments-holdings 返回持仓与证券,plaid investments-transactions 读取买卖分红活动,用 --offset/--count 分页。
限制:只读,不能转账、还款、开户或关闭账户,也不能提供完整账号或路由号。数据可能滞后于银行当前显示。覆盖范围取决于用户关联的机构及银行通过 Plaid 共享的内容,缺失账户类型应说明不可用而非视为零。输出给用户时使用自然语言,不暴露命令、字段名、原始 JSON、内部 ID 或密钥。