search
Perform Google searches to retrieve web results. Configure number of results, language, deduplication, and safe search settings.
Instructions
Search Google and return web results. Powered by the googlesearch-python library (no API key needed).
Args: query: The search query. num_results: How many results to return (default 10). lang: Language code for results, e.g. "en", "fr", "de" (default "en"). unique: Deduplicate result URLs when True (default False). safe: Safe-search filter. Use "active" to enable, "" to disable (default "active").
Returns: A list of result objects with keys: index, title, url, description.
Raises:
ValueError: If query is empty/blank or num_results is not positive.
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 |
|---|---|---|---|
| lang | No | en | |
| safe | No | active | |
| query | Yes | ||
| unique | No | ||
| num_results | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |