名称： zhipu-search
描述： |
智谱 AI 网页搜索工具 - 提供灵活的搜索引擎能力。

适用于以下场景：
- 需要搜索网络信息以获取最新数据
- 需要使用特定搜索引擎（搜狗、夸克、智谱搜索）
- 需要按时间范围或域名筛选搜索结果
- 需要控制结果数量和详细程度

支持的搜索引擎：search_std（基础版）、search_pro（高级版）、search_pro_sogou（搜狗）、search_pro_quark（夸克）
支持的参数：搜索意图识别、结果数量、时间筛选、域名筛选、内容长度控制
元数据：
{
"openclaw":
{
"requires": { "env": ["ZHIPU_API_KEY"] },
},
}

智谱搜索

通过智谱 AI API 进行网页搜索，支持多种搜索引擎和灵活的参配置。

快速开始

基础搜索

# 使用默认参数
search_query = "OpenClaw 最新版本"
search_engine = "search_std"

高级搜索（完整参数）

search_query = "AI 发展趋势"                # 必填，最多 70 个字符
search_engine = "search_pro"                # 必填：search_std/search_pro/search_pro_sogou/search_pro_quark
search_intent = true                        # 可选，默认 false，启用搜索意图识别
count = 20                                  # 可选，默认 10，范围 1-50
search_domain_filter = "example.com"        # 可选，白名单域名筛选
search_recency_filter = "oneWeek"           # 可选：oneDay/oneWeek/oneMonth/oneYear/noLimit
content_size = "high"                       # 可选：medium/high，控制内容详细程度
request_id = "unique-request-id"            # 可选，唯一请求标识符
user_id = "user-123456"                     # 可选，终端用户 ID（6-128 字符）

使用方法

方法一：直接脚本调用（推荐）

python scripts/zhipu_search.py \
  --query "搜索内容" \
  --engine search_pro \
  --count 10

方法二：使用 OpenClaw 工具

系统会根据需求自动选择合适的参数。

API 参数参考

搜索引擎选择指南

响应结构

{
  "id": "task-id",
  "created": 1704067200,
  "request_id": "request-id",
  "search_intent": [
    {
      "query": "原始查询",
      "intent": "SEARCH_ALL",
      "keywords": "改写后的关键词"
    }
  ],
  "search_result": [
    {
      "title": "标题",
      "content": "内容摘要",
      "link": "结果链接",
      "media": "网站名称",
      "icon": "网站图标",
      "refer": "引用编号",
      "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. 搜索意图识别会增加响应时间，但能提高结果相关性