docs(web-search): document country and language parameters

Co-Authored-By: Claude <noreply@anthropic.com>

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
 

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);