>_

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

속도 제한

| 등급 | 요청/시간 | 비고 | |------|---------------|-------| | Anonymous | 100 | 인증 불필요 | | Authenticated | 1,000 | API 키 필요 | | Premium | 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
)

웹훅

실시간 업데이트를 위한 이벤트 구독:

  • skill.created - 새 스킬 추가됨
  • skill.updated - 스킬 내용 업데이트됨
  • skill.deleted - 스킬 제거됨

웹훅 접근은 문의해 주세요.

지원

GitHub에서 이 페이지 편집