Hermes
通过原生 hermes-search1api 插件，为 Hermes Agent 提供实时网页搜索、智能搜索、新闻、页面读取、站点地图发现和热门话题。
hermes-search1api 是一个原生的 Hermes Agent 插件，通过 Search1API 为 Hermes 提供实时网络访问——网页搜索、智能搜索、新闻搜索、可读页面获取、站点地图发现和热门话题。
它将这些能力注册为一等 Hermes 工具（search1api_*），既不是替换 Hermes 内置 web_search 后端的方案，也不是 MCP 桥接。
该插件已收录在 Hermes 官方插件目录中（NousResearch/hermes-agent#115529）。Hermes Agent v0.21.4（v2026.9.21）是首个内置该条目的版本；v0.21.2（v2026.9.11）及之后的版本也会实时读取目录，因此无需升级即可按名称安装。
内置的 Skill（plugin:search1api）会告诉 Agent 何时搜索、何时读取 URL，以及快速查询和深度研究分别适合哪些过滤条件。使用 skill_view("plugin:search1api") 加载它。
安装
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 已内嵌（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?"}} 的形式返回。
凭据
- 在 Search1API 仪表盘中创建密钥。
- 将其导出为
SEARCH1API_KEY（或SEARCH1API_API_KEY）。
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 描述实际执行的请求。这些路径
适用于搜索/新闻；热门保持其独立的响应结构。