monarch-money

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 可能触发平台速率限制，建议在自动化脚本中合理控制请求频率。最后，由于涉及金融数据操作，建议用户在使用前备份重要数据，并先在测试环境验证命令逻辑。