Hermes Agent 接入 wigolo:免费搜索 / 爬虫 / 研究一体化

通过 MCP 协议把 wigolo(本地 Web 智能层,MCP Server)接入 Hermes Agent,即可获得免 API Key、零费用、隐私在本地的一站式 Web 搜索 / 抓取 / 研究能力。所有网络数据停留在 ~/.wigolo/,不依赖外部付费 API。

为什么需要这个集成

Hermes Agent 内置的 web 工具集(基于 SearXNG 搜索 + 网页内容提取)在以下场景力不从心:

场景	Hermes 内置	Hermes + wigolo
多引擎并行搜索	单一后端(SearXNG)	18 个引擎 + 秩融合
JS 渲染的 SPA 页面	无法处理	Playwright 浏览器路由
整站爬虫	不支持	BFS/DFS/Sitemap
结构化提取	无	JSON Schema / 表格 / JSON-LD
本地缓存复用	无	SQLite 向量缓存
自主多步研究	无	分解 → 搜索 → 合成报告
页面变更监控	无	Watch + Diff + Webhook

架构示意:Hermes Agent(内置 terminal · file · web · MCP)→ MCP over stdio → wigolo(MCP Server,10 tools · 浏览器池 · 缓存 · 18 引擎 · ML 重排 · 向量索引)。所有网络数据停留在 ~/.wigolo/,无需 API Key,零费用。

前置条件

Hermes Agent:已安装并运行;内置 MCP 客户端可用(检查配置中 mcp_servers 是否被识别);MCP Python SDK 已安装(pip install mcp,uv 用户用 uv pip install mcp)。
wigolo:Node.js ≥ 20(node --version 确认);约 1.5 GB 空闲磁盘(首次启动下载浏览器引擎 + ML 模型);macOS / Linux / Windows 均支持。

安装与配置

方法 A:一键 CLI 添加(推荐)

hermes mcp add wigolo -- npx -y wigolo

自动完成:写入 config.yaml 的 mcp_servers → 下次启动自动连接发现工具 → 工具以 mcp_wigolo_* 前缀注册到工具集。

方法 B:手动编辑 config.yaml

mcp_servers:
  wigolo:
    command: "npx"
    args: ["-y", "wigolo"]
    timeout: 120
    connect_timeout: 60

保存后重启 Hermes Agent 生效。

首次启动与预热

# 基础预热(浏览器引擎 + 搜索引导)
npx wigolo warmup
# 完整预热(+ Firefox、WebKit、ML 重排器、嵌入模型)
npx wigolo warmup --all

重新加载 MCP 配置:Hermes 已运行时,会话中输入 /reload-mcp;不可用则完全重启(/quit 后 hermes)。

可选:配置 LLM 合成(大幅提升质量)

wigolo 的核心工具(search、fetch、crawl、extract、cache、find_similar)无需 LLM,完全免费;但 research、agent 和 search 的 format=answer 模式用 LLM 合成报告,加一个免费 key 即可:

export WIGOLO_LLM_PROVIDER=gemini
export GEMINI_API_KEY=***   # 从 aistudio.google.com 获取

Gemini 免费 tier 慷慨且无需绑定信用卡。

验证集成

启动后观察日志是否有 wigolo 连接成功信息,或在会话中直接说"搜索 Hermes Agent MCP integration",正确连接会看到 mcp_wigolo_search、mcp_wigolo_fetch 等工具。wigolo 自身提供健康检查:npx wigolo doctor;列出已配置服务器:hermes mcp list。

使用场景

实时 Web 搜索:开发中查最新文档、API 变更——返回前 5 个结果,每个带原文摘录 + 来源链接,引用有据。
整站爬虫 + 知识库构建:wigolo crawl BFS 爬虫自动遵守 robots.txt 按域限速,内容缓存本地,后续查询秒级离线定位。
多步研究:wigolo research 分解子问题 → 并行搜索多引擎 → 合成含引用的综合报告。
结构化数据提取:wigolo extract 返回表格数据 + JSON-LD + 元数据,可直接二次处理。
页面变更监控:wigolo watch 创建懒加载监视任务,定期 wigolo diff 对比,变更推送到指定渠道。
搜索 + 编码 Agent 协同:search → fetch 获取文档,再调 terminal + file 生成代码——搜索和编码在同一会话内无缝衔接。

高级配置

限定可用工具(10 个太多时只暴露需要的):

mcp_servers:
  wigolo:
    command: "npx"
    args: ["-y", "wigolo"]
    tools:
      include:
        - search
        - fetch
        - research

环境变量:

变量	作用	建议值
`WIGOLO_LLM_PROVIDER`	合成报告的 LLM 提供商	gemini / anthropic
`GEMINI_API_KEY`	对应 API Key	免费获取
`WIGOLO_SEARCH`	搜索后端模式	default / hybrid
`WIGOLO_GITHUB_TOKEN`	GitHub 代码搜索额度	个人 token
`WIGOLO_EAGER_WARMUP`	预热时加载 ML 模型	1(推荐)
`WIGOLO_TLS_TIER`	每域名学习型抓取	auto

REST API 模式:wigolo serve & 启动 REST 服务,然后通过 HTTP 连接:

mcp_servers:
  wigolo:
    url: "http://127.0.0.1:3333/mcp"
    timeout: 180

定时研究任务:Hermes cron + wigolo research 结合:

hermes cron create --schedule "0 9 * * 1" \
  --prompt "用 wigolo research 分析过去一周 AI 动态" \
  --name "weekly-agent-research"

与内置 Web 工具对比

维度	内置 web 工具	+ wigolo
搜索后端	SearXNG 单实例	18 引擎 + 秩融合 + ML
获取页面	基本 HTTP GET	HTTP → 浏览器自动升级
JS 渲染页面	不支持	自动检测 + Playwright
整站爬虫	不支持	BFS/DFS/Sitemap
本地缓存	每次重新请求	SQLite 向量缓存
多步研究	不支持	分解 → 搜索 → 合成
页面监控	不支持	Watch + Diff
隐私	本地	本地(`~/.wigolo/`)
费用	免费	免费(无 API Key)
磁盘占用	几百 MB	+1.5 GB(引擎 + 模型)

FAQ

与 SearXNG 冲突吗? 不冲突。SearXNG 是内置 web 工具的后端,wigolo 通过 MCP 作为独立工具集加入,可同时拥有两套搜索能力。
1.5 GB 磁盘太大? 用 --no-warmup 先不下载,第一次使用时按需下载;浏览器引擎只在渲染 SPA 页面时才用到。
WSL 注意事项? wigolo 完全可用,但 Playwright 浏览器引擎需装系统依赖:sudo apt-get install -y libnss3 libatk-bridge2.0-0 libdrm2 libxkbcommon0 libgbm1 libasound2。
工具调用超时? 搜索结果多或 crawl 大页面时调大:timeout: 180、connect_timeout: 120。
如何卸载? hermes mcp remove wigolo 移除配置;npx wigolo config --uninstall --yes 清理本地数据。

集成完成后,在 Hermes 中试一句:“搜索 what is the latest version of Hermes Agent”——返回结果带引用编号和来源链接即说明成功。

原文:公众号「昕科技团队」《Hermes Agent 接上 wigolo,搜索 / 爬虫 / 研究全免费》

为什么需要这个集成#

前置条件#

安装与配置#

验证集成#

使用场景#

高级配置#

与内置 Web 工具对比#

FAQ#