APIリファレンス

Agent Skillsマーケットプレイスは、プログラムによるアクセスのための公開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"
  }
}

エンドポイント

Skills API - スキルの検索と取得
Categories API - カテゴリの一覧とフィルター
Search API - 全文検索

クイック例

スキルの一覧

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
)

Webhook

リアルタイム更新のためにイベントを購読：

skill.created - 新しいスキルが追加
skill.updated - スキルの内容が更新
skill.deleted - スキルが削除

Webhookアクセスについてはお問い合わせください。

サポート

GitHub Issues
メール: api@skillsmp.com