介绍
# Zhipu Search
通过 Zhipu AI API 进行网络搜索，支持多种搜索引擎和灵活的参数配置。
## 快速开始
### 基础搜索
```python # Use default parameters search_query = "OpenClaw latest version" search_engine = "search_std" ```
### 高级搜索（完整参数）
```python search_query = "AI development trends" # Required, max 70 chars search_engine = "search_pro" # Required: search_std/search_pro/search_pro_sogou/search_pro_quark search_intent = true # Optional, default false, enable search intent recognition count = 20 # Optional, default 10, range 1-50 search_domain_filter = "example.com" # Optional, whitelist domain filter search_recency_filter = "oneWeek" # Optional: oneDay/oneWeek/oneMonth/oneYear/noLimit content_size = "high" # Optional: medium/high, control content detail level request_id = "unique-request-id" # Optional, unique request identifier user_id = "user-123456" # Optional, end user ID (6-128 chars) ```
## 使用方法
### 方法 1：直接脚本调用（推荐）
```bash python scripts/zhipu_search.py \ --query "search content" \ --engine search_pro \ --count 10 ```
### 方法 2：使用 OpenClaw 工具
系统将根据需求自动选择合适的参数。
## API 参数参考
| 参数 | 类型 | 必填 | 默认值 | 描述 | |-----------|------|----------|---------|-------------| | search_query | string | ✅ | - | 搜索内容，建议 ≤70 字符 | | search_engine | enum | ✅ | - | search_std/search_pro/search_pro_sogou/search_pro_quark | | search_intent | boolean | - | false | 启用搜索意图识别 | | count | integer | - | 10 | 结果数量，1-50 | | search_domain_filter | string | - | - | 白名单域名过滤 | | search_recency_filter | enum | - | noLimit | oneDay/oneWeek/oneMonth/oneYear/noLimit | | content_size | enum | - | - | medium/high，控制内容长度 | | request_id | string | - | - | 唯一请求标识符 | | user_id | string | - | - | 终端用户 ID（6-128 字符） |
## 搜索引擎选择指南
| 引擎 | 用例 | |--------|----------| | search_std | 基础搜索，常规问答 | | search_pro | 高级搜索，需要更精准的结果 | | search_pro_sogou | 搜狗搜索，中国国内内容 | | search_pro_quark | 夸克搜索，特定场景 |
## 响应结构
```json { "id": "task-id", "created": 1704067200, "request_id": "request-id", "search_intent": [ { "query": "original query", "intent": "SEARCH_ALL", "keywords": "rewritten keywords" } ], "search_result": [ { "title": "title", "content": "content summary", "link": "result link", "media": "site name", "icon": "site icon", "refer": "reference number", "publish_date": "publish date" } ] } ```
## 环境要求
- 必须配置环境变量 `ZHIPU_API_KEY` - Python 3.7+ - requests 库
## 注意事项
1. search_query 应保持在 70 个字符以内 2. search_pro_sogou 的 count 必须为 10/20/30/40/50 3. 如果提供 user_id，其长度必须在 6-128 个字符之间 4. 搜索意图识别会增加响应时间，但能提高结果相关性