# Agent Skills

> 使用 Search1API Claude 插件内置的 Search1API Agent Skill，或为终端 Agent 安装独立的 CLI Skill。

Canonical URL: https://s1.dev/zh/docs/integrations/skills

MCP 服务器提供 Agent 可以调用的工具。Skill 则提供指导：如何选择这些工具、如何阅读来源，以及如何附带引用作答。Search1API 在已发布的 Claude 插件中附带了一个 Skill，另外还为使用 `s1` CLI 的 Agent 提供了一个独立的 Skill。

## 安装

### Claude 插件

对于 Claude 应用、Cowork 和 Claude Code，请[安装 Search1API 插件](https://claude.ai/customize/plugins/id/c73feffb-aae4-49f4-8515-24322b313989%40anthropic-plugin-directory)。你也可以在 **Customize → Plugins → Discover** 中搜索 **Search1API** 找到它。已发布的插件内置一个 Agent Skill 以及五个远程 MCP 工具。添加插件后，通过 OAuth 连接 Search1API。插件需要付费的 Claude 套餐。

如果只需要这五个工具而不需要内置 Skill，请[添加 Search1API 连接器](https://claude.ai/directory/search1api)。安装步骤和 Claude Code 账户同步参见 [Claude 指南](https://s1.dev/zh/docs/integrations/claude)，手动配置参见 [MCP 设置](https://s1.dev/zh/docs/integrations/mcp)。

### 独立 CLI Skill

适用于使用 `s1` CLI 的终端 Agent：

```bash
npm install -g search1api-cli
npx skills add superagents-lab/search1api-cli
s1 login
```

这个独立 Skill 通过 `s1` CLI 工作，因此需要先安装并登录 CLI。如果尚未完成，Skill 会引导用户完成。Claude 插件则直接使用 MCP 工具。

## Skill 提供的指导

两个 Skill 都会指导 Agent 根据请求调整联网方式：

- 用 `crawl` 读取用户分享的 URL。
- 快速查询时只取少量结果；研究型问题则搜索得更广，并读取相关页面的全文。
- 对“最新”“今天”这类请求应用时间过滤。
- 组合使用多个工具来完成研究、URL 总结和热门话题探索。
- 综合结果并引用来源 URL。

Claude 插件 Skill 使用 `max_results`、`time_range` 等 MCP 参数；独立 Skill 使用 `-n`、`-t` 等 CLI 参数。

## 使用方式

安装完成后，像平常一样和 Agent 对话即可：

- “搜索最新的 AI 新闻”
- “https://example.com 这个链接讲了什么？”
- “GitHub 上现在什么最热门？”
- “深入研究一下量子计算”

Claude 或你的 Agent 会依据 Skill 的指导选择工具或命令、搜索服务、结果数量，以及是否读取页面。

## 费用

两个 Skill 与直接调用 API 一样，消耗同一 Search1API 账户的积分。Skill 本身不额外收取 Search1API 费用；搜索次数越多、读取页面越多的工作流消耗的积分也越多。参见[积分与限制](https://s1.dev/zh/docs/essentials/credits-and-limits)。

来源：[Claude 插件 Skill](https://github.com/superagents-lab/search1api-mcp/tree/main/claude-plugin/skills/search1api) · [独立 CLI Skill](https://github.com/superagents-lab/search1api-cli/tree/master/skills/search1api)