diff --git a/docs/tools/web.md b/docs/tools/web.md index 628ca4dc6..7d5f0ff97 100644 --- a/docs/tools/web.md +++ b/docs/tools/web.md @@ -73,6 +73,29 @@ Search the web with Brave’s API. - `query` (required) - `count` (1–10; default from config) +- `country` (optional): 2-letter country code for region-specific results (e.g., "DE", "US", "ALL"). Default: "US" +- `search_lang` (optional): ISO language code for search results (e.g., "de", "en", "fr") +- `ui_lang` (optional): ISO language code for UI elements + +**Examples:** + +```javascript +// German-specific search +await web_search({ + query: "TV online schauen", + count: 10, + country: "DE", + search_lang: "de" +}); + +// French search with French UI +await web_search({ + query: "actualités", + country: "FR", + search_lang: "fr", + ui_lang: "fr" +}); +``` ## web_fetch diff --git a/src/agents/tools/web-tools.ts b/src/agents/tools/web-tools.ts index 62fc6a302..d12e49c20 100644 --- a/src/agents/tools/web-tools.ts +++ b/src/agents/tools/web-tools.ts @@ -454,7 +454,7 @@ export function createWebSearchTool(options?: { label: "Web Search", name: "web_search", description: - "Search the web using Brave Search API. Returns titles, URLs, and snippets for fast research.", + "Search the web using Brave Search API. Supports region-specific and localized search via country and language parameters. Returns titles, URLs, and snippets for fast research.", parameters: WebSearchSchema, execute: async (_toolCallId, args) => { const apiKey = resolveSearchApiKey(search);