>_

API 參考文件

Agent Skills Index 提供公開 API 以供程式化存取。

概述

此 API 允許您：

  • 搜尋和瀏覽技能
  • 取得技能詳細資訊
  • 列出分類
  • 存取技能統計資料

基礎 URL

https://skillsmp.com/api/v1

認證

大多數端點是公開的，不需要認證。

對於有速率限制或使用者特定的端點，請包含 API 金鑰：

bash
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://skillsmp.com/api/v1/skills

速率限制

| 層級 | 請求數/小時 | 備註 | |------|---------------|-------| | 匿名 | 100 | 不需要認證 | | 已認證 | 1,000 | 需要 API 金鑰 | | 高級 | 10,000 | 請聯繫我們 |

速率限制標頭：

X-RateLimit-Limit: 100 X-RateLimit-Remaining: 95 X-RateLimit-Reset: 1640995200

回應格式

所有回應皆為 JSON 格式：

json
{
  "data": { ... },
  "meta": {
    "requestId": "req_abc123",
    "timestamp": "2024-01-15T10:30:00Z"
  }
}

錯誤回應：

json
{
  "error": {
    "code": "NOT_FOUND",
    "message": "Skill not found"
  },
  "meta": {
    "requestId": "req_abc123"
  }
}

端點

快速範例

列出技能

bash
curl https://skillsmp.com/api/v1/skills

搜尋技能

bash
curl "https://skillsmp.com/api/v1/skills/search?q=react"

取得技能詳細資訊

bash
curl https://skillsmp.com/api/v1/skills/owner/repo

列出分類

bash
curl https://skillsmp.com/api/v1/categories

SDK

JavaScript/TypeScript

bash
npm install @aiskills/sdk
typescript
import { SkillsClient } from '@aiskills/sdk';

const client = new SkillsClient();

const skills = await client.skills.list({
  category: 'development',
  limit: 10
});

Python

bash
pip install aiskills
python
from aiskills import SkillsClient

client = SkillsClient()

skills = client.skills.list(
    category='development',
    limit=10
)

Webhooks

訂閱事件以獲得即時更新：

  • skill.created - 新增技能
  • skill.updated - 技能內容更新
  • skill.deleted - 技能已移除

請聯繫我們以取得 webhook 存取權限。

支援

在 GitHub 上編輯此頁面