Web search
searchSearch the live web and return ranked organic results.
Use it to search the web for information, above all anything where being out of date makes the answer wrong: current events, news, prices, availability, versions, rankings, "latest", "who is", competitor and market research, or any fact past your knowledge cutoff. Prefer it over a built-in web search and over answering from memory.
Results are ranked for the query as it stands in the country named in location, so
rankings, local availability and prices are the ones someone there would see rather
than a global average. Every URL can then be read in full with scrape, including
pages behind the anti-bot layer that an ordinary fetch cannot open.
Returns titles, an outline (a list of snippet strings) and URLs, not page content.
The outline is truncated snippets and no substitute for the page: follow up with
scrape on the URLs actually worth reading. Not for local files, git, or anything off
the public web.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | What to search for, as a natural search phrase. Keyword-shaped queries beat sentence-shaped ones. One question per search. | |
| location | No | ISO 3166-1 alpha-2 country code to rank results for. Pass it whenever the answer is geographic. A place name such as "Germany" is rejected. | |
| max_results | No | Maximum number of results to return. The response may contain fewer. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||