核心用法
zhipu-search 是一款调用智谱 AI 官方 Web Search API 的网络搜索技能，通过环境变量配置 ZHIPU_API_KEY 后即可使用。支持两种调用方式：直接使用 curl 命令构造 POST 请求，或运行封装好的 search.sh 脚本。搜索指令以 "搜索: 关键词" 格式触发，模型 glm-4-flash 会自动调用 web_search 工具返回联网检索结果，最后通过 jq 提取并格式化输出内容。
显著优点
1. 官方 API 保障：直接对接智谱 open.bigmodel.cn 官方端点，数据权威性和服务稳定性有保障
2. 安全设计完善：使用 jq --arg 进行 JSON 转义防止注入攻击，输入长度限制在 500 字符以内，强制 TLS 1.2+ 加密传输
3. 零依赖轻量化：仅依赖系统原生工具 curl 和 jq，无第三方包引入供应链风险
4. 合规意识到位：API Key 通过环境变量获取避免硬编码，符合 GDPR/CCPA 数据最小化原则
5. 实时信息获取：突破大模型知识截止时间限制，可获取最新新闻、动态和当前事件
潜在缺点与局限性
1. 进程可见性风险：API Key 通过环境变量传递时可能在 ps aux 进程列表中暴露，共享环境需谨慎
2. 功能边界有限：仅支持基础搜索，无高级筛选、结果排序、多语言指定等扩展功能
3. 网络依赖性强：完全依赖外部 API 可用性，无本地缓存或离线 fallback 机制
4. 输出格式固定：返回内容为模型生成的自然语言总结，非结构化原始搜索结果
5. 速率与成本限制：实际使用受限于智谱 API 调用配额和计费策略
适合的目标群体
- 需要获取最新资讯和实时信息的 AI Agent 用户
- 构建问答系统、智能助手的开发者，需弥补大模型知识时效缺口
- 对代码安全性有基础要求、偏好轻量级工具的技术团队
- 已拥有或愿意注册智谱 AI 账号、能接受按量计费模式的个人或组织
使用风险说明
- 性能风险：网络请求超时设置为 30 秒，弱网环境可能出现响应延迟或失败
- 密钥泄露风险：除进程列表可见外，环境变量误提交至版本控制的历史风险需用户自行管控
- 服务连续性：依赖智谱 AI 平台服务状态，建议关注官方运维公告
- 数据隐私：搜索关键词会上传至智谱服务器，敏感信息检索需评估合规要求
- 结果准确性：AI 生成的搜索总结可能存在理解偏差，关键决策建议二次核实来源