Web Search

Updated at:

Bailian CLI command reference for web search.

Invoke Bailian's web search capability from the terminal for real-time internet retrieval.

NoteWeb search is currently available only to China site (aliyun.com) accounts.

ImportantAppend --help to any command for full parameter details, e.g. bl search web --help. Command details on this page are verified against bl 2.8.4.

Command reference

bl search web

Search the web through a model with built-in web search by default, or switch to the DashScope MCP WebSearch service. Requires API Key authentication.

Usage

bl search web --query <text> [flags]
ParameterTypeRequiredDescription
--query <text>stringnoSearch query text
--count <n>numbernoNumber of search results (default: 10, MCP mode only)
--list-toolsswitchnoList available MCP tools and exit (MCP mode only)
--mode <mcp|model>stringnoSearch mode: model answers via Chat Completions with enable_search, mcp calls the WebSearch MCP service (default: model)
--model <model>stringnoModel ID for --mode model (default: qwen3.8-max)

Example: Search the web for Alibaba Cloud Bailian latest features

bl search web --query "Alibaba Cloud Bailian latest features"

Example: Get a pages list with MCP mode

bl search web --mode mcp --query "TypeScript 5.9 new features" --count 5

Example: List the tools available in MCP mode

bl search web --list-tools
  • Defaults to --mode model: one non-streaming Chat Completions request with enable_search: true. The model answer is returned as a single content[].text block without a pages list. --mode mcp returns a pages list.
  • --count and --list-tools are available in MCP mode only.
  • The model resolves from --model, default_text_model, then qwen3.8-max.
  • Token Plan subscription keys cannot authorize MCP mode; use the default model mode.