Skillppx logo

Firefly III API Client

通过 API 管理个人财务数据，支持交易、账户及规则自动化。

已扫描
适合谁
个人财务管理爱好者、自动化记账需求者
不适合谁
无 Firefly III 实例的用户、不熟悉 API 操作的初学者
国内可用性
需网络配置。可能需要网络配置或第三方服务可访问。
安装难度
新手友好（★☆☆）。基于终端操作、依赖、API Key 和本地环境要求的初步判断。

安装与下载

openclaw skills install @josetseph/firefly-iii-published
下载官方 ZIP

Skill 说明

命令、参数、文件名以原文为准

Firefly III 客户端技能

目的

一个可用于生产的 Firefly III 个人财务管理客户端，支持通过程序化方式访问交易记录、账户信息、重复规则及自动化功能。

安全注意事项

有关令牌安全、环境变量设置和网络安全性方面的信息，请参阅 SECURITY.md 文件。

配置步骤

  1. 确保 Firefly III 服务正在运行，并已获取 OAuth 个人访问令牌。
  2. 设置以下环境变量：
FIREFLY_URL=http://your-instance-url
FIREFLY_TOKEN=your_personal_access_token
  1. 安装依赖项：
pip install requests

命令行参考

api.py 脚本作为 Firefly III REST API 的通用封装工具。

  • python3 api.py request <METHOD> <ENDPOINT> [-d <JSON_DATA>]

使用示例

  • 列出账户：

python3 api.py request GET api/v1/accounts

  • 创建交易记录：

python3 api.py request POST api/v1/transactions -d '{"amount": "10.00", "description": "咖啡", "source_id": 1, "destination_id": 2, "date": "2026-04-06", "type": "withdrawal"}'

  • 创建定期交易：

python3 api.py request POST api/v1/recurrences -d '{"type": "withdrawal", "title": "示例", "first_date": "2026-04-30", "repeat_freq": "monthly", "nr_of_repetitions": 12, "repetitions": [{"type": "monthly", "moment": "30"}], "transactions": [{"description": "项目", "amount": "100.00", "source_id": 1, "destination_id": 2}]}'

  • 创建规则：

python3 api.py request POST api/v1/rules -d '{"title": "示例规则", "trigger": "destination_account_is", "value": "Netflix", "action": "link_to_bill", "action_value": "Netflix 账单"}'

J
@josetseph

已收录 1 个 Skill

相关推荐