Web Search Plus for Hermes
为 Hermes 提供多源网页搜索与正文提取,并保留真实来源。
- Star 数
- ★ 445
- 最近更新
- 10 天前
- License
- MIT
- 主语言
- Python
- FA 评分
- 78/100 · 表现良好
30 秒速览
- 运行形态
- 可在哪里用
- 平台专用
- 费用
- 免费,无需付费服务
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 使用 Hermes Agent 调研近期事件的研究者,需要结果直接附带可核查的原始网页。
- 不适合
- 不使用 Hermes Agent 的团队
- 需要完全离线研究的用户
- 要求所有提供商自动参与路由的团队
- 官网
- websearchplus.xyz ↗ 来自 GitHub 仓库设置
- 维护状态
- 近 30 天有提交最近提交 2026-11-10最新版本 v5.1.9(2026-11-10)
- 源码审查
- 78/100 · 表现良好
这个 Agent 能做什么,适合哪些场景?
Web Search Plus 是面向 Hermes Agent 插件 API 的网页搜索与页面提取插件,当前 README 标注版本为 v4.3.3。它注册 web_search_plus 和 web_extract_plus 两个工具,分别用于发现带原始链接的搜索结果,以及清理已有 URL 的页面正文。搜索引擎可在多个提供商之间进行路由和故障切换,并能使用 SearXNG、Keenable 或另行安装的 DonSeTch 等本地或免付费密钥选项。核心插件要求 Python 3.10+,通过 Hermes 插件命令安装,并在 Hermes 环境文件中保存提供商密钥。DonSeTch 以独立的 stdio MCP 进程运行且不随插件捆绑;Jev、Octen 和 TinyFish 等能力也都是有明确边界的可选集成。
一次搜索从 web_search_plus 接收查询以及可选的提供商、时效、区域、语言、域名、缓存和研究模式参数,再调用已配置的搜索服务,返回带标题、摘要和原始 URL 的来源;自动模式可在服务失败或无结果时尝试其他提供商。路由器能够记录提供商样本并使用 provider_stats.json 调整选择,搜索缓存支持 no_cache 与 cache_ttl。拿到 URL 后,web_extract_plus 会验证地址、调用选定的提取服务并生成清理后的页面文本;HTTP 路径限制响应大小,并只允许同源重定向。可选的 DonSeTch 适配器通过 DONSETCH_BIN 启动单独安装的 stdio MCP 程序,完成显式指定的搜索或 Markdown 提取。插件还提供 setup.py 状态检查与配置向导、命令行搜索测试,以及可选的 wsp 后端,把 Hermes 原生 web_search 和 web_extract 调用转入同一引擎。
- 使用 Hermes Agent 调研近期事件的研究者,需要结果直接附带可核查的原始网页。
- 已经收集一批 URL 的分析人员,希望把页面转换为更适合代理读取的干净正文。
- 担心单一搜索 API 故障的团队,希望配置多个提供商并获得受控的路由与回退。
- 有自建 SearXNG 的团队,希望结合 SearXNG 与免密钥 Keenable,降低对商业搜索 API 的依赖。
- 需要本地来源检索或 Markdown 提取的 Hermes 用户,愿意单独安装并显式调用 DonSeTch。
- 插件维护者或运营人员,需要通过质量报告、状态命令和缓存控制排查搜索链路。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
npm install -g [email protected]
- 环境变量
MONID_API_KEYTINYFISH_API_KEY- 配置文件
~/.hermes/plugins/web-search-plus/setup.pyconfig.json~/.hermes/plugins/web-search-plus- 运行环境
- Python 3.10+
如何安装或部署这个 Agent?
需要 Hermes Agent 与 Python 3.10+。先安装并启用插件:
hermes plugins install robbyczgw-cla/hermes-web-search-plus --enable检查提供商状态并运行入门配置:
python3 ~/.hermes/plugins/web-search-plus/setup.py status
python3 ~/.hermes/plugins/web-search-plus/setup.py setup --preset starter至少配置一个支持搜索的密钥或本地端点;提取工具同样需要一个支持提取的密钥或端点。配置助手把密钥写入当前 Hermes 环境文件,而不是 config.json。完成后重启 Hermes CLI,或在会话内执行 /reset;Gateway 用户执行 /restart 后再执行 /reset。
无商业 API 密钥的配置可使用自托管预设,但需要自己的 SearXNG 实例;该预设还启用 Keenable 的公共提取层:
python3 ~/.hermes/plugins/web-search-plus/setup.py setup --preset self-hosted
python3 ~/.hermes/plugins/web-search-plus/setup.py statusDonSeTch 并未捆绑。如需使用,应另行安装已测试版本并把 DONSETCH_BIN 指向其绝对可执行文件路径:
npm install -g [email protected]如何使用这个 Agent?
重新加载 Hermes 后,可以直接调用两个已注册工具。搜索并保留来源链接:
web_search_plus(query="Hermes Agent latest release")
web_search_plus(query="compare recent open-source agent frameworks", mode="research", quality_report=True)读取已有页面并提取干净正文:
web_extract_plus(urls=["https://example.com"])
web_extract_plus(urls=["https://docs.example.com"], provider="linkup", render_js=False)也可以先在插件目录进行命令行冒烟测试:
cd ~/.hermes/plugins/web-search-plus
python3 search.py --query "Hermes Agent latest release" --provider auto --quality-reportOcten、TinyFish 与 DonSeTch 默认不会加入自动路由或回退,需显式选择。例如 Octen 需要 MONID_API_KEY:
web_search_plus(query="recent vector database research", provider="octen", freshness="month")TinyFish 需要用户自己的 TINYFISH_API_KEY:
web_search_plus(query="recent agent framework releases", provider="tinyfish", freshness="week")这个 Agent 有哪些优点和局限?
- 把 15 个搜索提供商和 9 个提取提供商收敛到两个 Hermes 工具中,只配置一个可用提供商即可启动相应工具。
- 输出保留原始 URL,而不是只给出生成式答案,适合需要来源核查的研究流程。
- 支持自动路由、失败回退、缓存控制、质量报告和提供商统计,能减少单一服务不可用造成的中断。
- 提供 SearXNG、Keenable 和独立 DonSeTch 路径,可减少对付费搜索 API 的依赖。
- 提取链路包含严格 URL 验证、同源重定向、响应大小限制以及不可信网页数据提示。
- 核心交付形式是 Hermes Agent 插件;来源没有记录 ChatGPT、Codex、Claude 或其 API 的原生集成。
- 实际可用性取决于外部搜索或提取端点;自托管配置仍需 SearXNG,Keenable 公共层有速率限制且没有 SLA。
- 提供商隐私条款并不一致;TinyFish 标准条款允许将客户数据用于模型训练,敏感查询需要额外审查。
- DonSeTch、Jev 及其依赖均不捆绑,需要分别安装和配置;DonSeTch 默认只能显式调用。
- 从旧 Hound 集成升级到 4.0 及更高版本需要迁移,因为 Hound 已被移除并由 DonSeTch 路径取代。
这个 Agent 与同类方案有什么区别?
与 Hermes 原生 web_search 和 web_extract 相比,Web Search Plus 增加了多提供商引擎、回退、缓存和质量报告;可选 wsp 后端能将原生调用转入这套引擎,但安装插件不会自动选用该后端。仓库还指向 TypeScript/OpenClaw 版本 web-search-plus-plugin,而本仓库是针对 Hermes Agent 插件 API 的 Python 版本。DonSeTch 不是捆绑替代品,而是独立的 AGPL-3.0-only 本地 MCP 程序,Web Search Plus 仅通过单独的 stdio 进程与它集成。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Web Search Plus for Hermes 当前 | 78 · 表现良好 | Agent 插件 / 技能免费 | ★ 445 | 10 天前 | Python | — |
| BambooAI 数据分析师 | 70 · 存在缺口 | 网页应用免费 + 模型费 | ★ 848 | 1 天前 | Python | OpenAI API · Claude API |
| MiroThinker | 45 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 8.5k | 8 个月前 | Python | OpenAI API · Claude API |
| 通义深度研究 | 44 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 20k | 8 个月前 | Python | — |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
README、FAQ 和 DonSeTch 指南路径说明查询与 URL 会发送给所选外部服务或本地 sidecar,并明确提醒不同服务的隐私条款不一,也说明结果会写入本地缓存和健康状态;因此数据流透明度、来源链接得分高。密钥交由 Hermes 活跃配置管理且可清空,但材料没有展示密钥加密、缓存清理或敏感查询确认机制;研究模式会调用多个 API,虽有预算控制但不会逐次征求确认。依赖安全仅有安全报告流程及 CI 依赖安装信息,未见锁定或审计证据。设置和禁用选项提供部分恢复能力。
材料描述多提供商回退、冷却、保留部分结果、逐 URL 返回结果及结构化错误,并列出多项修复记录,支持日常可靠性得分。CI 配置覆盖多个 Python 版本、测试和生成文件检查,但没有执行证据,故不据此声称运行通过;外部服务、配额、速率限制和本地 sidecar 可用性仍是依赖条件。README 的新版本概述与 FAQ 路由顺序描述略有差异,削弱自洽性。
文档覆盖 Hermes 用户、终端与网关、商业 API、自托管 SearXNG、显式提供商以及本地 DonSeTch 等场景,并区分搜索和提取能力。显式调用、auto_allow、提供商边界、固定 TinyFish/Octen 接口说明较具体;但自动触发按意图分类的规则仍需参考路由文档,且产品仅适用于 Hermes 和 Python 3.10+ 环境。
README 将安装、配置、操作和深层契约分层链接;快速安装、密钥配置、重启、升级、FAQ、示例及限制说明充分。MIT 许可证明确,当前版本、逐版变更和安全报告方式清楚。名称从 Web Search Plus、WSP 到仓库中的 schema tests 等用法略有差别,维护负责人只以版权名和仓库安全流程体现,未提供组织化支持或明确服务期限。
两个工具分别提供来源搜索与页面提取,文档称返回原始链接,并可给出提供商、跳过原因、意图和耗时等质量信息;多服务回退和本地选项构成直接增益。配额、延迟、隐私条款以及研究模式多 API 调用带来成本,文档提供控制项但没有通用成本保证。
README 将关键功能链接到用户指南、FAQ、变更记录、提供商和路由参考;CI 工作流及测试夹具提供实现和测试边界的静态线索,版本说明列举具体修复。多数性能与质量比较仍是 README 中的陈述,当前材料没有附上评测数据集或独立佐证;静态审查不能确认实际结果正确性。
- 查询和目标 URL 会发送给所选服务;“本地”或“免密钥”不代表离线或匿名。处理敏感内容前应核对具体提供商条款。
- 材料未展示依赖锁定或审计证据,且没有执行记录;不要将 CI 配置或文档中的性能比较视为本次审查验证过的结果。
- 研究模式可能增加 API 调用和费用;服务配额、价格及可用性由提供商决定。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
v5.1.9 v5.1.9 settings mean what they say
发布说明摘录
Web Search Plus 5.1.9 Settings mean what they say. A provider you allow for automatic search is used, status names a placeholder key and says when nothing runs automatically, and a self-hosted SearXNG URL set the Hermes way is picked up. Found by an audit of the MCP server against this plugin and decided with the maintainer; checked with the real Hermes v0.22.5 CLI in a throwaway home. No configuration changes are needed. Fixed …在 GitHub 查看 ↗ -
v5.1.8 v5.1.8 · setup tells the truth
发布说明摘录
Web Search Plus 5.1.8 Setup tells the truth. Whether a provider can run is now decided in one place, and every surface — status, setup, the tools' availability, the session hint, the engine and the native backend — shows that one answer, with the reason and the command that fixes it. Found by an analysis of the plugin's implicit state machines; checked with the real Hermes v0.22.5 CLI in a throwaway home. No configuration changes are needed. Fixed …在 GitHub 查看 ↗ -
v5.1.7 v5.1.7 · extract failures name their reason
发布说明摘录
Web Search Plus 5.1.7 Honest page extraction. When a page cannot be read, the model now learns why and can tell the user, and Web Search Plus stops paying for providers that cannot help. Found in a code review and checked with real keys through the registered Hermes tool. No configuration changes are needed. Fixed …在 GitHub 查看 ↗
常见问题
必须购买搜索 API 吗?
最少需要配置多少个提供商?
web_search_plus;一个支持提取的密钥或端点即可启用 web_extract_plus。增加提供商主要用于扩展路由和回退选择。DonSeTch 会随插件安装吗?
DONSETCH_BIN 配置绝对可执行路径;README 标明适配器测试版本为 4.2.9。提供商失败时会怎样?
敏感查询可以安全发送给任何提供商吗?
Web Search Plus for Hermes 官网是什么?
Web Search Plus for Hermes 免费吗?
Web Search Plus for Hermes 开源吗?
Web Search Plus for Hermes 还在维护吗?
Web Search Plus for Hermes 是谁开发的?
谢谢反馈,我们会据此改进页面。