robbyczgw-cla
hermes-web-search-plus
Multi-provider web search and page extraction plugin for Hermes agents, with local key-free options.
Repository last updated Jul 24, 2026
Overview
Web Search Plus is a Hermes plugin that equips your agent with reliable web search and page extraction capabilities. It integrates multiple search and extraction providers behind a unified interface, ensuring your agent retrieves real sources rather than fabricated answers. The plugin supports 13 search providers and 9 extraction providers, including self-hosted options like SearXNG, Keenable, and the local key-free Hound service.
With two core tools—web_search_plus for searching the web and web_extract_plus for reading and cleaning page content—your agent can find current information, discover sources, and process URLs into clean text. The plugin features automatic failover, quality reports, and adaptive routing to minimize dead ends. It is designed for developers who want to give their Hermes agent access to real web data without relying on a single provider or paid API.
Web Search Plus is ideal for anyone building Hermes agents that need up-to-date information, source verification, or content extraction. It works with just one configured provider and scales gracefully as you add more. The plugin is MIT-licensed and written in Python 3.10+.
Highlights
- Provides web_search_plus and web_extract_plus tools
- Supports 13 search and 9 extraction providers
- Includes SearXNG, Keenable, and local Hound support
- Automatic failover and quality reporting
- One setup works with many services
- Local key-free options reduce API dependency
Features
Multi-Provider Search
Connect to 13 search providers with automatic failover; start with one and add more as needed.
Page Extraction
Extract clean text from URLs using 9 extraction providers, with optional JavaScript rendering.
Local Key-Free Options
Use SearXNG, Keenable, or the Hound MCP server for privacy-focused, no-API-key search and extraction.
Quality Reports
Optional reports show which provider succeeded and what happened during the request.
Adaptive Routing
The plugin learns provider health and adjusts routing to avoid failures and improve reliability.
Installation
Commands are reproduced exactly as published by the project maintainers. Always check the upstream repository for the current instructions.
# 1) Install and enable the plugin
hermes plugins install robbyczgw-cla/hermes-web-search-plus --enable
# 2) Inspect provider readiness and configure the providers you use
python3 ~/.hermes/plugins/web-search-plus/setup.py status
python3 ~/.hermes/plugins/web-search-plus/setup.py setup --preset starter
# 3) Reload Hermes so the tools are registered
# CLI: exit and start `hermes` again, or use /reset in-session
# Gateway: /restart, then /reset
# 4) Optional shell smoke test
cd ~/.hermes/plugins/web-search-plus
python3 search.py --query "Hermes Agent latest release" --provider auto --quality-reporthermes plugins update web-search-pluspython3 ~/.hermes/plugins/web-search-plus/setup.py setup --preset self-hosted
python3 ~/.hermes/plugins/web-search-plus/setup.py statushermes plugins update web-search-plusRequirements
- Python 3.10+
- Hermes Agent runtime
- At least one configured search or extraction provider (API key or local endpoint)
How it's built
Web Search Plus is a Python plugin for the Hermes Agent, requiring Python 3.10+. The core runtime uses only the standard library; the optional Hound bridge depends on the MCP SDK and httpx (provided by Hermes runtimes). The plugin adds two tools: web_search_plus and web_extract_plus, registered with the Hermes plugin API.
The repository is organized with a flat Python module structure: __init__.py, search.py, setup.py, and supporting modules like config.py, cache.py, and compat_v3.py. Provider configurations are stored in environment variables managed by the setup helper. The plugin supports a self-hosted profile that uses SearXNG and Keenable without commercial API keys.
Hound integration runs as a separate sidecar process on loopback; the plugin does not bundle or fork Hound. The plugin's architecture includes routing, caching, and state management, with detailed contracts documented in the docs/ directory for implementers and reviewers.
Source
This summary was written for Neura Market from the project's own repository. Install commands, identifiers and licence details are reproduced unchanged. The robbyczgw-cla/hermes-web-search-plus repository is the authoritative source and the place to file issues or contribute.
Category: Web & Search · Licensed under MIT