智能预算管理与交易自动化助手

基于 TypeScript 的 Monarch Money 自动化工具，支持交易查询、分类管理和预算追踪，通过 CLI 和库形式提供安全的个人财务自动化能力。

基本信息

• 技能名称?monarch-money
• 中文名称?智能预算管理与交易自动化助手
• 作者?davideasaf
• 分类?专业技能
• 版本?v1.0.1
• 标签?finance-accounting, automation, api, productivity, cli

使用方法

使用说明
Monarch Money 是一款专为 Monarch Money 预算管理平台设计的 TypeScript 库与命令行工具（CLI），旨在帮助用户实现个人财务数据的自动化管理与批量操作。该技能通过提供标准化的编程接口和易用的命令行界面，使用户能够高效地完成交易查询、分类更新、账户管理等常见预算任务，无需手动在网页界面中逐一操作。
核心用法方面，Monarch Money 支持两种使用模式：作为 CLI 工具直接在终端执行命令，或作为 TypeScript 库集成到其他应用程序中。CLI 提供了完整的命令体系，包括身份验证管理（ auth login/logout/status ）、交易操作（ tx list/get/update ）、分类管理（ cat list ）、账户查询（ acc list ）以及诊断工具（ doctor ）。用户可通过环境变量配置登录凭证，支持基于 TOTP 的多因素认证（MFA），并能在本地加密存储会话信息以便重复使用。库模式则允许开发者通过 MonarchClient 类以编程方式访问所有功能，适合构建自定义财务工作流。
该技能的显著优点在于其完善的自动化能力与安全性设计。首先，它支持复杂的交易筛选（按日期、商家、金额）和批量分类更新，大幅提升预算整理效率。其次，项目采用严格的代码规范，无危险代码执行函数，所有依赖版本均已锁定，且敏感数据（会话令牌、缓存）采用 AES 加密本地存储。此外，危险操作（如删除或修改）默认需要 --yes 二次确认，有效防止误操作。
然而，该技能也存在一定局限性。配置门槛较高，用户必须正确设置 Monarch Money 账户邮箱、密码及 MFA 密钥，且 MFA 密钥的获取过程需要用户暂时禁用并重新启用双因素认证，对非技术用户不够友好。其次，该工具完全依赖于 Monarch Money 的第三方 API，若官方 API 变更或限制访问，功能可能受影响。此外，作为个人开发者（T3 来源）维护的项目，长期维护稳定性与官方支持相比存在一定不确定性。
适合的目标群体主要包括：Monarch Money 的重度用户，特别是需要定期整理大量交易记录和更新分类的预算爱好者；希望将财务数据集成到个人自动化工作流中的开发者；以及需要批量处理历史交易数据的高级用户。对于仅偶尔查看预算或不熟悉命令行操作的用户，该技能的学习成本可能过高。
使用风险方面，首要关注的是凭证安全。虽然项目本身对本地存储进行了加密，但用户仍需妥善保管 MONARCH_EMAIL 、 MONARCH_PASSWORD 和 MONARCH_MFA_SECRET 等敏感环境变量，避免泄露导致账户被盗。其次，会话文件存储在本地 ~/.mm/ 目录，虽然权限已设置为 0o700 且内容加密，但在共享设备或权限配置不当的环境中仍存在潜在风险。此外，频繁调用 Monarch Money API 可能触发平台速率限制，建议在自动化脚本中合理控制请求频率。最后，由于涉及金融数据操作，建议用户在使用前备份重要数据，并先在测试环境验证命令逻辑。