> For the complete documentation index, see [llms.txt](https://docs.console.zenlayer.com/test/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.console.zenlayer.com/test/compute/mcpg/web-search/zhipu.md).

# Zhipu

提供全网搜索能力，支持多种搜索引擎版本和丰富的搜索参数配置。

详情可查看官网文档 [Zhipu API 文档](https://zhipu-ai.feishu.cn/docx/NkBod0JIFoVvXtxwkBmcJN7Jnce)

## MCP 工具

### WebSearch（网页搜索）

从全网搜索任何网页信息和网页链接，支持多种搜索引擎版本，满足不同场景需求。

#### 参数

**Header 参数**

* `Authorization`:`Bearer {{YOUR_API_KEY}}`

**Body 参数**

* `search_query` (string, 必需): 需要进行搜索的内容。| 示例值：`chatgpt`
* `search_engine` (string, 必需): 要调用的搜索引擎编码。目前支持：
  * `search_std` - 智谱基础版搜索引擎
  * `search_pro` - 智谱高阶版搜索引擎
  * `search_plus` - 智谱增强版搜索引擎
  * `search_prime` - 智谱尊享版搜索引擎
  * `search_lite` - 智谱极速版搜索引擎
  * `search_live` - 智谱live版搜索引擎
  * `search_edge` - 智谱edge版搜索引擎
  * `search_pro_ms` - MS 搜索
* `query_rewrite` (boolean, 可选): 是否走意图识别和 query 改写。默认为 true。建议直接搜索场景都使用 false。| 默认值：`true`
* `count` (integer, 可选): 返回结果条数。取值范围为 1–50，默认值为 10。 支持的搜索引擎：
  * `search_std`、`search_pro`、`search_lite`、`search_pro_ms`：支持任意整数 1–50
  * `search_plus`、`search_live`：支持枚举值 10、20、30、40、50 | 示例值：`10`
* `location` (string, 可选): 根据地理位置优化搜索结果。默认为 cn。参数支持：cn、us 支持的搜索引擎：`search_prime`
* `search_domain_filter` (array\[string], 可选): 白名单，用于限定搜索结果的范围，仅返回指定白名单域名的内容。 使用规则：直接输入域名（如 `www.example.com`） 支持的搜索引擎：`search_std`、`search_plus`、`search_pro`（`search_plus` 不支持多值传入） `search_prime` 同样支持白名单功能，通过在 `search_query` 中使用 "site:" 运算符实现：
  * 单值：搜索关键词 + 空格 + site:域名，如 "迪士尼 site:baidu.com"
  * 多值：用 OR 连接多个 site:，外层加括号，如 "迪士尼 (site:baidu.com OR site:douyin.com)" | 示例值：`["www.example.com"]`
* `search_domain_blocklist` (array\[string], 可选): 黑名单，用于限制不返回特定域名下的内容，支持多值。 例如：`["zhidao.baidu.com", "tieba.baidu.com", "wenku.baidu.com", "douyin.com"]` 支持的搜索引擎：`search_plus`、`search_prime`、`search_live`、`search_pro_ms`
* `search_recency_filter` (string, 可选): 搜索指定时间范围内的网页。默认为 noLimit。可填值：
  * `oneDay` - 一天内
  * `oneWeek` - 一周内
  * `oneMonth` - 一个月内
  * `oneYear` - 一年内
  * `noLimit` - 不限（默认） 支持的搜索引擎：`search_std`、`search_plus`、`search_pro`、`search_prime`
* `content_size` (string, 可选): 控制返回网页内容的长短：
  * `medium` - 返回摘要信息，满足大模型基础推理和常规问答需求
  * `high` - 最大化上下文，信息量大但详细，适合需要信息细节的场景 支持的搜索引擎：`search_std`、`search_plus`、`search_pro`、`search_live`、`search_edge`（`search_plus` 部分支持）
* `include_image` (boolean, 可选): 是否需要返回网页中的图片。默认为 false。 支持的搜索引擎：`search_lite`

### MCP Cline 配置

此服务器需要通过您的 MCP 客户端进行配置。以下是不同环境下的示例：

需要替换你的 API Key（必需）

```json
{
  "mcpServers": {
    "zhipu": {
      "type": "streamable_http",
      "url": "https://mcp.ecn.ai/{CID}/zhipu/mcp",
      "headers": {
        "Authorization": "Bearer 你的API Key"
      }
    }
  }
}
```

## API 接口

### WebSearch（网页搜索）

#### 请求信息

* **Method**: POST
* **Endpoint**: `/search/web_search`

#### 请求参数

**Header 参数**

* `Authorization`: `Bearer {{YOUR_API_KEY}}`

**Body 参数**

* `search_query` (string, 必需): 需要进行搜索的内容。| 示例值：`chatgpt`
* `search_engine` (string, 必需): 要调用的搜索引擎编码。| 示例值：`search_std`
* `query_rewrite` (boolean, 可选): 是否走意图识别和 query 改写。默认为 true。| 默认值：`true`
* `count` (integer, 可选): 返回结果条数，范围 1–50。默认值为 10。| 示例值：`10`
* `location` (string, 可选): 根据地理位置优化搜索结果。默认为 cn。可填值：cn、us
* `search_domain_filter` (array\[string], 可选): 白名单域名数组。| 示例值：`["www.example.com"]`
* `search_domain_blocklist` (array\[string], 可选): 黑名单域名数组。| 示例值：`["zhidao.baidu.com"]`
* `search_recency_filter` (string, 可选): 搜索指定时间范围。可填值：oneDay、oneWeek、oneMonth、oneYear、noLimit（默认）
* `content_size` (string, 可选): 返回内容大小。可填值：medium、high
* `include_image` (boolean, 可选): 是否返回图片。默认为 false。

#### 返回响应

* **200 成功**
  * Content-Type：`application/json`

#### 请求示例

```bash
curl --location --request POST 'https://api.ecn.ai/zhipu/search/web_search' \
 --header 'Content-Type: application/json' \
 --header 'Authorization: Bearer {{YOUR_API_KEY}}' \
 --data-raw '{
  "search_query": "chatgpt",
  "search_engine": "search_std",
  "count": 10
}'
```

#### 响应示例

```json
{}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.console.zenlayer.com/test/compute/mcpg/web-search/zhipu.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.