概述

智谱 Web Search Skill

使用智谱 AI 的 Web Search API 进行网络搜索，获取实时、结构化的搜索结果。

前置条件

获取智谱 BigModel 开放平台的 API Key：https://bigmodel.cn/usercenter/apikeys
配置 API Key（见下方说明）

API Key 配置

在使用前，请设置您的智谱 API Key：

export ZHIPUAI_API_KEY="your-api-key-here"

重要: 请使用环境变量方式配置 API Key，不要将密钥硬编码在脚本或配置文件中。

快速开始

使用提供的 search_util.py 脚本进行搜索：

# 基本搜索
python search_util.py "搜索内容"

# 查看帮助
python search_util.py --help

搜索引擎选项

引擎编码	说明
---------	------
`search_std`	智谱基础版搜索引擎
`search_pro`	智谱高阶版搜索引擎（推荐）
`search_pro_sogou`	搜狗搜索
`search_pro_quark`	夸克搜索

搜索参数

参数	类型	必填	说明
-----	------	------	------
`search_query`	String	是	搜索内容，建议不超过 70 字符
`search_engine`	String	是	搜索引擎编码
`search_intent`	Boolean	是	是否进行意图识别
`count`	Int	否	返回结果条数 (1-50, 默认 10)
`search_recency_filter`	String	否	时间筛选: oneDay/oneWeek/oneMonth/oneYear/noLimit
`content_size`	String	否	内容长度: medium/high
`search_domain_filter`	String	否	限定域名

API 概览

请求地址: https://open.bigmodel.cn/api/paas/v4/web_search

认证方式: 使用智谱 API Key，通过 Authorization header 传递

响应结构

{
  "id": "任务ID",
  "created": 1748261757,
  "search_intent": [
    {
      "query": "原始搜索query",
      "intent": "SEARCH_ALL|SEARCH_NONE|SEARCH_ALWAYS",
      "keywords": "改写后的搜索关键词"
    }
  ],
  "search_result": [
    {
      "title": "标题",
      "content": "内容摘要",
      "link": "结果链接",
      "media": "网站名称",
      "icon": "网站图标",
      "refer": "角标序号",
      "publish_date": "网站发布时间"
    }
  ]
}

工作流程

确认用户已配置 API Key
根据用户需求选择合适的搜索参数
执行搜索并以友好格式展示结果（标题、来源、日期、链接、摘要）

错误码

错误码	说明
-------	------
1701	网络搜索并发已达上限，请稍后重试
1702	系统未找到可用的搜索引擎服务
1703	搜索引擎未返回有效数据，请调整查询条件

版本历史

共 1 个版本

v1.0.1 当前

2026-03-29 04:18 安全安全

安全检测

腾讯云安全 (Keen)

安全，无风险

查看报告

腾讯云安全 (Sanbu)