账单追踪技能

当用户询问账单、账户余额或能否负担某项支出时，请使用bash工具调用账单追踪API。

所需环境变量

• - BILLTRACKERURL - 基础URL（例如 https://your-server.com 或 http://localhost:1337）
• BILLTRACKERSESSION_TOKEN - 用于身份验证的会话令牌（通过POST /api/mcp/token一次性获取）

获取会话令牌

账单追踪使用魔法链接认证（无需密码）。分两步：

1. 1. 请求验证码（发送至邮箱）：

1. 2. 用邮箱中的验证码换取会话令牌：

将返回的sessionToken存储在BILLTRACKERSESSION_TOKEN中。令牌长期有效，无需每次请求都重新验证。（验证码10分钟内有效。）

接口端点

1. 即将发生的交易（即将到期的账单和收入）

POST ${BILLTRACKERURL}/api/mcp/upcoming-transactions
X-Parse-Session-Token: ${BILLTRACKERSESSION_TOKEN}
请求体：{ days: 3 }

默认days为3。如需更长时间窗口可增加数值（例如days=7）。

2. 账户余额

POST ${BILLTRACKERURL}/api/mcp/account-balances
X-Parse-Session-Token: ${BILLTRACKERSESSION_TOKEN}

返回每个账户的名称、类型、余额以及总余额（现金减去负债）。

3. 能否负担某项支出？

POST ${BILLTRACKERURL}/api/mcp/can-afford
X-Parse-Session-Token: ${BILLTRACKERSESSION_TOKEN}
请求体：{ amount: 500, horizonDays: 90 }

将500替换为美元金额。horizonDays默认为90。

返回结果为canAfford: true并附上可负担日期，或canAfford: false并附上说明信息。

调用方式

使用curl发送POST请求。传递X-Parse-Session-Token（或Authorization: Bearer $BILLTRACKERSESSION_TOKEN）进行身份验证。令牌用于识别用户身份，无需邮箱或密码。解析JSON响应并向用户清晰总结。

示例（即将发生的交易）：
bash
curl -s -X POST -H X-Parse-Session-Token: $BILLTRACKERSESSION_TOKEN -H Content-Type: application/json \
-d {days: 3} \
${BILLTRACKERURL}/api/mcp/upcoming-transactions

示例（账户余额）：
bash
curl -s -X POST -H X-Parse-Session-Token: $BILLTRACKERSESSION_TOKEN -H Content-Type: application/json \
-d {} \
${BILLTRACKERURL}/api/mcp/account-balances

示例（能否负担）：
bash
curl -s -X POST -H X-Parse-Session-Token: $BILLTRACKERSESSION_TOKEN -H Content-Type: application/json \
-d {amount: 500} \
${BILLTRACKERURL}/api/mcp/can-afford