Referencia de API

El Agent Skills Index proporciona una API publica para acceso programatico.

Descripcion General

La API te permite:

Buscar y explorar skills
Obtener detalles de skills
Listar categorias
Acceder a estadisticas de skills

URL Base

https://skillsmp.com/api/v1

Autenticacion

La mayoria de los endpoints son publicos y no requieren autenticacion.

Para endpoints con limite de tasa o especificos del usuario, incluye una clave de API:

bash

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

Limites de Tasa

| Nivel | Solicitudes/Hora | Notas | |------|---------------|-------| | Anonimo | 100 | Sin autenticacion requerida | | Autenticado | 1,000 | Clave de API requerida | | Premium | 10,000 | Contactanos |

Cabeceras de limite de tasa:

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

Formato de Respuesta

Todas las respuestas son JSON:

json

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

Respuestas de error:

json

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

Endpoints

API de Skills - Buscar y recuperar skills
API de Categorias - Listar y filtrar categorias
API de Busqueda - Busqueda de texto completo

Ejemplos Rapidos

Listar Skills

bash

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

Buscar Skills

bash

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

Obtener Detalles de Skill

bash

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

Listar Categorias

bash

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

SDKs

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

Suscribete a eventos para actualizaciones en tiempo real:

skill.created - Nueva skill agregada
skill.updated - Contenido de skill actualizado
skill.deleted - Skill eliminada

Contactanos para acceso a webhooks.

Soporte

GitHub Issues
Email: api@skillsmp.com