核心用法
Zhipu Web Search 是智谱AI提供的官方网页搜索API封装技能，通过纯cURL实现零依赖调用，无需Python或jq等工具。核心功能包括：
- 多引擎切换：默认使用
search_pro_quark（夸克搜索），可选search_std（基础）、search_pro（高级）、search_pro_sogou（搜狗） - 智能参数控制：支持
search_intent意图识别、search_recency_filter时间过滤（1天/1周/1月/1年）、search_domain_filter域名白名单 - 结果精调：
count控制1-50条结果，content_size切换摘要/详细模式
使用场景
1. 实时信息获取：突破大模型知识截止日期，获取最新数据
2. 国内内容优先：搜狗引擎针对中文互联网优化
3. 精准溯源：通过refer引用编号和publish_date支持事实核查
显著优点
| 维度 | 优势 |
|------|------|
| **轻量化** | 纯Shell/cURL实现，无运行时依赖，适合嵌入式环境 |
| **官方背书** | 直接调用智谱AI官方API（`open.bigmodel.cn`），非第三方爬虫 |
| **结构化输出** | 返回标准JSON，含标题、摘要、链接、媒体来源、发布时间等完整字段 |
| **意图识别** | `search_intent`可自动扩展查询词，提升召回率 |
潜在局限
- API Key依赖：必须配置
ZHIPU_API_KEY，且消耗智谱API额度 - 结果可控性：搜索质量受底层引擎（夸克/搜狗）算法影响，无法自定义排序
- 无缓存机制：每次调用均走网络请求，高频使用成本较高
- 内容长度限制：
search_query建议≤70字符，复杂查询需手动拆解
适合人群
- 需要实时联网能力的AI应用开发者
- 构建RAG系统需结构化搜索结果的工程师
- 追求最小化依赖的运维/自动化场景
- 侧重中文内容的国内业务场景
常规风险
| 风险类型 | 说明 | 缓解建议 |
|----------|------|----------|
| API密钥泄露 | `ZHIPU_API_KEY`以环境变量传递，存在进程暴露风险 | 使用专用密钥、限制IP白名单、定期轮换 |
| 搜索结果偏差 | 引擎算法可能存在商业推广或时效性偏见 | 多引擎交叉验证、启用时间过滤 |
| 合规风险 | 爬取内容需遵守目标网站Robots协议及版权规范 | 遵守`search_domain_filter`白名单机制 |
| 服务可用性 | 依赖智谱AI服务端稳定性 | 实现熔断重试逻辑 |