核心功能
Raiffeisen ELBA 网银自动化技能基于 Python Playwright 框架,专为数位化银行整合设计。主要功能涵盖:
- 安全登录登出:调用
login命令建立浏览器会话,完成后务必执行logout清除 cookies、localStorage 及 Playwright 本地配置,降低凭据残留风险。 - 账户全景查询:
accounts指令返回所有账户类型(活期、储蓄、信用卡)的实时余额与 IBAN 标识。 - 交易明细抓取:支持按 IBAN 与日期区间(
--from/--until)筛选,输出结构化 JSON,便于对账或导入记账软件。 - 投资组合快照:
portfolio命令可获取证券持仓市值。
显著优点
1. 原生网银协议:不依赖非官方 API,直接操作 ELBA 网页端,兼容性随银行界面更新而自动适配。
2. 结构化输出:JSON 格式便于与 Home Assistant、GnuCash、Beancount 等工具链集成。
3. 会话隔离:Playwright 独立浏览器上下文,避免与日常浏览环境混用。
潜在局限与风险
- 环境依赖重:需安装 Chromium/Firefox 浏览器二进制、Python 3 及 Playwright 库,容器化部署体积较大。
- 凭证明文存储:依赖环境变量
RAIFFEISEN_ELBA_ID与PIN,若主机被入侵存在泄露可能;建议配合 Docker secrets 或系统密钥环加固。 - UI 脆弱性:银行前端改版会导致选择器失效,需及时维护。
- 合规灰色地带:部分国家 TOS 禁止自动化登录,长期使用可能触发风控或账户限制。
适合人群
- 技术型个人用户:希望自动同步 Raiffeisen 账户数据至私有财务系统。
- 开源贡献者:愿意维护选择器并适配银行界面变更。
常规风险
- Selenium/Playwright 特征检测:银行可能识别无头浏览器并强制 MFA 或暂时封禁。
- 会话超时:未主动 logout 会导致磁盘残留登录态,带来本地权限提升风险。