Search1API文档

OpenCode

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

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

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

安装

为当前项目安装:

opencode plugin opencode-search1api

或全局安装:

opencode plugin opencode-search1api --global

认证

使用以下任一方式:

  1. 在 OpenCode 的环境中设置 SEARCH1API_KEY。
  2. 安装 search1api-cli 并运行一次 s1 login;插件会复用同一个 OAuth 会话。
  3. 在 opencode.json 中传入 apiKey:
{
  "plugin": [
    ["opencode-search1api", { "apiKey": "your-api-key" }]
  ]
}

优先使用环境变量或密钥管理工具,不要把凭据提交到代码仓库。如需密钥,请在 Search1API 仪表盘中创建。

Agent 能做什么

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

search1api_ask 只接受 query(1-500 个字符)。其响应会保留 query、intent、结果的 source 和 relevance,以及可选的 errors。 参见智能搜索。

积分

搜索和新闻请求每次消耗 1 积分;抓取页面时,每个成功抓取的页面额外消耗 1 积分。智能搜索每次请求消耗 5 积分。新账户无需信用卡即可获得 100 积分。当前费率参见积分与限制。

搜索过滤条件与结果字段

0.2.0 版本支持全部 19 个搜索引擎和全部 6 个 新闻来源,包括 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 描述实际执行的请求。这些路径 适用于搜索/新闻;热门保持其独立的响应结构。

源码

github.com/superagents-lab/opencode-search1api

本页内容