名称： onlyfansapi-skill
描述： >-
通过 OnlyFansAPI.com 平台查询 OnlyFans 数据与分析。获取所有模特的总收入摘要，识别表现最佳的模特，分析免费试用链接和追踪链接的转化率，比较链接收益等！
当用户询问任何与 OnlyFans 相关的问题时使用此技能。
compatibility: 需要 curl、jq 以及访问 app.onlyfansapi.com 的网络权限
元数据：
author: OnlyFansAPI.com
version: "1.0"
允许工具： Bash(curl:) Bash(jq:) Read

OnlyFans API 技能

此技能通过查询 OnlyFansAPI.com 平台，回答有关 OnlyFans 机构分析的问题，包括收入、模特表现和链接转化指标。

前提条件

用户必须设置环境变量 ONLYFANSAPI_API_KEY，其值为从 https://app.onlyfansapi.com/api-keys 获取的 API 密钥。

如果密钥未设置，请提醒用户：

请导出您的 OnlyFansAPI 密钥：
  export ONLYFANSAPI_API_KEY="您的 API 密钥"

API 基础

• 基础 URL: https://app.onlyfansapi.com
• 认证头: Authorization: Bearer $ONLYFANSAPI_API_KEY
• 所有日期使用 URL 编码格式：YYYY-MM-DD HH:MM:SS
• 如果未指定具体时间，则使用当天开始时间或结束时间（对于日期范围的结束日期）
• 分页：使用 limit 和 offset 查询参数。检查响应中的 hasMore 或 _pagination.next_page。
• 尽可能使用值为 OnlyFansAPI-Skill 的 User-Agent。
• 尽力从端点的示例响应推断数据结构。例如，从端点获取收益标量值可使用 "data.total.total"。

工作流程

1. 获取过去 N 天所有模特的收入

步骤:

1. 列出所有已关联账户：

   bash curl -s -H "Authorization: Bearer $ONLYFANSAPI_API_KEY" \ "https://app.onlyfansapi.com/api/accounts" | jq .

   每个账户对象包含 "id"（例如 "acct_xxx"）、"onlyfans_username" 和 "display_name"。

2. 为每个账户获取收益：

   ```bash
   START=$(date -u -v-7d '+%Y-%m-%d+00%%3A00%%3A00') # macOS

   Linux: START=$(date -u -d '7 days ago' '+%Y-%m-%d+00%%3A00%%3A00')

   END=$(date -u '+%Y-%m-%d+23%%3A59%%3A59')

   curl -s -H "Authorization: Bearer $ONLYFANSAPI_API_KEY" \
   "https://app.onlyfansapi.com/api/{account_id}/statistics/statements/earnings?start_date=$START&end_date=$END&type=total" | jq .
   ```

   响应字段：
   - data.total — 净收益
   - data.gross — 总收益
   - data.chartAmount — 每日收益细分数组
   - data.delta — 与前一时期相比的百分比变化

3. 汇总： 以表格形式呈现每个模特的显示名称、用户名、净收入和总收入。并计算总和。

2. 哪个模特表现最佳

使用与上述相同的工作流程。按 data.total（净收益）降序排列模特。数值最高的模特即为表现最佳者。

可选地，也可获取统计概览以获取更丰富的上下文信息：

curl -s -H "Authorization: Bearer $ONLYFANSAPI_API_KEY" \
  "https://app.onlyfansapi.com/api/{account_id}/statistics/overview?start_date=$START&end_date=$END" | jq .

此端点增加了订阅者数量、访客统计、帖子/消息收益细分等数据。

3. 哪个免费试用链接的转化率最高（订阅者 → 付费者）

1. 列出免费试用链接：

   bash curl -s -H "Authorization: Bearer $ONLYFANSAPI_API_KEY" \ "https://app.onlyfansapi.com/api/{account_id}/trial-links?limit=100&offset=0&sort=desc&field=subscribe_counts&synchronous=true" | jq .

   每个链接的关键响应字段：
   - id、trialLinkName、url
   - claimCounts — 领取试用的订阅者总数
   - clicksCounts — 总点击次数
   - revenue.total — 此链接产生的总收入
   - revenue.spendersCount — 花费了钱的订阅者数量
   - revenue.revenuePerSubscriber — 每个订阅者的平均收入

2. 计算转化率：

   转化率 = spendersCount / claimCounts

   按转化率降序排列链接。

3. 呈现结果 为表格：链接名称、领取数、付费者数、转化率、总收入。

4. 哪个追踪链接的转化率最高

1. 列出追踪链接：

   bash curl -s -H "Authorization: Bearer $ONLYFANSAPI_API_KEY" \ "https://app.onlyfansapi.com/api/{account_id}/tracking-links?limit=100&offset=0&sort=desc&sortby=claims&synchronous=true" | jq .

   每个链接的关键响应字段：
   - id、campaignName、campaignUrl
   - subscribersCount — 来自此链接的订阅者总数
   - clicksCount — 总点击次数
   - revenue.total — 总收入
   - revenue.spendersCount — 花费了钱的订阅者数量
   - revenue.revenuePerSubscriber — 每个订阅者的平均收入
   - revenue.revenuePerClick — 每次点击的平均收入

2. 计算转化率：

   转化率 = revenue.spendersCount / subscribersCount

3. 呈现结果 为表格：活动名称、订阅者数、付费者数、转化率、总收入、每订阅者收入。

5. 哪个免费试用/追踪链接收益最高

使用上述相同的列表端点。按 revenue.total 降序排序。呈现收益最高的链接及其名称、类型（试用 vs. 追踪）、总收入、订阅者/付费者数量。

多账户（机构）查询

对于涉及所有模特的机构级查询，请始终：

1. 首先通过 GET /api/accounts 获取所有账户
2. 遍历每个账户并收集相关数据
3. 汇总并呈现包含每个模特细分的综合结果

收益类型筛选器

查询 GET /api/{account}/statistics/statements/earnings 时，type 参数可按类别筛选：

• total — 所有收益合计
• subscribes — 订阅收入
• tips — 收到的小费
• post — 付费帖子收入
• messages — 付费消息收入
• stream — 直播收入

如有疑问

如果您对端点、参数、响应格式或如何使用 OnlyFans API 完成特定任务不确定，请查阅官方文档 https://docs.onlyfansapi.com。该网站包含所有可用端点的完整 API 参考详情、指南和示例。在猜测之前，请务必查阅文档。

错误处理

• 如果 ONLYFANSAPI_API_KEY 未设置，请停止并提示用户进行配置。
• 如果 API 调用返回非 200 状态码，请显示错误消息和 HTTP 状态码。
• 如果 _meta._rate_limits.remaining_minute 或 remaining_day 为 0，请警告用户速率限制。
• 如果账户的 "is_authenticated": false，请注意该账户需要重新认证。

输出格式

• 始终以 Markdown 表格形式呈现数据以提高可读性。
• 货币值格式化为两位小数。
• 显示百分比（转化率、变化率）时，格式化为 XX.X%。
• 对于多模特汇总，在底部包含一个 总计 行。