开发者
OPEN API v1 · FREE本站数据免费开放:三个只读端点 + 一枚可贴进任何 README 的徽章。 数据与站内榜单同源,S-Score 每小时重算。
使用规则
RATE LIMIT · ATTRIBUTION| 限频 | 每 IP 50 req/min,超限返回 429 + Retry-After;响应带 X-RateLimit-Limit 契约头。缓存 s-maxage=300,轮询间隔建议 ≥ 5 分钟。更高配额见 订阅。 |
| 免费月总量 | 每 IP 100,000 次 / 30 天,超出返回 429 monthly_quota_exceeded。 正常集成远用不到此量;需要更高量级或稳定 SLA 请走订阅 Key。 |
| 商用边界 | 免费档与订阅附带 Key(Pro / Max)为个人与非商用用途,不含 SLA 与 webhook, 且需保留署名回链。商业转售、白标、对外提供衍生数据服务需商用授权(独立 API 产品线, 见 定价)。 |
| CORS | 全开(Access-Control-Allow-Origin: *),浏览器端可直接调用。 |
| 署名要求 | 公开展示本站数据时必须注明来源: data by SKILL.STUDY — https://skill.study(每个响应的 attribution 字段原样携带,直接透传即可)。 |
| 免费范围 | 以下三端点永久免费。更高频率 / 历史数据 / Webhook 见 定价。 |
按次计量核销
PER-CALL METERING · 创作者上架「按次调用」商品后:买家购买一个调用包 → 获得额度与一个 access_token → 把 token 配置到调用方。 你的服务每被调用一次,用你自己的 API Key 回调本接口核销一次。 平台不中转流量,不介入你的服务可用性。
POST /api/v1/consume
Authorization: Bearer sks_... # 你的 API Key(/me/api 生成)
Content-Type: application/json
{
"access_token": "ct_...", # 买家给你的调用凭证
"units": 1, # 本次消耗次数,1–1000
"idempotency_key": "your-request-id" # 可选,重试不会重复扣减
}
→ 200 { "ok": true, "units": 1, "remaining": 999 }
→ 402 { "error": "insufficient_credits" } # 买家额度用尽,提示其续购
→ 403 { "error": "forbidden" } # 该 token 不属于你的商品
建议:先核销再执行(额度不足即拒绝服务),并对同一请求带稳定的 idempotency_key。买家可在「我的购买」看到用量明细与余额, 也可自助轮换 token。
GET /api/v1/skills/{slug}
FREE · JSON单个 Skill 详情:S-Score、7 日变动、星数、7 日走势、分类与区域。
$curl https://skill.study/api/v1/skills/browser-use{
"name": "browser-use",
"slug": "browser-use",
"score": 96,
"scoreDelta": 2,
"stars": "67.2k",
"starsDelta": 412,
"category": "Agent 框架",
"categorySlug": "agent",
"region": "global",
"sparkline7d": [4, 5, 7, 6, 10, 12, 14, 16],
"updatedAt": "2026-07-13T00:00:00.000Z",
"url": "https://skill.study/skill/browser-use",
"attribution": "data by SKILL.STUDY — https://skill.study"
}
GET /api/v1/trending
FREE · JSON热榜:period=daily|weekly|monthly|rising(默认 daily),limit 上限 50(默认 20)。rising 期间额外返回 jump(跳升位数)与 why(上榜理由)。
$curl "https://skill.study/api/v1/trending?period=daily&limit=20"{
"period": "daily",
"count": 20,
"updatedAt": "2026-07-13T00:00:00.000Z",
"items": [
{
"rank": 1,
"name": "browser-use",
"slug": "browser-use",
"score": 96,
"scoreDelta": 2,
"stars": "67.2k",
"starsDelta": 412,
"category": "Agent 框架",
"categorySlug": "agent",
"region": "global",
"url": "https://skill.study/skill/browser-use"
}
],
"attribution": "data by SKILL.STUDY — https://skill.study"
}
GET /api/v1/categories
FREE · JSON十大分类清单与收录数量。
$curl https://skill.study/api/v1/categories{
"count": 10,
"items": [
{
"slug": "agent",
"name": "Agent 框架",
"skillCount": 428,
"url": "https://skill.study/category/agent"
}
],
"attribution": "data by SKILL.STUDY — https://skill.study"
}
README 徽章
BADGE · SVG · 1H CACHE一行 Markdown,把你的 S-Score 与 7 日走势贴进任何仓库 —— 微型行情牌,每小时更新。 把 browser-use 换成你的 skill slug。
20PX · 28PX(?size=28)[](https://skill.study/skill/browser-use)端点:GET /api/badge/{slug}.svg · 可选 ?size=28 · Content-Type image/svg+xml · 缓存 1 小时