Skip to Content
Guia do DesenvolvedorFerramentasPesquisa na Web

Busca na Web

O Qwen Code oferece recursos de busca na web por meio de integrações MCP (Model Context Protocol). Em vez de uma ferramenta de busca nativa, a funcionalidade é fornecida pela conexão a servidores MCP externos, dando a você total flexibilidade para escolher o serviço de busca que melhor atende às suas necessidades.

⚠️ Breaking Change: Ferramenta web_search nativa removida

Versões afetadas: V0.0.7+ até a última versão com suporte nativo à busca na web.

A ferramenta nativa web_search e todas as suas configurações associadas foram removidas. Se você estava usando algum dos itens abaixo, deve migrar para a abordagem baseada em MCP descrita neste documento:

RemovidoO que fazer
Bloco webSearch no settings.jsonConfigure um servidor MCP em mcpServers (veja abaixo)
advanced.tavilyApiKey no settings.jsonUse o servidor MCP da Tavily
Variável de ambiente TAVILY_API_KEYUse o servidor MCP da Tavily
DASHSCOPE_API_KEY para busca na webUse o MCP Alibaba Cloud Bailian WebSearch
GLM_API_KEY para busca na webUse o MCP GLM WebSearch Prime
Flags de CLI --tavily-api-key / --glm-api-key / --dashscope-api-keyConfigure via mcpServers no settings.json

Exemplos de Migração

Antes (Tavily via ferramenta nativa):

{ "webSearch": { "provider": [{ "type": "tavily", "apiKey": "tvly-xxx" }], "default": "tavily" } }

Depois (Tavily via MCP):

{ "mcpServers": { "tavily": { "httpUrl": "https://mcp.tavily.com/mcp/?tavilyApiKey=tvly-xxx" } } }

Antes (DashScope via ferramenta nativa):

{ "webSearch": { "provider": [{ "type": "dashscope", "apiKey": "sk-xxx" }], "default": "dashscope" } }

Depois (Alibaba Cloud Bailian WebSearch via MCP):

{ "mcpServers": { "WebSearch": { "httpUrl": "https://dashscope.aliyuncs.com/api/v1/mcps/WebSearch/mcp", "headers": { "Authorization": "Bearer sk-xxx" } } } }

Serviços de Busca na Web via MCP Suportados

Alibaba Cloud Bailian WebSearch (Recomendado)

O serviço oficial de busca na web via MCP fornecido pela plataforma Alibaba Cloud Bailian, com tecnologia DashScope.

Configuração

Método 1: Comando CLI

qwen mcp add WebSearch \ -t http \ "https://dashscope.aliyuncs.com/api/v1/mcps/WebSearch/mcp" \ -H "Authorization: Bearer ${DASHSCOPE_API_KEY}"

Método 2: settings.json

{ "mcpServers": { "WebSearch": { "httpUrl": "https://dashscope.aliyuncs.com/api/v1/mcps/WebSearch/mcp", "headers": { "Authorization": "Bearer ${DASHSCOPE_API_KEY}" } } } }

Substitua ${DASHSCOPE_API_KEY} pela sua API key real ou defina-a como uma variável de ambiente para que o Qwen Code a detecte automaticamente.


Tavily WebSearch

Um servidor MCP pronto para produção que oferece recursos de busca na web em tempo real, extração, mapeamento e crawl.

Ferramentas Disponíveis

  • tavily_search — Busca na web em tempo real
  • tavily_extract — Extração inteligente de dados de páginas web
  • tavily_map — Criação de um mapa estruturado de um site
  • tavily_crawl — Exploração sistemática de sites

Configuração

Método 1: Comando CLI (MCP Remoto)

qwen mcp add tavily \ -t http \ "https://mcp.tavily.com/mcp/?tavilyApiKey=${TAVILY_API_KEY}"

Método 2: settings.json (MCP Remoto)

{ "mcpServers": { "tavily": { "httpUrl": "https://mcp.tavily.com/mcp/?tavilyApiKey=${TAVILY_API_KEY}" } } }

Substitua ${TAVILY_API_KEY} pela sua API key real ou defina-a como uma variável de ambiente.

Método 3: settings.json (NPX Local)

{ "mcpServers": { "tavily-mcp": { "command": "npx", "args": ["-y", "tavily-mcp@latest"], "env": { "TAVILY_API_KEY": "your-api-key-here" } } } }

GLM WebSearch Prime (ZhipuAI)

O serviço oficial de busca na web via Remote MCP fornecido pela ZhipuAI (智谱AI), projetado para usuários do GLM Coding Plan. Oferece busca na web em tempo real, incluindo notícias, cotações de ações, previsão do tempo e muito mais.

Ferramentas Disponíveis

  • webSearchPrime — Busca na web que retorna título da página, URL, resumo, nome do site e favicon

Configuração

Método 1: Comando CLI

qwen mcp add web-search-prime \ -t http \ "https://open.bigmodel.cn/api/mcp/web_search_prime/mcp" \ -H "Authorization: Bearer ${GLM_API_KEY}"

Método 2: settings.json

{ "mcpServers": { "web-search-prime": { "httpUrl": "https://open.bigmodel.cn/api/mcp/web_search_prime/mcp", "headers": { "Authorization": "Bearer ${GLM_API_KEY}" } } } }

Substitua ${GLM_API_KEY} pela sua API key real da ZhipuAI ou defina-a como uma variável de ambiente.


Last updated on