Zhipu Tools Coding Plan

---

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 DOCX

MCP 工具参数详情

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 协议交互：

1. POST initialize → 响应 header 返回 mcp-session-id 2. POST notifications/initialized → 通知就绪 3. 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 免费额度调用