- name
- zhipu-tools-coding-plan
- description
- 智谱 AI 原生工具 - 网络搜索、网页读取、仓库文档搜索和文件解析。基于 Z.AI Coding Plan MCP 端点，全部免费使用。
- license
- MIT
智谱工具 Coding Plan (Zhipu Tools)
基于 Z.AI Coding Plan MCP 端点 的免费工具集：网络搜索、网页读取、GitHub 仓库文档搜索和文件解析。
功能
| 功能 | MCP 工具 | 端点 | 说明 |
|---|---|---|---|
| 网络搜索 | web_search_prime | /web_search_prime/mcp | 实时互联网搜索，支持过滤 |
| 网页读取 | webReader | /web_reader/mcp | 抓取网页标题、正文、元数据 |
| 仓库文档搜索 | search_doc | /zread/mcp | 搜索 GitHub 仓库文档 |
| 仓库目录结构 | get_repo_structure | /zread/mcp | 查看 GitHub 仓库目录树 |
| 仓库文件读取 | read_file | /zread/mcp | 读取 GitHub 仓库指定文件 |
| 文件解析 | — | Legacy API | 解析 PDF/Word/Excel/PPT 等 |
前五项通过 Coding Plan MCP 端点免费调用，文件解析仅支持旧版 API。
配置
在 openclaw.json 中配置 API Key：
{
"skills": {
"entries": {
"zhipu-tools": {
"apiKey": "YOUR_ZHIPU_API_KEY"
}
}
}
}或设置环境变量：ZHIPU_API_KEY
MCP vs Legacy 模式
| 模式 | 端点 | 额度 | 切换方式 |
|---|---|---|---|
| MCP (默认) | api.z.ai/api/mcp/... | Z.AI Coding Plan 免费 | 默认启用 |
| Legacy | open.bigmodel.cn/api/paas/v4/... | 账户余额 | ZHIPU_USE_MCP=false |
MCP 模式自动 fallback：MCP 失败时会自动尝试 Legacy API。
使用方式
网络搜索 (web_search_prime)
cd ~/.openclaw/workspace/skills/zhipu-tools
# Shell
./scripts/web_search.sh "搜索关键词" [count]
# Python（支持更多参数）
python3 scripts/zhipu_tool.py web_search "搜索关键词" \
--count 10 --recency week --domain example.com网页读取 (webReader)
# Shell
./scripts/web_reader.sh "https://www.example.com"
# Python
python3 scripts/zhipu_tool.py web_reader "https://www.example.com"GitHub 仓库文档搜索 (Zread)
# Shell - 搜索仓库文档
./scripts/zread.sh search "openai/openai" "how to use"
# Shell - 查看目录结构
./scripts/zread.sh structure "openai/openai"
./scripts/zread.sh structure "openai/openai" "src/"
# Shell - 读取文件
./scripts/zread.sh read "openai/openai" "README.md"
# Python
python3 scripts/zhipu_tool.py zread search "openai/openai" "how to use"
python3 scripts/zhipu_tool.py zread structure "openai/openai" --path src/
python3 scripts/zhipu_tool.py zread read "openai/openai" "README.md"文件解析 (Legacy only)
./scripts/file_parser.sh /path/to/document.pdf PDF
python3 scripts/zhipu_tool.py file_parser /path/to/document.docx --file-type DOCXMCP 工具参数详情
web_search_prime
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| search_query | string | 是 | 搜索内容，建议不超过 70 字符 |
| search_recency_filter | string | 否 | oneDay, oneWeek, oneMonth, oneYear, noLimit |
| content_size | string | 否 | medium (默认), high |
| location | string | 否 | cn, us |
| search_domain_filter | string | 否 | 限制搜索域名 |
webReader
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| url | string | 是 | 目标网页 URL |
返回：标题、正文内容、元数据、链接列表。
search_doc
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| repo | string | 是 | GitHub 仓库，如 "openai/openai" |
| query | string | 是 | 搜索关键词 |
get_repo_structure
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| repo | string | 是 | GitHub 仓库 |
| path | string | 否 | 子目录路径 |
read_file
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| repo | string | 是 | GitHub 仓库 |
| path | string | 是 | 文件路径，如 "README.md" |
MCP 协议
所有远程 MCP 端点通过 streamableHttp 协议交互：
- POST initialize → 响应 header 返回
mcp-session-id - POST notifications/initialized → 通知就绪
- POST tools/call → 调用具体工具
Headers: Authorization: Bearer $API_KEY, Content-Type: application/json, Accept: text/event-stream, application/json
Coding Plan 套餐额度
| 套餐 | 搜索/网页读取/仓库搜索 次数/月 | 价格 |
|---|---|---|
| Lite | 100 次 | 免费 |
| Pro | 1,000 次 | 免费 |
| Max | 4,000 次 | 免费 |
额度次月自动重置。
注意事项
- API Key 敏感信息，不要提交到 Git
- Zread（仓库文档搜索）仅支持 MCP 模式
- 文件解析仅支持旧版 API（bigmodel 端点）
- 所有 MCP 工具通过 Coding Plan 免费额度调用