# Hermes

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

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

`hermes-search1api` 是一个原生的 [Hermes Agent](https://github.com/NousResearch/hermes-agent) 插件，通过 Search1API 为 Hermes 提供实时网络访问——网页搜索、智能搜索、新闻搜索、可读页面获取、站点地图发现和热门话题。

它将这些能力注册为**一等 Hermes 工具**（`search1api_*`），既不是替换 Hermes 内置 `web_search` 后端的方案，也不是 MCP 桥接。

该插件已收录在 [Hermes 官方插件目录](https://hermes-agent.nousresearch.com/docs/plugins/search1api)中（[NousResearch/hermes-agent#115529](https://github.com/NousResearch/hermes-agent/pull/115529)）。Hermes Agent v0.21.4（v2026.9.21）是首个内置该条目的版本；v0.21.2（v2026.9.11）及之后的版本也会实时读取目录，因此无需升级即可按名称安装。

> **info:** 内置的 Skill（`plugin:search1api`）会告诉 Agent 何时搜索、何时读取 URL，以及快速查询和深度研究分别适合哪些过滤条件。使用 `skill_view("plugin:search1api")` 加载它。

## 安装

```bash
hermes plugins install search1api --enable
export SEARCH1API_KEY="your-key"
```

按目录名称安装时，会检出经 Nous 审核的确切提交（当前为 0.1.0，位于 `14c86174`）。之后如需获取更新的已审核版本，运行 `hermes plugins update search1api`。

`hermes plugins install superagents-lab/hermes-search1api` 仍然可用，但 Hermes 会将其视为未经审核的自定义来源，并安装仓库的最新提交。

也可以使用 `SEARCH1API_API_KEY`。将密钥放在 `~/.hermes/.env` 或 shell 环境中。

官方 [`search1api` Python SDK](https://pypi.org/project/search1api/) 已内嵌（vendored）在插件中。它唯一的运行时依赖（`httpx`）已包含在 Hermes 中。

## Agent 能做什么

| 工具 | 作用 |
| --- | --- |
| `search1api_search` | 实时网页搜索，支持 `time_range`、`include_sites` / `exclude_sites`、`search_service` 以及可选的 `crawl_results` |
| `search1api_ask` | 只需 `query` 的智能搜索（5 积分，45 秒超时） |
| `search1api_news` | 新闻搜索，支持相同的过滤条件 |
| `search1api_crawl` | 将单个公开 URL 读取为干净的 Markdown |
| `search1api_sitemap` | 列举网站的 URL |
| `search1api_trending` | GitHub 热门仓库或 Hacker News 热门文章 |

所有工具都返回 JSON。错误以 `{"success": false, "error": {"type", "message", "status_code?"}}` 的形式返回。

## 凭据

1. 在 [Search1API 仪表盘](https://app.s1.dev)中创建密钥。
2. 将其导出为 `SEARCH1API_KEY`（或 `SEARCH1API_API_KEY`）。

`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/hermes-search1api](https://github.com/superagents-lab/hermes-search1api)