（11687期）monarch-money – 智能预算管理与交易自动化助手

智能预算管理与交易自动化助手 基于 TypeScript 的 Monarch Money 自动化工具，支持交易查询、分类管理和预算追踪，通过 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 的重度用户，特别是需要定期整理大量交易记录和更新分类的预算爱好者；希望将财务数据集成到个人自动化工作流中的开发者；以及需要批量处理历史交易数据的高级用户。对于仅偶尔查看预算或不熟悉命令行操作的用户，该技能的学习成本可能过高。 使用风险方面，首要关注的是凭证安全。虽然项目本身对本地存储进行了加密，但用户仍需妥善保管 MONARCHEMAIL、MONARCHPASSWORD 和 MONARCHMFASECRET 等敏感环境变量，避免泄露导致账户被盗。其次，会话文件存储在本地 ~/.mm/ 目录，虽然权限已设置为 0o700 且内容加密，但在共享设备或权限配置不当的环境中仍存在潜在风险。此外，频繁调用 Monarch Money API 可能触发平台速率限制，建议在自动化脚本中合理控制请求频率。最后，由于涉及金融数据操作，建议用户在使用前备份重要数据，并先在测试环境验证命令逻辑。 原始说明 TypeScript library and CLI for Monarch Money budget management. Search transactions by date/merchant/amount, update categories, list accounts and budgets, manage authentication. Use when user asks about Monarch Money transactions, wants to categorize spending, needs to find specific transactions, or wants to automate budget tasks.