Search the web
searchFind ranked web links with titles and text for a query; refine by recency, locale, domains, and depth. Use extract for known URLs or investigate further.
Instructions
Search the web: ranked links with titles and text, in seconds; free if keyless, else billed. Use extract for a known URL, research to investigate. Higher effort costs more; leave it unset unless needed. For a login or form, suggest browser_open. data_apis: vendor APIs for call_vendor; offer one if it beats the pages.
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. | |
| effort | No | Higher costs more and takes longer: leave it unset unless needed. | |
| locale | No | Language code, e.g. 'en'. | |
| country | No | Country code for geo-targeting, e.g. 'US'. | |
| recency | No | Only sources dated within this. | |
| provider | No | ||
| data_apis | No | Also list matching vendor data APIs under `data_apis`, free and never run; `call_vendor` runs one. On by default. | |
| max_results | No | Unset, the backend's default; 5 to 10 suit most. | |
| search_depth | No | Text per result: 'lite' a snippet (~500 characters), 'fast' a few thousand, 'deep' the whole page, slowest. Unset, the backend's own default; a backend that cannot return a level's size refuses it. | |
| data_apis_only | No | The data APIs alone, no web call; takes only `max_results`. | |
| configured_only | No | Only data APIs whose credentials are set here. | |
| exclude_domains | No | Drop results from these domains. | |
| include_domains | No | Restrict results to these domains. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | ||
| answer | No | ||
| handle | Yes | ||
| results | No | ||
| provider | No | ||
| truncated | No |