SkillsMP 客户端

SkillsMP 技能市场 API 的客户端。程序化搜索、筛选和发现 AI 智能体技能。

配置

获取 API 密钥

如果你还没有 API 密钥，请前往 https://skillsmp.com/docs/api 注册并获取 API 密钥。

使用方法

只需将获取到的 API 密钥提供给我，我会自动处理后续所有操作（环境变量设置、API 调用等），你无需手动配置。

API 密钥存储

为了持久化保存 API 密钥，建议将密钥写入 TOOLS.md 文件：

### SkillsMP
- API Key: sk_live_skillsmp_...

这样每次启动时我都能自动读取，无需重复提供。

API 端点

搜索技能（关键词）

通过关键词搜索技能，支持可选筛选条件。

端点： GET /api/v1/skills/search

参数：

名称	类型	必填	说明
q	string	✅	搜索关键词
page	number	-	页码（默认：1）
limit	number	-	每页结果数（默认：20，最大：100）
sortBy	string	-	排序：stars（星标）| recent（最近）（默认：recent）
category	string	-	按分类别名筛选
occupation	string	-	按 SOC 职业别名筛选

示例：

# 基础搜索
curl -X GET "https://skillsmp.com/api/v1/skills/search?q=technical-docs" \
  -H "Authorization: Bearer $SKILLSMP_API_KEY"

# 带筛选条件
curl -X GET "https://skillsmp.com/api/v1/skills/search?q=automation&sortBy=stars&limit=10" \
  -H "Authorization: Bearer $SKILLSMP_API_KEY"

AI 语义搜索

使用由 Cloudflare AI 驱动的语义搜索，通过意图/描述查找技能。

端点： GET /api/v1/skills/ai-search

参数：

名称	类型	必填	说明
q	string	✅	AI 搜索查询（自然语言）

示例：

curl -X GET "https://skillsmp.com/api/v1/skills/ai-search?q=How+to+create+a+web+scraper" \
  -H "Authorization: Bearer $SKILLSMP_API_KEY"

响应格式

成功响应

{
  "success": true,
  "data": {
    "skills": [
      {
        "id": "author-repo-path-skill-md",
        "name": "skill-name",
        "author": "github-username",
        "description": "Skill description...",
        "githubUrl": "https://github.com/...",
        "skillUrl": "https://skillsmp.com/skills/...",
        "stars": 100,
        "updatedAt": "1774171736"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 50,
      "totalPages": 3,
      "hasNext": true,
      "hasPrev": false
    }
  },
  "meta": {
    "requestId": "...",
    "responseTimeMs": 7
  }
}

错误响应

{
  "success": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "提供的 API 密钥无效"
  }
}

错误代码

代码	HTTP	说明
MISSING_API_KEY	401	未提供 API 密钥。请前往 https://skillsmp.com/docs/api 获取 API 密钥
INVALID_API_KEY	401	API 密钥无效。请检查密钥或前往 https://skillsmp.com/docs/api 重新获取
MISSING_QUERY	400	缺少必需的查询参数
DAILY_QUOTA_EXCEEDED	429	超出每日 API 限制（500次/天）
INTERNAL_ERROR	500	服务器错误

速率限制

• 每日限制： 每个 API 密钥 500 次请求
• 重置时间： UTC 午夜
• 其他限制：
  • 不支持通配符搜索（如 *）
• 响应头： 响应包含速率限制信息：
  • X-RateLimit-Daily-Limit: 500
  • X-RateLimit-Daily-Remaining: 499

自然语言命令

命令	操作
"在 skillsmp 上搜索 [关键词]"	关键词搜索
"在 skillsmp 上查找关于 [主题] 的技能"	AI 语义搜索
"列出 skillsmp 上的热门技能"	按星标排序搜索
"获取 [技能-id] 的详细信息"	获取技能信息

使用示例

关键词搜索

在 skillsmp 上搜索文档相关的技能

AI 语义搜索

在 skillsmp 上查找关于网页抓取的技能

带筛选的搜索

在 skillsmp 上搜索自动化技能，按星标排序

分类与职业

分类（category）和职业（occupation）筛选支持多种值，具体可用值请前往 https://skillsmp.com/zh/docs/api 查看。

参考链接

• SkillsMP: https://skillsmp.com