HostEarnings

接入你自己的工具
以及你的 AI 助手

三步，大约五分钟。所有套餐均包含，免费试用也一样。

下面的代码示例为英文。

  1. 创建密钥

    登录后打开设置中的 API 标签页。选择该密钥是只能读取数据还是也能修改，然后把密钥保存到安全的地方。它只显示一次。

  2. 把软件指向这个地址

    每次请求都用 Authorization 请求头发送密钥。先试试下面第一个示例，它能确认密钥是否可用，以及属于哪个账户。

    curl https://hostearnings.com/api/v1/me \
  -H "Authorization: Bearer YOUR_KEY"

# then, for example
curl "https://hostearnings.com/api/v1/transactions?start=2026-01-01&end=2026-03-31&limit=50" \
  -H "Authorization: Bearer YOUR_KEY"

curl "https://hostearnings.com/api/v1/reports?type=net_cash_flow&start=2026-01-01&end=2026-03-31" \
  -H "Authorization: Bearer YOUR_KEY"

  3. 或者连接一个 AI 助手

    Claude 这类助手可以通过下面的地址直接与你的账户通信，使用的是一个叫 MCP 的开放标准。连接之后，你就能用平常的话询问数据，或者把结算文件交给它。

    claude mcp add --transport http hostearnings https://hostearnings.com/mcp \
  --header "Authorization: Bearer YOUR_KEY"

密钥能做什么，不能做什么

只读密钥永远无法修改你的记录。除非另行选择，密钥会在九十天后过期，你也可以随时吊销，下一次请求即刻生效。任何密钥都不能创建另一个密钥、更改你的账单，或对外公开任何内容。删除的内容会进入回收站，可以恢复。

合理使用

每个密钥每分钟六十次请求、每天五千次，导入和报表的限制更严格。你本人在应用里的使用是单独计算的，所以后台运行的助手不会用光你的导出额度。

创建密钥

需要先登录。