SEARCH_WEB
Search the web for real-time information. Returns titles, snippets, and URLs. Supports regional and safe-search filtering.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
query | string | yes | The search query (be specific for better results) |
max_results | integer | — | Number of results (default 8, max 20) |
region | string | — | Region code (e.g. 'us-en', 'uk-en', 'de-de', 'fr-fr', 'in-en'). Default: no filter |
safesearch | string | — | 'on', 'moderate', or 'off' (default 'moderate') |
How to use it
You normally trigger this by describing what you want in chat — the agent selects SEARCH_WEB automatically. For example:
Try saying
“search the web for the latest on fusion energy”
In a workflow
As a step in a multi-step workflow DAG:
json
{
"id": "s1",
"agent": "web_search",
"action": "SEARCH_WEB",
"args": {
"query": "example query"
},
"depends_on": [],
"outputs": []
}Direct call
For scripting, call it directly via POST /execute_tool. Every tool returns { success, message, data }.
bash
curl -X POST http://127.0.0.1:8000/execute_tool \
-H "Content-Type: application/json" \
-d '{"tool_name":"SEARCH_WEB","args":{"query":"example query"}}'Part of the web_search plugin. Browse the full Plugin & Tool Catalog or the relevant feature guide.