# Web Search Plus — One search. Every source.

## Landing page

Search and page extraction for AI agents. One router in front of the providers you already have: it returns the original links and the page text, never an answer it made up.

The routing visual follows a question to a configured provider, through fallback if needed, to sources with links, page text and an optional quality report. The sources stay attached, whichever provider runs.

- Picks a provider: sends each query to the provider that fits it, chosen from the keys you configured.
- Falls back: missing key, provider error or empty result, and the request moves to the next provider; you see that it did.
- Shows its work: every result carries its source; the quality report records which provider answered, which fell back, and how long it took.

15 search / 9 extract providers. One provider key is enough.
Hermes v4.1.1 · MCP v4.1.1 · OpenClaw plugin v4.0.3 · skill v4.0.0.

| Runtime | Install | Setup |
| --- | --- | --- |
| Hermes | `hermes plugins install robbyczgw-cla/hermes-web-search-plus --enable` | [Setup](https://github.com/robbyczgw-cla/hermes-web-search-plus#readme) |
| MCP | `uvx --from web-search-plus-mcp==4.1.1 web-search-plus-mcp` | [Setup](https://github.com/robbyczgw-cla/web-search-plus-mcp#readme) |
| OpenClaw | `openclaw plugins install clawhub:web-search-plus-plugin-v2` | [Setup](https://github.com/robbyczgw-cla/web-search-plus-plugin#readme) |
| NanoClaw | `/add-web-search-plus` | [Setup](https://github.com/robbyczgw-cla/nanoclaw-web-search-plus#readme) |

Routing, client configuration, release history and FAQ: [developer resources](/developers.md).
Provider capabilities, local boundaries and dated pricing: [provider guide](/providers.md).
DonSeTch 3.6.1 is separately installed, AGPL-3.0-only and explicit-only by default.

## Extended reference

Web Search Plus is a multi-provider web search and page-extraction router for AI agents. Start with one provider, add more when you need them, and keep the original links behind every result. If one service fails, the router can try another.

This page is the markdown twin of [https://websearchplus.xyz/](https://websearchplus.xyz/). Machine index: [/llms.txt](/llms.txt). Developer index: [/developers.md](/developers.md).

## What it does

- `web_search_plus` — live search across 15 source-only search providers
- `web_extract_plus` — clean page text across 9 extraction providers
- Automatic fallback when a key is missing, a provider errors, or the result set is empty
- Quality report records every fallback so failures are not silent
- Public tools stay source-only: links and extracted text, not model-written answers

Current baselines: Hermes plugin **v4.1.1**, MCP **web-search-plus-mcp==4.1.1**. OpenClaw plugin **v4.0.3** and skill **v4.0.0** stay on their own trains.

## Install paths

### Hermes Agent

Repository: https://github.com/robbyczgw-cla/hermes-web-search-plus

Install the plugin, then call `web_search_plus` / `web_extract_plus` (default). One provider key is enough. Optionally set Hermes `web.search_backend` / `web.extract_backend` to `wsp` so native `web_search` / `web_extract` use the same engine in-process — Hermes-only, not MCP. Tests DonSeTch 3.6.1.

### MCP (Claude Desktop, Claude Code, Cursor, NanoBot, any MCP client)

```bash
uvx --from web-search-plus-mcp==4.1.1 web-search-plus-mcp
```

Source: https://github.com/robbyczgw-cla/web-search-plus-mcp
PyPI: https://pypi.org/project/web-search-plus-mcp/

MCP 4.1.1 carries the DonSeTch 3.6.1 adapter update. It does not register the Hermes native backend.

### OpenClaw and NanoClaw

- Skill v4.0.0: https://github.com/robbyczgw-cla/web-search-plus
- Plugin v4.0.3: https://github.com/robbyczgw-cla/web-search-plus-plugin
- NanoClaw: https://github.com/robbyczgw-cla/nanoclaw-web-search-plus

## Providers

See the dated [provider guide](/providers.md) for search/extract support, free tiers, starting prices, and the privacy/terms matrix. Snapshot date is printed at the top of that page.

Local / no-key options include self-hosted SearXNG, opt-in Keenable public access, and separately installed DonSeTch (`DONSETCH_BIN`, AGPL-3.0-only).

## FAQ

**Do I need API keys for all 15 providers?**
No. One provider is enough. Commercial APIs use their own keys.

**Which clients work?**
Hermes Agent and OpenClaw as flagship plugins, NanoClaw through a dedicated front-end, plus any MCP-compatible client through `web-search-plus-mcp`.

**What happens when a provider fails?**
The router falls through the chain. The quality report records every fallback.

**Does it extract pages or only search?**
Both. Search and extract share the same fallback behavior.

**What does it cost?**
The router is free and open source. You pay the providers you configure. Self-hosted SearXNG and local DonSeTch avoid provider request fees but still cost your machine, bandwidth, and maintenance.

## Site map

- [/](/) / [/index.md](/index.md) — this homepage
- [/developers](/developers) / [/developers.md](/developers.md) — developer resources
- [/providers](/providers) / [/providers.md](/providers.md) — provider guide
- [/legal](/legal) / [/legal.md](/legal.md) — Impressum and privacy
- [/llms.txt](/llms.txt) — agent index
- [/sitemap.xml](/sitemap.xml)

Author: [Robby Czesany](https://robbyczesany.com/)
