← 返回 Skills 市场
Zhipu AI Search
作者
Felix Syangli
· GitHub ↗
· v1.0.1
899
总下载
0
收藏
4
当前安装
2
版本数
在 OpenClaw 中安装
/install another-zhipu-web-search
功能描述
使用智谱 Web Search API 进行网络搜索。当用户需要搜索最新信息、查找实时数据、查询新闻、研究某个话题或获取网络上的信息时使用。支持多种搜索引擎（智谱基础版/高阶版、搜狗、夸克），可配置搜索范围、时间筛选、结果数量等参数。
使用说明 (SKILL.md)
智谱 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 | 搜索引擎未返回有效数据，请调整查询条件 |
更多信息
安全使用建议
This skill appears to do what it claims: call 智谱/BigModel's web_search API and present results. Before installing, be sure you are comfortable providing a ZHIPUAI_API_KEY (the script uses it in an Authorization header). Note the registry metadata did not list this required env var — verify the platform will prompt you to supply ZHIPUAI_API_KEY and not leave it undocumented. As with any third-party skill, only supply API keys you trust and consider using a limited-scope key if the provider supports it. Finally, install the dependency (httpx) in a controlled environment (virtualenv) before running the script.
功能分析
Type: OpenClaw Skill
Name: another-zhipu-web-search
Version: 1.0.1
The skill bundle is designed for web searching via the Zhipu AI API. The `search_util.py` script correctly uses `httpx` to make API calls, passing user inputs as JSON payload data, which prevents shell or command injection. API keys are securely handled via environment variables. The `SKILL.md` and `README.md` files provide clear, benign instructions without any prompt injection attempts. Permissions in `.claude/settings.json` are appropriate for executing a Python script. No evidence of data exfiltration, malicious execution, or persistence was found.
能力评估
Purpose & Capability
The skill is described as a web search wrapper for 智谱 (BigModel) and the shipped script (search_util.py), SKILL.md, and README implement exactly that (HTTP POST to open.bigmodel.cn web_search). However, the registry metadata claims no required environment variables while SKILL.md and the script require ZHIPUAI_API_KEY — a metadata inconsistency that should be corrected.
Instruction Scope
SKILL.md confines runtime behavior to obtaining a ZHIPUAI_API_KEY, constructing search requests, and printing structured results. It does not instruct reading unrelated files, scanning system state, or exfiltrating data to third-party endpoints; the only external endpoint is the documented BigModel API.
Install Mechanism
No install spec (instruction-only) is present, which minimizes risk. A small requirements.txt references httpx from PyPI — expected for making HTTP requests. There are no downloads from arbitrary URLs or archive extraction steps in the repo.
Credentials
The only secret the skill needs is ZHIPUAI_API_KEY, which is proportional to its stated purpose. Note again the registry metadata omission: the central registry entry lists no required env vars while SKILL.md and the script require the API key.
Persistence & Privilege
The skill does not request always:true and does not modify other skills or global agent settings. .claude/settings.json grants Bash/python invocation permissions (expected for a Python script). Autonomous invocation is allowed by default but is not unusually privileged here.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install another-zhipu-web-search - 安装完成后，直接呼叫该 Skill 的名称或使用
/another-zhipu-web-search触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.1
In summary, we have fixed all the potential risks flagged by the ClawHub website to ensure the project won't be marked with a suspicious status.
- Removed development files: search_util.py and SKILL.md from internal skill path.
- Updated documentation to require the ZHIPUAI_API_KEY environment variable and removed instructions for hardcoding API keys.
- Adjusted example commands to reflect the new script location.
v1.0.0
Initial release of zhipu-search skill.
- Provides web search capabilities using Zhipu Web Search API.
- Supports multiple search engines (Zhipu basic/pro, Sogou, Quark) and configurable parameters (scope, time filter, result count, etc.).
- Includes setup instructions for API Key authentication.
- Offers Bash tool and usage guides for quick search.
- Documents API endpoints, request/response structure, and error codes.
元数据
常见问题
Zhipu AI Search 是什么？
使用智谱 Web Search API 进行网络搜索。当用户需要搜索最新信息、查找实时数据、查询新闻、研究某个话题或获取网络上的信息时使用。支持多种搜索引擎（智谱基础版/高阶版、搜狗、夸克），可配置搜索范围、时间筛选、结果数量等参数。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 899 次。
如何安装 Zhipu AI Search？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install another-zhipu-web-search」即可一键安装，无需额外配置。
Zhipu AI Search 是免费的吗？
是的，Zhipu AI Search 完全免费（开源免费），可自由下载、安装和使用。
Zhipu AI Search 支持哪些平台？
Zhipu AI Search 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Zhipu AI Search？
由 Felix Syangli（@xianglifei）开发并维护，当前版本 v1.0.1。
推荐 Skills