skillsmp-searcher

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

SkillsMP 技能搜索

SkillsMP Skill Search

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

This tool provides search functionality for the SkillsMP Skill Marketplace, helping users quickly discover and locate the skills they need.

API 配置

API Configuration

首次使用前，需要配置 API Key。支持三种配置方式（按优先级排序）：

环境变量（推荐）：设置
```
SKILLSMP_API_KEY
```
环境变量
开发密钥文件：创建
```
references/api_key_real.txt
```
（已在 .gitignore 中）
模板文件：编辑
```
references/api_key.txt
```

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

sk_live_skillsmp_eb_6A4Y9LJAhtzPFsmX0v67zhingVC0CrQZ4Qqlin4

）

注意：

```
api_key_real.txt
```
已加入 .gitignore，不会被提交到公共仓库
请勿将包含真实 API Key 的文件提交到公共仓库
文件支持
```
#
```
开头的注释行，会自动跳过

Before first use, you need to configure the API Key. Three configuration methods are supported (sorted by priority):

Environment variable (recommended): Set the
```
SKILLSMP_API_KEY
```
environment variable
Development key file: Create
```
references/api_key_real.txt
```
(already in .gitignore)
Template file: Edit
```
references/api_key.txt
```

Format: Plain text API Key string (e.g.,

sk_live_skillsmp_eb_6A4Y9LJAhtzPFsmX0v67zhingVC0CrQZ4Qqlin4

)

Notes:

```
api_key_real.txt
```
has been added to .gitignore and will not be committed to public repositories
Do not commit files containing real API Keys to public repositories
Files support comment lines starting with
```
#
```
, which will be automatically skipped

搜索模式

Search Modes

1. 关键词搜索

1. Keyword Search

使用

scripts/search_skills.py

进行基于关键词的搜索。

适用场景：

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

参数：

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

示例：

bash

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

Use

scripts/search_skills.py

for keyword-based search.

Applicable scenarios:

Users search with clear keywords (e.g., "SEO", "PDF", "translation")
Need to sort by popularity or latest time
Need to browse results by pages

Parameters:

```
q
```
(required): Search keyword
```
page
```
: Page number, default 1
```
limit
```
: Number of items per page, default 20, maximum 100
```
sortBy
```
: Sort method,
```
stars
```
(popular, default) or
```
recent
```
(latest)

Example:

bash

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

2. AI 语义搜索

2. AI Semantic Search

使用

scripts/ai_search.py

进行基于语义理解的搜索。

适用场景：

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

参数：

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

示例：

bash

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

Use

scripts/ai_search.py

for semantic understanding-based search.

Applicable scenarios:

Users describe needs in natural language (e.g., "how to make videos", "help me process PDF documents")
Search intent is complex and requires context understanding
Unsure of specific keywords, hoping for AI intelligent matching

Parameters:

```
q
```
(required): Natural language search query

Example:

bash

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

3. 一键安装技能

3. One-click Skill Installation

使用

scripts/install_skill.py

搜索并安装技能。

适用场景：

用户搜索到技能后直接安装
从URL直接安装技能文件
管理已安装的技能

命令：

```
install
```
[query] [--index N]: 搜索并安装第N个技能（默认第1个）
```
install
```
[url/path]: 直接从URL或本地路径安装
```
list
```
: 列出所有已安装的技能

示例：

bash

undefined

Use

scripts/install_skill.py

to search and install skills.

Commands:

```
install
```
[query] [--index N]: Search and install the Nth skill (default 1st)
```
install
```
[url/path]: Install directly from URL or local path
```
list
```
: List all installed skills

Examples:

bash

undefined

搜索并安装第一个结果

Search and install the first result

python scripts/install_skill.py install "视频编辑"

搜索并安装指定索引的技能

Search and install the skill at specified index

python scripts/install_skill.py install "PDF" --index 2

从URL直接安装

Install directly from URL

python scripts/install_skill.py install "https://example.com/skill.skill"

从本地文件安装

Install from local file

python scripts/install_skill.py install "/path/to/skill.skill"

列出已安装的技能

List installed skills

python scripts/install_skill.py list


**功能**：
- 自动解压并安装技能到Claude Code技能目录
- 支持从URL或本地文件安装
- 列出已安装的所有技能

python scripts/install_skill.py list


**Features**:
- Automatically extract and install skills to Claude Code skill directory
- Support installation from URL or local file
- List all installed skills

4. 查看技能详情

4. View Skill Details

使用

scripts/skill_info.py

查看特定技能的详细信息。

适用场景：

需要了解技能的完整信息
查看技能的版本、作者、评分、标签
获取技能的使用示例和安装命令

参数：

```
skill_id
```
(必需): 技能ID或名称
```
--json
```
: 输出原始JSON格式
```
--api-key
```
: 自定义API密钥

示例：

bash

undefined

Use

scripts/skill_info.py

to view detailed information of specific skills.

Applicable scenarios:

Need to understand complete information of a skill
View skill version, author, rating, tags
Obtain skill usage examples and installation commands

Parameters:

```
skill_id
```
(required): Skill ID or name
```
--json
```
: Output in raw JSON format
```
--api-key
```
: Custom API key

Examples:

bash

undefined

查看技能详细信息

View detailed skill information

python scripts/skill_info.py "pdf-processor"

以JSON格式输出

Output in JSON format

python scripts/skill_info.py "video-editor" --json


**显示内容**：
- 技能名称、作者、星级评分
- 版本号和详细描述
- 分类标签
- 仓库链接和安装命令
- 依赖要求
- 使用示例

python scripts/skill_info.py "video-editor" --json


**Display content**:
- Skill name, author, star rating
- Version number and detailed description
- Category tags
- Repository link and installation command
- Dependency requirements
- Usage examples

5. 检查技能更新

5. Check Skill Updates

使用

scripts/check_updates.py

检查已安装技能的更新。

适用场景：

定期检查已安装技能是否有新版本
获取最新版本的版本号和评分
决定是否需要更新技能

参数：

```
--force
```
: 强制检查（忽略缓存）
```
--json
```
: 输出JSON格式
```
--api-key
```
: 自定义API密钥

示例：

bash

undefined

Use

scripts/check_updates.py

to check for updates of installed skills.

Applicable scenarios:

Regularly check if installed skills have new versions
Obtain the version number and rating of the latest version
Decide whether to update skills

Parameters:

```
--force
```
: Force check (ignore cache)
```
--json
```
: Output in JSON format
```
--api-key
```
: Custom API key

Examples:

bash

undefined

检查所有已安装技能的更新

Check updates for all installed skills

python scripts/check_updates.py

强制检查（绕过1小时缓存）

Force check (bypass 1-hour cache)

python scripts/check_updates.py --force

以JSON格式输出

Output in JSON format

python scripts/check_updates.py --json


**功能**：
- 自动扫描Claude Code技能目录
- 对比本地版本与SkillsMP商城最新版本
- 智能缓存机制（1小时内不重复检查）
- 显示可更新技能的升级路径和安装命令

python scripts/check_updates.py --json


**Features**:
- Automatically scan Claude Code skill directory
- Compare local version with the latest version in SkillsMP Marketplace
- Intelligent caching mechanism (no repeated checks within 1 hour)
- Display upgrade path and installation command for updatable skills

API 端点

API Endpoints

详细的 API 文档请参考

references/api_documentation.md

。

基础 URL:

https://skillsmp.com/api/v1

端点	方法	功能
`/skills/search`	GET	关键词搜索
`/skills/ai-search`	GET	AI 语义搜索

For detailed API documentation, please refer to

references/api_documentation.md

Base URL:

https://skillsmp.com/api/v1

Endpoint	Method	Function
`/skills/search`	GET	Keyword search
`/skills/ai-search`	GET	AI semantic search

错误处理

Error Handling

API 错误码：

错误码	HTTP状态	说明
`MISSING_API_KEY`	401	未提供 API Key
`INVALID_API_KEY`	401	API Key 无效
`MISSING_QUERY`	400	缺少必需的查询参数
`INTERNAL_ERROR`	500	服务器内部错误

错误响应格式：

json

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

API error codes:

Error Code	HTTP Status	Description
`MISSING_API_KEY`	401	API Key not provided
`INVALID_API_KEY`	401	Invalid API Key
`MISSING_QUERY`	400	Required query parameter missing
`INTERNAL_ERROR`	500	Internal server error

Error response format:

json

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

使用流程

Usage Flow

搜索和安装技能：

确保 API Key 已配置（优先使用环境变量
```
SKILLSMP_API_KEY
```
）
根据需求选择搜索模式：
- 明确关键词 → 关键词搜索（
```
search_skills.py
```
  ）
- 自然语言描述 → AI 语义搜索（
```
ai_search.py
```
  ）

搜索后可直接安装：

使用索引安装：

install_skill.py install "关键词" --index N

从URL直接安装：
```
install_skill.py install "URL"
```

管理已安装技能：

列出已安装技能：
```
install_skill.py list
```
查看技能详情：
```
skill_info.py "技能名"
```
检查更新：
```
check_updates.py
```

注意事项：

首次使用必须配置 API Key
搜索结果默认按热门度排序
技能安装到
```
~/.claude/skills/
```
或系统对应的技能目录
更新检查有1小时缓存，使用
```
--force
```
可绕过

Search and Install Skills:

Ensure API Key is configured (prefer using environment variable
```
SKILLSMP_API_KEY
```
)
Select search mode based on needs:
- Clear keywords → Keyword search (
```
search_skills.py
```
  )
- Natural language description → AI semantic search (
```
ai_search.py
```
  )
Install directly after search:
- Install using index:
```
install_skill.py install "keyword" --index N
```
- Install directly from URL:
```
install_skill.py install "URL"
```

Manage Installed Skills:

List installed skills:
```
install_skill.py list
```
View skill details:
```
skill_info.py "skill name"
```
Check for updates:
```
check_updates.py
```

Notes:

API Key must be configured for first use
Search results are sorted by popularity by default
Skills are installed to
```
~/.claude/skills/
```
or the corresponding system skill directory
Update check has a 1-hour cache, use
```
--force
```
to bypass