s_新手程序员

agent-webtool

通过 SDK、命令行或 MCP,为 agent 提供网页抓取与多引擎搜索。

Agent搜索MCP
更新于 · 3 分钟阅读

让 agent 获取网页资料

agent-webtool 提供两个操作:web_fetch 抓取网页并转换为 Markdown、纯文本或 HTML;web_search 并行查询百度、搜狗微信、头条和 DuckDuckGo,过滤不相关结果、按 URL 去重并合并排序。使用这些引擎不需要第三方搜索 API Key。

你可以在 Node.js / Bun 后端中导入 SDK,在终端运行命令,或以 stdio MCP server 接入支持 MCP 的客户端。三种入口共用抓取与搜索实现。

选择入口

使用边界

SDK 面向服务端,不是浏览器组件,也不包含模型或 agent loop。搜索可能遇到超时、验证码或页面结构变化;单个引擎失败时仍可返回其他引擎结果。离线测试通过不代表每个引擎在当前网络中都可访问。

默认拒绝私网地址,限制重定向和响应大小。网页内容属于外部资料,应用仍需决定如何引用、展示和使用结果。

版本

本指南面向已发布的 npm 0.8.2,提供 MCP SDK v2 / 2026-07-28 协议支持、结构化工具结果、取消和连接级来源隔离,并兼容五个旧协议版本。启动命令和 JavaScript SDK 返回类型保持一致;MCP 未知参数现在会被拒绝,详见 MCP 接入。查看 0.8.2 固定源码。

0.7.0 起提供 SDK 会话来源隔离 SourceContext、快照恢复和缓存容量修复。MCP 新能力需要 0.8.0,公开 0.7.1 不包含这次协议升级。

0.8.1 新增结构化网页结果 webFetchResult,返回 HTTP 状态、最终地址、标题和截断信息,并增强流式大小限制及取消;原 webFetch、CLI/MCP 输出保持兼容。见 SDK 指南。