mcpField
S
skillsmp-searcher

skillsmp-searcher

github.com/gccszsエージェントワークフロー337 回インストール37 週間前に更新
リポジトリ

skillsmp-searcher について

skillsmp-searcher は、SkillsMP のスキルマーケットを検索するエージェントスキルです。キーワード検索と AI セマンティック検索に対応し、キーワード検索では並べ替えやページ送りもできます。

主な機能

  1. 01キーワード検索と並べ替え
  2. 02AI セマンティック検索
  3. 03検索結果のページ送り
  4. 04API Key によるアクセス

活用シーン

  1. 01SEO や 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 対応