QwenLM · LaZzyMan · Apr 24, 2026 · Apr 21, 2026 · Apr 22, 2026 · Apr 22, 2026
diff --git a/.qwen/agents/test-engineer.md b/.qwen/agents/test-engineer.md
@@ -18,7 +18,6 @@ tools:
   - run_shell_command
   - skill
   - web_fetch
-  - web_search
 ---
 
 # Test Engineer — Bug Reproduction & Verification

diff --git a/docs/developers/tools/introduction.md b/docs/developers/tools/introduction.md
@@ -46,7 +46,6 @@ Qwen Code's built-in tools can be broadly categorized as follows:
 - **[File System Tools](./file-system.md):** For interacting with files and directories (reading, writing, listing, searching, etc.).
 - **[Shell Tool](./shell.md) (`run_shell_command`):** For executing shell commands.
 - **[Web Fetch Tool](./web-fetch.md) (`web_fetch`):** For retrieving content from URLs.
-- **[Web Search Tool](./web-search.md) (`web_search`):** For searching the web.
 - **[Multi-File Read Tool](./multi-file.md) (`read_many_files`):** A specialized tool for reading content from multiple files or directories, often used by the `@` command.
 - **[Memory Tool](./memory.md) (`save_memory`):** For saving and recalling information across sessions.
 - **[Todo Write Tool](./todo-write.md) (`todo_write`):** For creating and managing structured task lists during coding sessions.
@@ -58,5 +57,6 @@ Additionally, these tools incorporate:
 - **[MCP servers](./mcp-server.md)**: MCP servers act as a bridge between the model and your local environment or other services like APIs.
   - **[MCP Quick Start Guide](../mcp-quick-start.md)**: Get started with MCP in 5 minutes with practical examples
   - **[MCP Example Configurations](../mcp-example-configs.md)**: Ready-to-use configurations for common scenarios
+  - **[Web Search via MCP](./web-search.md)**: Connect to web search services (Bailian, Tavily, GLM) through MCP
   - **[MCP Testing & Validation](../mcp-testing-validation.md)**: Test and validate your MCP server setups
 - **[Sandboxing](../sandbox.md)**: Sandboxing isolates the model and its changes from your environment to reduce potential risk.
diff --git a/docs/developers/tools/web-search.md b/docs/developers/tools/web-search.md
@@ -1,185 +1,215 @@
-# Web Search Tool (`web_search`)
+# Web Search
 
-This document describes the `web_search` tool for performing web searches using multiple providers.
+Qwen Code supports web search capabilities through **MCP (Model Context Protocol)** integrations. Rather than a built-in search tool, web search is provided by connecting to external MCP servers, giving you full flexibility to choose the search service that best fits your needs.
 
-## Description
+## ⚠️ Breaking Change: Built-in `web_search` Tool Removed
 
-Use `web_search` to perform a web search and get information from the internet. The tool supports multiple search providers and returns a concise answer with source citations when available.
+> **Affected versions:** `V0.0.7+` through the last release with built-in web search support.
 
-### Supported Providers
+The built-in `web_search` tool and all its associated configuration have been **removed**. If you were using any of the following, you should migrate to the MCP-based approach described in this document:
 
-1. **DashScope** (Official) - Available when explicitly configured in settings (Qwen OAuth free tier auto-injection discontinued 2026-04-15)
-2. **Tavily** - High-quality search API with built-in answer generation
-3. **Google Custom Search** - Google's Custom Search JSON API
+| Removed                                                                | What to do                                                                                  |
+| ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
+| `webSearch` block in `settings.json`                                   | Configure an MCP server in `mcpServers` instead (see below)                                 |
+| `advanced.tavilyApiKey` in `settings.json`                             | Use the [Tavily MCP server](#tavily-websearch)                                              |
+| `TAVILY_API_KEY` environment variable                                  | Use the [Tavily MCP server](#tavily-websearch)                                              |
+| `DASHSCOPE_API_KEY` for web search                                     | Use the [Alibaba Cloud Bailian WebSearch MCP](#alibaba-cloud-bailian-websearch-recommended) |
+| `GLM_API_KEY` for web search                                           | Use the [GLM WebSearch Prime MCP](#glm-websearch-prime-zhipuai)                             |
+| `--tavily-api-key` / `--glm-api-key` / `--dashscope-api-key` CLI flags | Configure via `mcpServers` in `settings.json`                                               |
 
-### Arguments
+### Migration Examples
 
-`web_search` takes two arguments:
+**Before (Tavily via built-in tool):**
 
-- `query` (string, required): The search query
-- `provider` (string, optional): Specific provider to use ("dashscope", "tavily", "google")
-  - If not specified, uses the default provider from configuration
+```json
+{
+  "webSearch": {
+    "provider": [{ "type": "tavily", "apiKey": "tvly-xxx" }],
+    "default": "tavily"
+  }
+}
+```
+
+**After (Tavily via MCP):**
 
-## Configuration
+```json
+{
+  "mcpServers": {
+    "tavily": {
+      "httpUrl": "https://mcp.tavily.com/mcp/?tavilyApiKey=tvly-xxx"
+    }
+  }
+}
+```
 
-### Method 1: Settings File (Recommended)
+---
 
-Add to your `settings.json`:
+**Before (DashScope via built-in tool):**
 
 ```json
 {
   "webSearch": {
-    "provider": [
-      { "type": "dashscope" },
-      { "type": "tavily", "apiKey": "tvly-xxxxx" },
-      {
-        "type": "google",
-        "apiKey": "your-google-api-key",
-        "searchEngineId": "your-search-engine-id"
-      }
-    ],
+    "provider": [{ "type": "dashscope", "apiKey": "sk-xxx" }],
     "default": "dashscope"
   }
 }
 ```
 
-**Notes:**
-
-- DashScope doesn't require an API key (official, free service)
-- **Qwen OAuth users:** DashScope is automatically added to your provider list, even if not explicitly configured
-- Configure additional providers (Tavily, Google) if you want to use them alongside DashScope
-- Set `default` to specify which provider to use by default (if not set, priority order: Tavily > Google > DashScope)
+**After (Alibaba Cloud Bailian WebSearch via MCP):**
 
-### Method 2: Environment Variables
+```json
+{
+  "mcpServers": {
+    "WebSearch": {
+      "httpUrl": "https://dashscope.aliyuncs.com/api/v1/mcps/WebSearch/mcp",
+      "headers": {
+        "Authorization": "Bearer sk-xxx"
+      }
+    }
+  }
+}
+```
 
-Set environment variables in your shell or `.env` file:
+---
 
-```bash
-# Tavily
-export TAVILY_API_KEY="tvly-xxxxx"
+## Supported MCP Web Search Services
 
-# Google
-export GOOGLE_API_KEY="your-api-key"
-export GOOGLE_SEARCH_ENGINE_ID="your-engine-id"
-```
+### Alibaba Cloud Bailian WebSearch (Recommended)
 
-### Method 3: Command Line Arguments
+The official web search MCP service provided by Alibaba Cloud Bailian platform, powered by DashScope.
 
-Pass API keys when running Qwen Code:
+- **MCP Marketplace:** https://bailian.console.aliyun.com/cn-beijing?tab=mcp#/mcp-market/detail/WebSearch
+- **Cost:** Paid (billed via Alibaba Cloud DashScope)
+- **Get API Key:** https://help.aliyun.com/zh/model-studio/get-api-key
+- **Best for:** Chinese-language queries, access to Chinese web content, integration with the Alibaba Cloud ecosystem
 
-```bash
-# Tavily
-qwen --tavily-api-key tvly-xxxxx
+#### Setup
 
-# Google
-qwen --google-api-key your-key --google-search-engine-id your-id
+**Method 1: CLI command**
 
-# Specify default provider
-qwen --web-search-default tavily
+```bash
+qwen mcp add WebSearch \
+  -t http \
+  "https://dashscope.aliyuncs.com/api/v1/mcps/WebSearch/mcp" \
+  -H "Authorization: Bearer ${DASHSCOPE_API_KEY}"
 ```
 
-### Backward Compatibility (Deprecated)
-
-⚠️ **DEPRECATED:** The legacy `tavilyApiKey` configuration is still supported for backward compatibility but is deprecated:
+**Method 2: `settings.json`**
 
 ```json
 {
-  "advanced": {
-    "tavilyApiKey": "tvly-xxxxx" // ⚠️ Deprecated
+  "mcpServers": {
+    "WebSearch": {
+      "httpUrl": "https://dashscope.aliyuncs.com/api/v1/mcps/WebSearch/mcp",
+      "headers": {
+        "Authorization": "Bearer ${DASHSCOPE_API_KEY}"
+      }
+    }
   }
 }
 ```
 
-**Important:** This configuration is deprecated and will be removed in a future version. Please migrate to the new `webSearch` configuration format shown above. The old configuration will automatically configure Tavily as a provider, but we strongly recommend updating your configuration.
+Replace `${DASHSCOPE_API_KEY}` with your actual API key, or set it as an environment variable so Qwen Code picks it up automatically.
 
-## Disabling Web Search
+---
 
-If you want to disable the web search functionality, you can exclude the `web_search` tool in your `settings.json`:
+### Tavily WebSearch
 
-```json
-{
-  "tools": {
-    "exclude": ["web_search"]
-  }
-}
-```
+A production-ready MCP server providing real-time web search, extract, map, and crawl capabilities.
 
-**Note:** This setting requires a restart of Qwen Code to take effect. Once disabled, the `web_search` tool will not be available to the model, even if web search providers are configured.
+- **Repository:** https://github.com/tavily-ai/tavily-mcp
+- **Cost:** Paid (free tier available)
+- **Get API Key:** https://app.tavily.com/home
+- **Best for:** General-purpose web search with high-quality AI-generated answers
 
-## Usage Examples
+#### Available Tools
 
-### Basic search (using default provider)
+- `tavily_search` — Real-time web search
+- `tavily_extract` — Intelligent data extraction from web pages
+- `tavily_map` — Create a structured map of a website
+- `tavily_crawl` — Systematically explore websites
 
-```
-web_search(query="latest advancements in AI")
-```
+#### Setup
 
-### Search with specific provider
+**Method 1: CLI command (Remote MCP)**
 
-```
-web_search(query="latest advancements in AI", provider="tavily")
+```bash
+qwen mcp add tavily \
+  -t http \
+  "https://mcp.tavily.com/mcp/?tavilyApiKey=${TAVILY_API_KEY}"
 ```
 
-### Real-world examples
+**Method 2: `settings.json` (Remote MCP)**
 
-```
-web_search(query="weather in San Francisco today")
-web_search(query="latest Node.js LTS version", provider="google")
-web_search(query="best practices for React 19", provider="dashscope")
+```json
+{
+  "mcpServers": {
+    "tavily": {
+      "httpUrl": "https://mcp.tavily.com/mcp/?tavilyApiKey=${TAVILY_API_KEY}"
+    }
+  }
+}
 ```
 
-## Provider Details
+Replace `${TAVILY_API_KEY}` with your actual API key, or set it as an environment variable.
 
-### DashScope (Official)
+**Method 3: `settings.json` (Local NPX)**
 
-- **Cost:** Free (requires Qwen OAuth credentials)
-- **Authentication:** Requires Qwen OAuth credentials
-- **Configuration:** Must be explicitly configured in `settings.json` web search providers (auto-injection for Qwen OAuth users was removed when the free tier was discontinued on 2026-04-15)
-- **Quota:** 200 requests/minute, 100 requests/day
-- **Best for:** General queries when you have Qwen OAuth credentials
+```json
+{
+  "mcpServers": {
+    "tavily-mcp": {
+      "command": "npx",
+      "args": ["-y", "tavily-mcp@latest"],
+      "env": {
+        "TAVILY_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
 
-### Tavily
+---
 
-- **Cost:** Requires API key (paid service with free tier)
-- **Sign up:** https://tavily.com
-- **Features:** High-quality results with AI-generated answers
-- **Best for:** Research, comprehensive answers with citations
+### GLM WebSearch Prime (ZhipuAI)
 
-### Google Custom Search
+The official web search Remote MCP service provided by ZhipuAI (智谱AI), designed for GLM Coding Plan users. Provides real-time web search including news, stock prices, weather, and more.
 
-- **Cost:** Free tier available (100 queries/day)
-- **Setup:**
-  1. Enable Custom Search API in Google Cloud Console
-  2. Create a Custom Search Engine at https://programmablesearchengine.google.com
-- **Features:** Google's search quality
-- **Best for:** Specific, factual queries
+- **Documentation:** https://docs.bigmodel.cn/cn/coding-plan/mcp/search-mcp-server
+- **Cost:** Included in GLM Coding Plan subscription (Lite: 100 calls/month, Pro: 1,000/month, Max: 4,000/month)
+- **Get API Key:** https://open.bigmodel.cn/apikey/platform
+- **Best for:** Chinese-language queries, real-time information retrieval
 
-## Important Notes
+#### Available Tools
 
-- **Response format:** Returns a concise answer with numbered source citations
-- **Citations:** Source links are appended as a numbered list: [1], [2], etc.
-- **Multiple providers:** If one provider fails, manually specify another using the `provider` parameter
-- **DashScope availability:** Automatically available for Qwen OAuth users, no configuration needed
-- **Default provider selection:** The system automatically selects a default provider based on availability:
-  1. Your explicit `default` configuration (highest priority)
-  2. CLI argument `--web-search-default`
-  3. First available provider by priority: Tavily > Google > DashScope
+- `webSearchPrime` — Web search returning page title, URL, summary, site name, and favicon
 
-## Troubleshooting
+#### Setup
 
-**Tool not available?**
+**Method 1: CLI command**
 
-- **For Qwen OAuth users:** The tool is automatically registered with DashScope provider, no configuration needed
-- **For other authentication types:** Ensure at least one provider (Tavily or Google) is configured
-- For Tavily/Google: Verify your API keys are correct
+```bash
+qwen mcp add web-search-prime \
+  -t http \
+  "https://open.bigmodel.cn/api/mcp/web_search_prime/mcp" \
+  -H "Authorization: Bearer ${GLM_API_KEY}"
+```
 
-**Provider-specific errors?**
+**Method 2: `settings.json`**
 
-- Use the `provider` parameter to try a different search provider
-- Check your API quotas and rate limits
-- Verify API keys are properly set in configuration
+```json
+{
+  "mcpServers": {
+    "web-search-prime": {
+      "httpUrl": "https://open.bigmodel.cn/api/mcp/web_search_prime/mcp",
+      "headers": {
+        "Authorization": "Bearer ${GLM_API_KEY}"
+      }
+    }
+  }
+}
+```
 
-**Need help?**
+Replace `${GLM_API_KEY}` with your actual ZhipuAI API key, or set it as an environment variable.
 
-- Check your configuration: Run `qwen` and use the settings dialog
-- View your current settings in `~/.qwen-code/settings.json` (macOS/Linux) or `%USERPROFILE%\.qwen-code\settings.json` (Windows)
+---