核心功能
智谱工具 Coding Plan 是基于 Z.AI Coding Plan MCP 端点的开源工具集，提供五大核心能力：
1. 网络搜索 (web_search_prime)：实时互联网搜索，支持时间范围、域名过滤、结果数量控制
2. 网页读取 (webReader)：智能抓取网页正文、标题、元数据，自动提取链接
3. GitHub 仓库文档搜索 (search_doc)：针对开源项目文档的语义搜索
4. 仓库目录结构浏览 (get_repo_structure)：查看任意 GitHub 仓库的文件树
5. 仓库文件读取 (read_file)：直接获取 GitHub 指定文件内容
此外提供两项 Legacy API 功能：视觉理解（GLM-4.6V 图像分析）和文件解析（PDF/Office 文档），但需注意后者非 MCP 原生支持。
显著优点
| 维度 | 优势 |
|------|------|
| **成本** | Coding Plan MCP 端点完全免费，Pro 套餐 1000 次/月，Max 套餐 4000 次/月 |
| **集成度** | 原生 MCP 协议支持，与 Claude、Cursor 等 AI 编辑器无缝集成 |
| **覆盖度** | 搜索+网页+仓库三合一，满足开发者 90% 信息检索场景 |
| **易用性** | 同时提供 Shell 脚本和 Python CLI 两种调用方式 |
| **可靠性** | MCP 失败自动 fallback 到 Legacy API，双重保障 |
潜在局限与风险
⚠️ 视觉理解功能采用逆向工程实现：官方未提供视觉 MCP 端点（返回 404），开发者从 @z_ai/mcp-server npm 包源码中提取了底层 API 调用逻辑（open.bigmodel.cn/api/paas/v4/chat/completions + glm-4.6v）。当前测试显示可能走 Coding Plan 资源池，但不能保证长期免费，智谱随时可能调整计费策略或封禁此类调用方式。
⚠️ 文件解析仅支持 Legacy API：无法享受 MCP 免费额度，需消耗账户余额。
⚠️ Zread 仓库功能仅限 MCP 模式：若强制切换 Legacy 模式将不可用。
⚠️ API Key 安全：需配置 ZHIPU_API_KEY，存在密钥泄露风险，切勿提交至 Git。
适合人群
- AI 应用开发者：需要为 Agent 集成免费、稳定的搜索与文档检索能力
- 开源项目维护者：快速查阅其他仓库文档、对比实现方案
- 技术写作者：实时获取最新技术资讯，验证信息准确性
- 预算敏感团队：替代 Google Custom Search、Bing Search API 等付费服务
常规风险提示
1. 服务连续性：视觉理解功能依赖非官方支持的调用方式，存在随时失效风险
2. 额度监控：虽标注免费，但建议定期查看智谱账户用量，防止策略变更
3. 数据隐私：网页搜索和仓库读取可能涉及第三方内容，需遵守相关服务条款
4. 功能边界：复杂 JavaScript 渲染的网页可能无法完整抓取，需结合具体情况验证