Web-Suche

Qwen Code bietet Websuche auf zwei Arten:

1. Integriertes web_search-Tool — unterstützt von der DashScope Responses API Server-seitigen Suche. Bei unterstützten ModelStudio- und OpenAI-kompatiblen DashScope-Konfigurationen standardmäßig beim Start aktiviert; kein zusätzlicher Anbieter oder MCP-Setup erforderlich.
2. MCP-Integrationen (Model Context Protocol) — verbinden Sie einen beliebigen externen Suchdienst (Tavily, GLM und andere). Verwenden Sie dies, wenn Ihr Anbieter das integrierte Tool nicht bereitstellen kann.

Integriertes web_search

Das integrierte Tool sendet eine eigenständige Suchanfrage an ein kleines Hilfsmodell mit den Server-seitigen web_search- (und web_extractor-) Tools von DashScope und gibt die erzählten Ergebnisse sowie Quell-URLs zurück.

Wenn es sich automatisch einschaltet

Wenn Sie unter tools.webSearch nichts konfiguriert haben, wird das Tool registriert, sobald das Modell, das Sie ausführen, die Suchanfrage mit denselben Credentials bereitstellen kann:

Suchen werden über denselben Schlüssel wie Ihr Hauptmodell abgerechnet. Die Berechtigungsbehandlung folgt dem aktiven Genehmigungsmodus und den Regeln; im Genehmigungsmodus default fordert die erste Suche eine Bestätigung. Wenn Ihr Anbieter das Tool nicht bereitstellen kann, erscheint es einfach nicht beim Start — keine Startwarnung.

So schalten Sie es aus:

{ "tools": { "webSearch": { "enabled": false } } }

oder ENABLE_WEB_SEARCH=false. Bare-Modus und Safe-Modus deaktivieren es immer.

Explizite Konfiguration

Richten Sie das Tool auf einen ModelStudio Standard/Token-Plan- oder einen anderen verifizierten DashScope-Responses-Eintrag. Dies ist nützlich, wenn Ihr Hauptmodell auf einem anderen Anbieter läuft und Sie einen separaten unterstützten DashScope-Schlüssel besitzen. Coding-Plan-Hosts sind von der automatischen Aktivierung ausgeschlossen, da die Responses-Such-Tools dort nicht verifiziert sind. Sie können explizit mit tools.webSearch.model aktivieren; wenn der Endpunkt sie nicht bereitstellt, schlägt die erste Suche lautstark fehl. Verwenden Sie einen MCP-Suchanbieter, wenn Sie sich nicht auf diesen unverified Pfad verlassen wollen.

{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3.8-flash",
        "envKey": "DASHSCOPE_API_KEY",
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1"
      }
    ]
  },
  "tools": {
    "webSearch": {
      "enabled": true,
      "model": "qwen3.8-flash"
    }
  }
}

Nur-Umgebungsvariablen-Konfiguration (ohne settings.json)

Für Umgebungen, in denen Sie keine Einstellungsdatei schreiben können (abgeschottete Container, CI nur mit Umgebungsvariablen-Injektion), kann das Tool vollständig über Umgebungsvariablen konfiguriert werden — kein modelProviders-Eintrag erforderlich:

export ENABLE_WEB_SEARCH=true
export WEB_SEARCH_MODEL=qwen3.8-flash
export WEB_SEARCH_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
export DASHSCOPE_API_KEY=sk-...        # oder stattdessen WEB_SEARCH_API_KEY setzen

WEB_SEARCH_BASE_URL spiegelt den baseUrl eines modelProviders-Eintrags wider und muss ein DashScope-kompatibler Endpunkt sein; wenn es gesetzt ist, hat es Vorrang vor der modelProviders-Auflösung und WEB_SEARCH_MODEL wird als reine DashScope-Modell-ID verwendet. Der API-Schlüssel wird aus WEB_SEARCH_API_KEY gelesen, wenn gesetzt, andernfalls aus DASHSCOPE_API_KEY. Eine Fehlkonfiguration wird weiterhin als Startmeldung angezeigt.

Hinweise:

• Der Selektor muss sich auf einen DashScope-kompatiblen modelProviders-Eintrag auflösen, der einen direkten API-Schlüssel über envKey trägt. Ihr Hauptmodell kann ein beliebiger Anbieter sein — nur die Such-Anfrage benötigt einen DashScope-Eintrag. Qwen OAuth kann das Tool nicht bereitstellen.
• Welche Anbieter das Tool aktivieren können, wird beim Start entschieden. Einmal aktiv, folgt das Such-Backend dem aktuell ausgewählten Modell bei der nächsten Suche; Wechsel zu einem nicht unterstützten Anbieter lässt diesen Aufruf fehlschlagen, während Wechsel von einer Session, in der das Tool fehlte, weiterhin einen Neustart erfordert, um es zu registrieren.
• Die automatische Host-Erkennung akzeptiert absichtlich nur bekannte DashScope-Regionale, Token-Plan-MaaS- und interne Alibaba-Hosts. Generische *.alicloudapi.com-Gateways und DASHSCOPE_PROXY_BASE_URL sind ausgeschlossen, da sie nicht dafür bekannt sind, die Responses-Such-Tools weiterzuleiten.
• Wenn explizit aktiviert, aber fehlerhaft konfiguriert, bleibt das Tool ausgeschaltet und eine Startmeldung erklärt, welche Bedingung fehlgeschlagen ist. Die automatische Aktivierung gibt niemals eine Meldung aus.
• Suchen werden über Ihren DashScope-Schlüssel abgerechnet (usage.x_tools zählt). Der Genehmigungsmodus Auto (Standard) lässt den Classifier Suchen ohne Nachfrage genehmigen; im Genehmigungsmodus default fragt das Tool nach, und Genehmigung mit „immer zulassen” persistiert eine standardmäßige WebSearch-Berechtigungsregel, wie bei anderen Tools.
• Es gibt keine clientseitige Modell-Allowlist; ein Modell, das der Responses-Endpunkt nicht bereitstellt, schlägt bei der ersten Verwendung lautstark fehl.
• Eine Suche, die ihr Zeitbudget überschreitet, gibt das Eingetroffene als Teilergebnis zurück, sobald mindestens ein Suchaufruf abgeschlossen ist; wenn das Budget abläuft, bevor der erste Suchaufruf fertig wird, meldet das Tool stattdessen einen Timeout-Fehler, da eine Erzählung ohne ausgeführte Suche kein überprüfbarer Nachweis ist. Wenn ein Suchaufruf abgeschlossen wurde, aber die erzählte Antwort nie eingetroffen ist, enthält das Ergebnis höchstens 6.000 Zeichen des Seitentextes, den der Agent gelesen hatte, gekennzeichnet als roher Seiteninhalt.
• Die pro-Session-Obergrenze zählt web_search-Tool-Aufrufe, nicht die Suchen, die ein Aufruf intern ausführt, und ein fehlgeschlagener Aufruf zählt trotzdem, da die Anfrage gesendet wurde. Ein übersprungener Aufruf ist kein Fehler: Er teilt dem Modell mit, dass das Budget aufgebraucht ist, und dass es Sie bitten soll, tools.webSearch.maxPerSession zu erhöhen, wenn wirklich mehr Suchen benötigt werden.

MCP-Alternativen

Wenn Ihr Anbieter das integrierte Tool nicht bereitstellen kann, steht die Websuche durch die Verbindung eines externen MCP-Servers zur Verfügung — siehe die folgenden Dienste.

⚠️ Historischer Breaking Change: Ursprüngliches integriertes web_search entfernt

Betroffene Versionen: V0.0.7+ bis zur letzten Version mit dem ursprünglichen integrierten Multi-Anbieter-Websuchtool.

Das ursprüngliche integrierte web_search-Tool (Tavily/Google/GLM/DashScope Multi-Anbieter) und seine Konfiguration wurden entfernt. Das oben dokumentierte integrierte Tool ist eine andere Implementierung mit einer anderen Konfiguration. Wenn Sie einen der folgenden Punkte verwendet haben, migrieren Sie entweder zum neuen integrierten Tool (DashScope) oder zu MCP:

Migrationsbeispiele

Vorher (Tavily über integriertes Tool):

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

Nachher (Tavily über MCP):

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

Vorher (DashScope über integriertes Tool):

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

Nachher (Alibaba Cloud Bailian WebSearch über MCP):

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

Unterstützte MCP-Websuchdienste

Alibaba Cloud Bailian WebSearch

Der offizielle Websuche-MCP-Dienst, bereitgestellt von der Alibaba Cloud Bailian-Plattform, unterstützt von DashScope. Wenn Sie einen DashScope-Schlüssel haben, bevorzugen Sie das oben genannte integrierte web_search-Tool — es verwendet einen stärkeren Suchpfad als dieser MCP-Dienst.

• MCP Marketplace: https://bailian.console.aliyun.com/cn-beijing?tab=mcp#/mcp-market/detail/WebSearch 
• Kosten: Kostenpflichtig (Abrechnung über Alibaba Cloud DashScope)
• API-Schlüssel abrufen: https://help.aliyun.com/zh/model-studio/get-api-key 
• Am besten geeignet für: Chinesischsprachige Abfragen, Zugriff auf chinesische Webinhalte, Integration in das Alibaba Cloud-Ökosystem

Einrichtung

Methode 1: CLI-Befehl

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

Methode 2: settings.json

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

Ersetzen Sie ${DASHSCOPE_API_KEY} durch Ihren tatsächlichen API-Schlüssel, oder setzen Sie ihn als Umgebungsvariable, damit Qwen Code ihn automatisch übernimmt.

Tavily WebSearch

Ein produktionsreifer MCP-Server mit Echtzeit-Websuche, Extraktion, Mapping und Crawling-Funktionen.

• Repository: https://github.com/tavily-ai/tavily-mcp 
• Kosten: Kostenpflichtig (kostenlose Stufe verfügbar)
• API-Schlüssel abrufen: https://app.tavily.com/home 
• Am besten geeignet für: Allgemeine Websuche mit hochwertigen KI-generierten Antworten

Verfügbare Tools

• tavily_search — Echtzeit-Websuche
• tavily_extract — Intelligente Datenextraktion aus Webseiten
• tavily_map — Erstellen einer strukturierten Karte einer Website
• tavily_crawl — Systematisches Erkunden von Websites

Einrichtung

Methode 1: CLI-Befehl (Remote MCP)

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

Methode 2: settings.json (Remote MCP)

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

Ersetzen Sie ${TAVILY_API_KEY} durch Ihren tatsächlichen API-Schlüssel, oder setzen Sie ihn als Umgebungsvariable.

Methode 3: settings.json (Lokales NPX)

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

GLM WebSearch Prime (ZhipuAI)

Der offizielle Remote-MCP-Websuchdienst von ZhipuAI (智谱AI), entwickelt für GLM Coding Plan-Nutzer. Bietet Echtzeit-Websuche einschließlich Nachrichten, Aktienkurse, Wetter und mehr.

• Dokumentation: https://docs.bigmodel.cn/cn/coding-plan/mcp/search-mcp-server 
• Kosten: Im GLM Coding Plan-Abonnement enthalten (Lite: 100 Aufrufe/Monat, Pro: 1.000/Monat, Max: 4.000/Monat)
• API-Schlüssel abrufen: https://open.bigmodel.cn/apikey/platform 
• Am besten geeignet für: Chinesischsprachige Abfragen, Echtzeit-Informationsabruf

Verfügbare Tools

• webSearchPrime — Websuche, die Seitentitel, URL, Zusammenfassung, Seitenname und Favicon zurückgibt

Einrichtung

Methode 1: CLI-Befehl

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

Methode 2: settings.json

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

Ersetzen Sie ${GLM_API_KEY} durch Ihren tatsächlichen ZhipuAI-API-Schlüssel, oder setzen Sie ihn als Umgebungsvariable.