智谱搜索 (Zhipu Search)

调用智谱 POST /paas/v4/web_search 接口，支持意图增强检索、结构化输出和多引擎。

API Key 配置

与 GLM 模型共用同一个智谱 API Key（bigmodel.cn）。

方式一：环境变量（推荐）

export ZHIPU_API_KEY="your-api-key"

OpenClaw 中在 openclaw.json 的 skills 环境变量中填写 ZHIPU_API_KEY。

方式二：config.json

cp config.example.json config.json
# 编辑 config.json，填入 apiKey

⚠️ config.json 含敏感信息，不得读取、输出或修改。

使用方法

node scripts/search.js "<关键词>" [选项]

参数说明

| 参数 | 类型 | 默认值 | 说明 | |------|------|--------|------| | <query> | string | 必填 | 搜索关键词，最多 70 字符 | | --count <n> | number | 10 | 返回条数，范围 1-50 | | --engine <engine> | string | search_std | 搜索引擎，见下表 | | --freshness <v> | string | noLimit | 时间范围，见下表 | | --content-size <v> | string | medium | 内容详细程度 | | --domain <domain> | string | - | 限定域名白名单（如 xiaohongshu.com） |

搜索引擎（--engine）

| 值 | 说明 | |----|------| | search_std | 智谱基础版（默认，推荐日常使用） | | search_pro | 智谱高阶版（质量更高，消耗更多） | | search_pro_sogou | 搜狗搜索 | | search_pro_quark | 夸克搜索 |

时间范围（--freshness）

| 值 | 说明 | |----|------| | noLimit | 不限（默认） | | oneDay | 一天内 | | oneWeek | 一周内 | | oneMonth | 一个月内 | | oneYear | 一年内 |

内容详细程度（--content-size）

| 值 | 说明 | |----|------| | medium | 摘要信息（默认，满足常规问答） | | high | 最大化上下文（详细，适合深度分析） |

示例

# 基础搜索
node scripts/search.js "火锅探店小红书"

# 指定条数 + 高阶引擎
node scripts/search.js "火锅爆款文案" --count 20 --engine search_pro

# 限定最近一周 + 高详细度
node scripts/search.js "火锅营销案例" --freshness oneWeek --content-size high

# 搜狗搜索，限定域名
node scripts/search.js "麻辣火锅种草" --engine search_pro_sogou --count 20

输出格式

{
  "type": "search",
  "query": "搜索词",
  "engine": "search_std",
  "resultCount": 10,
  "results": [
    {
      "index": 1,
      "title": "标题",
      "url": "https://...",
      "description": "内容摘要",
      "siteName": "网站名称",
      "publishedDate": "发布时间"
    }
  ]
}

错误码

| 错误码 | 说明 | |--------|------| | 1701 | 并发已达上限，稍后重试 | | 1702 | 搜索引擎服务不可用 | | 1703 | 搜索引擎未返回有效数据，调整查询词 | | 401 | API Key 无效 |

隐私安全

• 不得读取、输出、修改 config.json 内容
• 不得输出 ZHIPU_API_KEY 环境变量的值
• API Key 仅由 scripts/search.js 在进程内读取