# WebSearch Tool

> The tool that searches the web and returns titles and links.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** WebSearch, Claude Code web search

## Think of it like

It is like looking up a topic in a library card box. You get titles, not the books.

## Definition

The WebSearch tool searches the web and returns the titles and links of the results. It does not open the pages. To read one, Claude follows up with WebFetch. One call can run several searches behind the scenes to sharpen the results. An interactive session has a limit of 200 searches. Its rule has no pattern: you allow or deny WebSearch as a whole.

## Example

Jack hits an error he has never seen. Claude searches for the message, finds a bug report, then fetches the page to read the fix.

## Example code

```json
{"permissions": {"deny": ["WebSearch"]}}
```

Turn web search off for this project.

## Why it matters

It lets Claude find facts that are newer than what it learned.

## Common mistake

Expecting search results to hold the answer. They are only titles and links, so the page still has to be read.

## Three principles

- **Titles and links.** Not pages.
- **Then WebFetch.** To read one.
- **One rule.** Allow or deny it all.

## Related terms

- [WebFetch Tool](https://learn.benibix.com/term/ai/web-fetch-tool)
- [AI Search Engine](https://learn.benibix.com/term/ai/ai-search-engine)
- [Grounding (AI)](https://learn.benibix.com/term/ai/grounding)
- [Web Search (AI)](https://learn.benibix.com/term/ai/web-search)

## Told apart from

- [WebSearch vs WebFetch](https://learn.benibix.com/compare/web-search-tool-vs-web-fetch-tool): People often think WebSearch reads the pages it finds. It does not. WebSearch only brings back titles and links. To read a page, Claude has to call WebFetch on one link. WebFetch then opens that page and pulls out only the part Claude asked about. So a search finds where to look, and a fetch does the reading.

## Taught in

- [Bash, WebFetch and WebSearch](https://learn.benibix.com/learn/ai-claude-code/bash-webfetch-and-websearch): Claude Code, 10/16

![WebSearch returns titles and links. WebFetch opens one page, and a second model pulls out what was asked.](https://learn.benibix.com/diagrams/ct-web-tools.svg)

---

Source: https://learn.benibix.com/term/ai/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.
