ynab-api

YNAB API 管理技能为与 You Need A Budget (YNAB) 数据交互提供了强大的命令行界面。该技能专为希望超越手动输入的用户设计，利用 curl 和 jq 从终端或 AI 代理环境直接执行程序化预算操作。对于个人理财爱好者、需要跨多个账户追踪支出的进阶用户，以及任何希望将自动化财务摘要整合到日常工作流程中的人来说，这是理想的工具。无论您是需要记录交易、分析每月支出模式，还是监控资金龄 (Age of Money)，此工具都能提供维护财务健康的结构化方式。

• 自动化报告功能，包括每日支出摘要、每月预算进度及月份间支出比较。

• 交易管理能力：创建交易、处理拆分类别 (split categories)，并执行收款人搜索以保持类别一致性。

• 财务洞察：监控类别目标进度、追踪即将到期的账单，并接收超支或预算不足的警报。

• 智能转账处理：利用 transfer_payee_id 确保账户间的资金移动在 YNAB 分类账中被正确分类与链接。

• 智能错误处理：针对 401 和 429 API 错误提供自动重试机制，防止常见的频率限制问题中断用户体验。

• 配置需求：需要 YNAB_API_KEY 与 YNAB_BUDGET_ID，并支持通过环境变量或本地 config.json 设置每月预算目标。

• 数据精度：所有金额皆以 milliunits 处理 (例如 10.00 表示为 10000)；与 API 交互时请务必正确使用乘数与除数。

• 操作准则：在新增交易前，请务必先搜索既有交易或收款人，以防止重复记录并保持报告准确性。

• 性能优化：API 设有严格频率限制 (每小时约 200 次请求)；针对大量数据应启用缓存并避免激进的轮询。

• 语境感知：当解释来自 daily-spending-report.sh 的原始指标时，代理将担任财务分析师，将数据转化为对用户自然且具建设性的建议。