Introduction
# Zhipu Search
Web search via Zhipu AI API, supporting multiple search engines and flexible parameter configuration.
## Quick Start
### Basic Search
```python # Use default parameters search_query = "OpenClaw latest version" search_engine = "search_std" ```
### Advanced Search (Full Parameters)
```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) ```
## Usage Methods
### Method 1: Direct Script Call (Recommended)
```bash python scripts/zhipu_search.py \ --query "search content" \ --engine search_pro \ --count 10 ```
### Method 2: Use OpenClaw Tool
System will automatically select appropriate parameters based on needs.
## API Parameter Reference
| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | search_query | string | ✅ | - | Search content, recommended ≤70 chars | | search_engine | enum | ✅ | - | search_std/search_pro/search_pro_sogou/search_pro_quark | | search_intent | boolean | - | false | Enable search intent recognition | | count | integer | - | 10 | Result count, 1-50 | | search_domain_filter | string | - | - | Whitelist domain filter | | search_recency_filter | enum | - | noLimit | oneDay/oneWeek/oneMonth/oneYear/noLimit | | content_size | enum | - | - | medium/high, control content length | | request_id | string | - | - | Unique request identifier | | user_id | string | - | - | End user ID (6-128 chars) |
## Search Engine Selection Guide
| Engine | Use Case | |--------|----------| | search_std | Basic search, regular Q&A | | search_pro | Advanced search, need more accurate results | | search_pro_sogou | Sogou search, China domestic content | | search_pro_quark | Quark search, specific scenarios |
## Response Structure
```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" } ] } ```
## Environment Requirements
- Environment variable `ZHIPU_API_KEY` must be configured - Python 3.7+ - requests library
## Notes
1. search_query should be kept within 70 characters 2. search_pro_sogou count must be 10/20/30/40/50 3. user_id length must be between 6-128 characters if provided 4. Search intent recognition increases response time but improves result relevance