格纹

使用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。

  [plaid]
  client_id = "..."
  secret = "..."
  environment = "sandbox"
  

• 数据目录：~/.plaid-cli（存储令牌和别名）。

链接 + 别名

• 链接机构：plaid-cli link（打开浏览器）并可选择设置别名。
• 重新链接：plaid-cli link <项目ID或别名>。
• 别名：plaid-cli alias <项目ID> <名称>，通过plaid-cli aliases列出。

账户 + 余额

• 列出账户和余额：plaid-cli accounts <项目ID或别名>。

搜索交易

• 以JSON格式拉取一个日期范围，然后在本地过滤：
  • plaid-cli transactions <项目ID或别名> --from 2024-01-01 --to 2024-01-31 --output-format json
  • jq -r '.[] | select(.name | test("grocery"; "i")) | [.date, .name, .amount] | @tsv'
• 使用--account-id来自账户输出以缩小结果范围。
• 输出格式：json或csv。

监控交易

• 轮询滚动窗口并比较交易ID以检测新活动：

  state=/tmp/plaid.txids
  next=/tmp/plaid.txids.next
  plaid-cli transactions <item-id-or-alias> --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令牌除非明确要求；它会打印访问令牌。
• 重新链接在ITEM_LOGIN_REQUIRED错误时自动触发。

识别如下请求：

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