# OpenCode

> 通过原生 opencode-search1api 插件，为 OpenCode 提供实时网页搜索、智能搜索、新闻、页面读取、站点地图发现和热门话题。

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

`opencode-search1api` 是一个原生 OpenCode 插件，通过 Search1API 为 Agent 提供实时网络访问——网页搜索、智能搜索、新闻搜索、可读页面获取、站点地图发现和热门话题。

与 MCP 桥接不同，该插件将这些能力注册为**一等 OpenCode 工具**。

## 安装

为当前项目安装：

```bash
opencode plugin opencode-search1api
```

或全局安装：

```bash
opencode plugin opencode-search1api --global
```

## 认证

使用以下任一方式：

1. 在 OpenCode 的环境中设置 `SEARCH1API_KEY`。
2. 安装 `search1api-cli` 并运行一次 `s1 login`；插件会复用同一个 OAuth 会话。
3. 在 `opencode.json` 中传入 `apiKey`：

```json
{
  "plugin": [
    ["opencode-search1api", { "apiKey": "your-api-key" }]
  ]
}
```

优先使用环境变量或密钥管理工具，不要把凭据提交到代码仓库。如需密钥，请在 [Search1API 仪表盘](https://app.s1.dev)中创建。

## Agent 能做什么

| 工具 | 作用 |
| --- | --- |
| `search1api_search` | 实时网页搜索 |
| `search1api_ask` | 只需 `query` 的智能搜索（5 积分，45 秒超时） |
| `search1api_news` | 新闻搜索 |
| `search1api_crawl` | 将公开 URL 读取为干净的 Markdown |
| `search1api_sitemap` | 列举网站的 URL |
| `search1api_trending` | GitHub 热门仓库或 Hacker News 热门文章 |

`search1api_ask` 只接受 `query`（1-500 个字符）。其响应会保留
`query`、`intent`、结果的 `source` 和 `relevance`，以及可选的 `errors`。
参见[智能搜索](https://s1.dev/zh/docs/basic/ask)。

## 积分

搜索和新闻请求每次消耗 1 积分；抓取页面时，每个成功抓取的页面额外消耗 1 积分。智能搜索每次请求消耗 5 积分。新账户无需信用卡即可获得 100 积分。当前费率参见[积分与限制](https://s1.dev/zh/docs/essentials/credits-and-limits)。

## 搜索过滤条件与结果字段

**0.2.0** 版本支持全部 19 个[搜索引擎](https://s1.dev/zh/docs/basic/search)和全部 6 个
[新闻来源](https://s1.dev/zh/docs/basic/news)，包括 Bing China、Yandex、Grokipedia 和 Reuters。
`time_range` 支持 `day`、`week`、`month` 和 `year`；`page` 支持搜索
分页。这些过滤条件适用于搜索/新闻；智能搜索只接受 `query`。

引擎特有的结果字段位于可选的 `metadata` 中：GitHub 搜索提供
`metadata.kind`、`metadata.stars`、`metadata.language` 和 `metadata.num_comments`；
Hacker News 搜索提供 `metadata.story_url`、`metadata.points` 和
`metadata.num_comments`。可选的 `published_date` 保留在结果顶层。
响应级的 `searchParameters` 描述实际执行的请求。这些路径
适用于搜索/新闻；[热门](https://s1.dev/zh/docs/advanced/trending)保持其独立的响应结构。

## 源码

[github.com/superagents-lab/opencode-search1api](https://github.com/superagents-lab/opencode-search1api)