zhipu-search

⚠Review·Scanned 2/19/2026

Provides a Zhipu AI web-search client implemented as scripts/zhipu_search.py. It instructs running python scripts/zhipu_search.py, reads the ZHIPU_API_KEY env var, and posts to https://open.bigmodel.cn/api/paas/v4/chat/completions.

from clawhub.ai·vd6ce0be·14.3 KB·0 installs

Scanned from 1.0.4 at d6ce0be · Transparency log ↗

$ vett add clawhub.ai/whyhit2005/zhipu-searchReview findings below

Zhipu Search

Web search via Zhipu AI API, supporting multiple search engines and flexible parameter configuration.

Quick Start

Basic Search

# Use default parameters
search_query = "OpenClaw latest version"
search_engine = "search_std"

Advanced Search (Full Parameters)

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)

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

{
  "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

search_query should be kept within 70 characters
search_pro_sogou count must be 10/20/30/40/50
user_id length must be between 6-128 characters if provided
Search intent recognition increases response time but improves result relevance