核心用法
raiffeisen-elba 是一款针对奥地利 Raiffeisen 银行 ELBA 网银系统的自动化脚本工具，基于 Playwright 实现浏览器自动化。用户需配置 RAIFFEISEN_ELBA_ID（网银账号）和 RAIFFEISEN_ELBA_PIN（PIN 码）环境变量，通过 CLI 调用完成登录、查询账户列表、获取交易明细及证券持仓等操作。
典型使用流程为：login → accounts → transactions → portfolio → logout。其中 transactions 支持按 IBAN 过滤账户，并指定起止日期（--from / --until）导出 JSON 格式数据。所有会话数据（Cookie、LocalStorage、浏览器 Profile）会在 logout 时被清理，降低凭据残留风险。
显著优点
1. 结构化数据输出：直接返回 JSON，便于对接 ERP、记账软件或自建财务看板。
2. 无官方 API 依赖：通过浏览器自动化绕过银行未开放对公 API 的限制，适用于个人开发者及小型企业。
3. 会话隔离机制：显式 logout 命令清理浏览器持久化数据，减少敏感信息本地留存。
4. 开源可审计：代码托管于 GitHub，依赖可见，社区可审查 Playwright 脚本行为。
潜在缺点与局限性
1. 高敏感权限：需完整网银凭据，且使用 Playwright 模拟真实登录，相当于将账号密码交由脚本控制，一旦环境被入侵，资金面临直接风险。
2. 稳定性依赖前端：银行页面改版（HTML 结构调整、反爬升级、2FA 流程变化）即可导致脚本失效，维护成本由用户自行承担。
3. 合规灰区：违反 Raiffeisen 网银服务条款（TOS）的概率极高，账号可能被封禁；部分司法管辖区对“未经授权的自动化访问”有法律限制。
4. 无交易签名保护：脚本仅支持 PIN 登录，无法使用硬件令牌或生物识别二次验证，安全等级低于官方 App。
适合人群
- 德语区（奥地利为主）Raiffeisen 个人客户，需将财务数据自动同步至私有记账系统
- 技术背景较强的开发者，能自行审计 Python/Playwright 代码并监控异常
- 已接受“屏幕抓取”风险、且账号资金规模可控的自动化爱好者
不适合：对资金安全极度敏感、无技术排障能力、或账户受企业级合规审计约束的用户。
常规风险
- 凭据泄露：环境变量或 shell 历史可能留下明文 PIN；建议使用专属受限账号、配合密钥管理器（如 1Password CLI）注入。
- 会话劫持：Playwright 生成的浏览器 Profile 若未彻底清理，可能被恶意程序复用。
- 法律与封号：持续高频抓取易触发银行风控，导致网银功能受限或永久封禁。
- 依赖供应链：Playwright、Python 依赖及 Chromium 二进制存在被投毒可能，建议锁定版本并校验哈希。