skillsmp-searcher（技能搜索器）

SkillsMP 技能搜索

此技能提供对 SkillsMP 技能商城的搜索功能，帮助用户快速发现和定位所需的技能。

API 配置

首次使用前，需要配置 API Key。API Key 存储在 references/api_key.txt 中。

格式：纯文本的 API Key 字符串（例如：sk_live_skillsmp_eb_6A4Y9LJAhtzPFsmX0v67zhingVC0CrQZ4Qqlin4）

注意：请确保 API Key 安全，不要将 SKILL.md 或包含 API Key 的文件提交到公共仓库。

搜索模式

1. 关键词搜索

使用 scripts/search_skills.py 进行基于关键词的搜索。

适用场景：

• 用户使用明确的关键词搜索（如 "SEO"、"PDF"、"翻译"）
• 需要按热门度或最新时间排序
• 需要分页浏览结果

参数：

• q (必需): 搜索关键词
• page: 页码，默认 1
• limit: 每页数量，默认 20，最大 100
• sortBy: 排序方式，stars（热门，默认）或 recent（最新）

示例：

python scripts/search_skills.py "SEO" --page 1 --limit 10 --sortBy stars

2. AI 语义搜索

使用 scripts/ai_search.py 进行基于语义理解的搜索。

适用场景：

• 用户使用自然语言描述需求（如"如何制作视频"、"帮我处理PDF文档"）
• 搜索意图复杂，需要理解上下文
• 不确定具体关键词，希望AI智能匹配

参数：

• q (必需): 自然语言搜索查询

示例：

python scripts/ai_search.py "How to create a web scraper"

API 端点

详细的 API 文档请参考 references/api_documentation.md。

基础 URL: https://skillsmp.com/api/v1

错误处理

API 错误码：

错误响应格式：

{
  "success": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "The provided API key is invalid"
  }
}

使用流程

1. 确保 API Key 已配置在 references/api_key.txt
2. 根据用户需求选择搜索模式：

- 明确关键词 → 关键词搜索 - 自然语言描述 → AI 语义搜索

1. 运行相应的脚本获取结果
2. 解析并展示搜索结果给用户