mcpField
S
skillsmp-searcher

skillsmp-searcher

github.com/gccszsAgent 工作流337 次安装37 周前更新
代码仓库

关于 skillsmp-searcher

skillsmp-searcher 是用于搜索 SkillsMP 技能商城的 Agent 技能，面向需要发现技能的用户。它支持关键词筛选和 AI 语义搜索，并可按热度或最近时间排序、分页查看结果。

主要功能

  1. 01关键词搜索与排序
  2. 02AI 语义搜索
  3. 03分页浏览搜索结果
  4. 04通过 API Key 访问

适用场景

  1. 01按 SEO、PDF 等词查找技能
  2. 02用自然语言描述需求来搜索
  3. 03按热度或更新时间浏览结果

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/gccszs/skillsmp-searcher --skill skillsmp-searcher

安装后在 Claude Code 中输入/skillsmp-searcher确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

.env.example
README.md
pytest.ini
pyproject.toml
LICENSE
README_CN.md
.gitignore
requirements.txt
.github/workflows/
cd.yml
ci.yml
references/
api_documentation.md
api_key.txt
scripts/
ai_search.py
search_skills.py
skills/skillsmp-searcher/
.gitignore
README.md
LICENSE
skills/skillsmp-searcher/references/
api_documentation.md
api_key.txt
skills/skillsmp-searcher/scripts/
ai_search.py
check_updates.py
search_skills.py
skill_downloader.py
install_skill.py
skill_diff.py
skill_info.py
utils.py
tests/
__init__.py
conftest.py
test_units.py

详细介绍

来自项目 README

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

端点方法功能
/skills/searchGET关键词搜索
/skills/ai-searchGETAI 语义搜索

错误处理

API 错误码：

错误码HTTP状态说明
MISSING_API_KEY401未提供 API Key
INVALID_API_KEY401API Key 无效
MISSING_QUERY400缺少必需的查询参数
INTERNAL_ERROR500服务器内部错误

错误响应格式：

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

使用流程

  1. 确保 API Key 已配置在 references/api_key.txt
  2. 根据用户需求选择搜索模式：
    • 明确关键词 → 关键词搜索
    • 自然语言描述 → AI 语义搜索
  3. 运行相应的脚本获取结果
  4. 解析并展示搜索结果给用户

评论

支持 Markdown