核心用法
Zhipu Search 是一个基于 cURL 的轻量级 Web 搜索工具，通过调用 Zhipu AI 的 /paas/v4/web_search API 实现网络信息检索。用户只需配置 ZHIPU_API_KEY 环境变量即可使用，无需安装 Python 或 jq 等额外依赖。
主要功能包括：
- 多引擎支持：Quark（默认）、Sogou、标准搜索、高级搜索四种模式
- 智能过滤：支持按时间范围（一天/一周/一月/一年）和域名白名单筛选结果
- 意图识别：可选开启搜索意图识别，优化查询理解
- 灵活输出：控制结果数量（1-50条）和详细程度（摘要/详细）
使用示例
基础调用：
curl -X POST https://open.bigmodel.cn/api/paas/v4/web_search \
-H "Authorization: Bearer $ZHIPU_API_KEY" \
-H "Content-Type: application/json" \
-d '{"search_query": "关键词", "search_engine": "search_pro_quark"}'脚本封装：提供 zhipu_search.sh 脚本简化常用参数组合。
显著优点
1. 零依赖部署：纯 cURL 实现，兼容几乎所有 Unix/Linux/macOS 环境
2. 中文优化：Quark 和 Sogou 引擎针对中文内容深度优化
3. API 响应结构化：返回标准 JSON，包含标题、摘要、链接、发布时间等完整字段
4. 成本可控：按调用量计费，无固定订阅费用
潜在缺点与局限性
- 环境变量依赖：必须配置
ZHIPU_API_KEY，密钥管理需自行负责 - 网络限制：服务托管于国内，海外访问可能存在延迟
- 结果质量波动：搜索引擎结果受源站 SEO 影响，非学术级可靠性
- 无本地缓存：每次调用均为实时请求，高频场景需考虑配额
适合人群
- 需要快速集成搜索功能的开发者/运维人员
- 偏好命令行工作流的技术用户
- 中文信息检索场景为主的研究者
- 构建 AI Agent 或自动化工作流的工程师
常规风险
| 风险类型 | 说明 |
|---------|------|
| API 密钥泄露 | `ZHIPU_API_KEY` 需妥善保管，避免硬编码或误提交至代码仓库 |
| 成本失控 | 高频调用可能导致意外费用，建议设置用量告警 |
| 内容合规 | 搜索结果来自互联网，需自行过滤敏感或侵权内容 |
| 服务可用性 | 依赖 Zhipu AI 服务稳定性，生产环境建议设计降级策略 |