名称： plaid
描述： plaid-cli 是一个用于与 Plaid 金融平台交互的命令行工具。可关联多家机构的账户，按日期范围查询余额与交易记录，并列出账户/余额信息。
元数据： {"clawdis":{"emoji":"💳","requires":{"bins":["plaid-cli"]},"install":[{"id":"go","kind":"go","module":"github.com/jverdi/plaid-cli@0.0.2","bins":["plaid-cli"],"label":"安装 plaid-cli (go)"}]}}

Plaid

使用 plaid-cli 通过 Plaid 关联金融机构、获取余额信息以及查询交易记录。
请勿打印或记录敏感信息（如客户端 ID、密钥、访问令牌）。

安装

• go install github.com/jverdi/plaid-cli@0.0.2

配置

• 设置环境变量：PLAID_CLIENT_ID、PLAID_SECRET 和 PLAID_ENVIRONMENT（可选 sandbox 或 production）。
• 可选环境变量：PLAID_LANGUAGE（支持 en、fr、es、nl）、PLAID_COUNTRIES（支持 US、CA、GB、IE、ES、FR、NL）。
• 可选配置文件：~/.plaid-cli/config.toml。
  toml [plaid] client_id = "..." secret = "..." environment = "sandbox"
• 数据目录：~/.plaid-cli（用于存储令牌和账户别名）。

关联账户与别名管理

• 关联机构：执行 plaid-cli link（将打开浏览器），可同时设置别名。
• 重新关联：plaid-cli link <item-id或别名>。
• 别名管理：使用 plaid-cli alias <item-id> <名称> 设置别名，plaid-cli aliases 查看列表。

账户与余额查询

• 列出账户及余额：plaid-cli accounts <item-id或别名>。

交易记录搜索

• 获取指定日期范围的 JSON 数据，然后本地筛选：
• plaid-cli transactions <item-id或别名> --from 2024-01-01 --to 2024-01-31 --output-format json
• jq -r '.[] | select(.name | test("grocery"; "i")) | [.date, .name, .amount] | @tsv'
• 使用 accounts 输出中的 --account-id 来缩小结果范围。
• 输出格式：支持 json 或 csv。

交易监控

• 轮询滚动时间窗口，通过比对交易 ID 检测新活动：
  bash state=/tmp/plaid.txids next=/tmp/plaid.txids.next plaid-cli transactions <item-id或别名> --from 2024-01-01 --to 2024-01-31 --output-format json \ | jq -r '.[].transaction_id' | sort > "$next" if [ -f "$state" ]; then comm -13 "$state" "$next"; fi mv "$next" "$state"
• 可使用 cron 定时任务进行调度。

注意事项

• 除非明确要求，避免使用 plaid-cli tokens 命令，因为它会打印访问令牌。
• 当出现 ITEM_LOGIN_REQUIRED 错误时，系统会自动触发重新关联流程。

常见请求示例

• “搜索上个月星巴克的交易记录”
• “显示我的 Chase 账户余额”