# web_search Tool

> The Hermes tool that searches the web, with web_extract to read the pages it finds.

**Field:** Artificial Intelligence  
**Category:** Hermes Agent  
**Also known as:** web_extract, Hermes web search, Hermes web tools

## Think of it like

It is like getting a list of books. Then you read the ones you pick.

## Definition

web_search is the Hermes tool that searches the web and gives back a ranked list of results. Its partner web_extract fetches a page and keeps only the text you can read. Both run through one search service that you choose with hermes tools. A fresh install works with no key, by taking turns on free plans. You can also run your own free search server with SearXNG.

## Example

Sara asks Hermes for this week's news on a library. It runs web_search, then web_extract on the top two links, and sums them up.

## Example code

```bash
hermes tools
```

Pick the search service for web_search and web_extract.

## Why it matters

A model only knows what it was trained on. These two tools let Hermes read today's web.

## Common mistake

Picking a search-only service and then wondering why pages will not load. web_extract needs a service that can fetch pages.

## Three principles

- **Search, then read.** web_search finds, web_extract reads.
- **Works with no key.** Free plans take turns.
- **Your choice of service.** Set it in hermes tools.

## Related terms

- [browser_exec Tool](https://learn.benibix.com/term/ai/hermes-browser-tool)
- [Hermes Toolset](https://learn.benibix.com/term/ai/hermes-toolset)
- [Web Search (AI)](https://learn.benibix.com/term/ai/web-search)
- [Nous Tool Gateway](https://learn.benibix.com/term/ai/nous-tool-gateway)
- [Grounding (AI)](https://learn.benibix.com/term/ai/grounding)

## Told apart from

- [web_search vs browser_exec](https://learn.benibix.com/compare/hermes-web-search-tool-vs-hermes-browser-tool): People think Hermes needs a browser to read the web. It does not. web_search finds pages, and web_extract pulls out their text, fast and cheap. browser_exec starts a real browser that clicks, types and fills forms. Use the web tools to read. Use the browser only when the page needs a hand on the mouse.

![The agent asks to use a tool. A shell command first passes an approval gate with three modes, smart, manual and off. Web tools sit beside it: web_search and web_extract for reading, browser_exec for clicking and typing on a real page.](https://learn.benibix.com/diagrams/ai8-hermes-tool-check.svg)

---

Source: https://learn.benibix.com/term/ai/hermes-web-search-tool
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-17
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
