# iCost Analyzer

> 一个开源、第三方、非官方的 iCost Excel 账单分析网页。账单在用户当前浏览器页面内解析，本站不接收或保存账单文件。

用户可以导入 iCost 导出的 `.xlsx` 或 `.xls` 文件，查看收支指标、趋势、分类与标签汇总，并按日期、账户、账本、币种等条件筛选。汇率由页面提供静态默认值，也可由用户手动调整；它不是实时行情。

本文件介绍网站的公开功能，不包含用户账单，也不授予 Agent 读取账单的权限。仅向 Agent 提供网页链接，无法让它取得用户设备上的文件。

支持 WebMCP 的 Agent 浏览器可发现四个只读页面工具：`get_ledger_context`、`summarize_ledger`、`group_ledger` 和 `compare_periods`。使用时，用户须先在同一个浏览器页面内上传账单，再亲自点击“允许 Agent 分析”。Agent 应先调用 `get_ledger_context` 取得 `contextId`；后续查询需传入 `expectedContextId`。查询默认遵循页面当前筛选；只有明确指定 `scope: "all_data"` 才分析全账本。期间比较使用明确给出的日期；在默认范围下，它仍保留页面的非日期筛选。

工具只返回汇总统计、分组名称及筛选上下文，不提供逐笔交易，也不能修改页面筛选或汇率。调用结果可能进入用户所选 Agent 的会话。更换文件或刷新页面后，用户必须重新手动授权。缺少有效汇率时，人民币结果沿用页面数值并标记为部分合计。不同 Agent 浏览器对 WebMCP 的支持情况应以实际工具发现和调用结果为准。

## 入口

- [打开 iCost Analyzer](/): 在支持 WebMCP 的 Agent 浏览器中打开页面，由用户上传账单并手动授权后使用页面工具。