FYN

FYN Finance Agent 技能

适用于 FYN 的官方 AI Agent 技能——提供银行账户同步、AI 收据识别和消费洞察的个人财务服务。

这是什么？

这是一个 ClawHub 技能包，可让任何 AI Agent（OpenClaw、Clank，或任何具备 HTTP 工具的 Agent）通过 FYN 访问你的个人财务数据。

你的 Agent 可以：

• 查询银行交易和消费模式
• 查看账户余额和净资产
• 监控预算和订阅
• 获取每日简报、提醒和财务健康评分
• 用自然语言提问，了解你的财务状况
• 使用 AI 搜索收据（Pro）
• 检查是否负担得起某项消费（Pro）

安装

clawhub install fyn-finance

或者手动将 SKILL.md 复制到 Agent 的技能目录中。

快速开始

1. 注册 fyn.fyi 账号（免费）
2. 连接你的银行账户（通过 Plaid）
3. 前往 Settings > Agent Access，生成 API 密钥
4. 在 Agent 的环境中设置 FYN_API_KEY

export FYN_API_KEY=fyn_ak_your_key_here

5. 向 Agent 询问你的财务状况：

“我这个月在杂货上花了多少钱？” “我的净资产是多少？” “我有哪项支出超出预算了吗？”

API 端点

所有端点均使用 https://api.fyn.fyi/v1/agent 作为基础 URL。

免费套餐

端点	方法	描述
/transactions/recent	GET	最近的交易
/transactions/sum	POST	某一时间段的总支出
/spending/breakdown	POST	按类别／商户统计支出
/spending/compare	POST	比较两个时间段
/spending/discretionary	POST	可自由支配支出与必要支出
/accounts/balances	GET	所有账户余额
/accounts/balance	GET	单个账户余额
/accounts/net-worth	GET	净资产
/budget/status	GET	预算状态
/budget/over	GET	超出预算的类别
/subscriptions	GET	检测到的订阅
/subscriptions/total	GET	订阅总费用
/cashflow	GET	现金流摘要
/cashflow/savings-rate	GET	储蓄率
/portfolio	GET	投资组合摘要
/holdings	GET	单项持仓
/insights/daily	GET	每日财务简报
/insights/alerts	GET	活跃异常和警告
/insights/opportunities	GET	省钱建议
/insights/weekly	GET	每周财务回顾
/insights/health	GET	财务健康评分（0-100）
/insights/ask	POST	自然语言洞察查询

Pro 套餐（$9.99/月）

端点	方法	描述
/receipts/search	POST	搜索收据明细项
/receipts/rag	POST	与收据对话（RAG）
/affordability	POST	负担能力检查

速率限制

套餐	每日调用次数	收据 RAG 查询次数
免费	50	10
Pro	2,000	500

示例

请参阅 examples/ 目录：

• basic-query.md — 交易、支出明细和余额
• receipt-search.md — AI 收据搜索和 RAG
• budget-check.md — 预算、负担能力和订阅

身份验证

所有请求都需要 API 密钥：

Authorization: Bearer fyn_ak_your_key_here

前往 fyn.fyi/settings/agent-access 生成密钥。

链接

• FYN 主页
• Agent 介绍页面
• API 文档
• SKILL.md — 完整技能定义

许可证

MIT