用途
webclaw 用于将网页内容转换为 LLM 可直接使用的干净数据,解决传统抓取工具要么返回被拦截页面、要么返回充满导航和广告的原始 HTML 的问题。它输出 Markdown、JSON 或适合 RAG 的上下文,供 AI 智能体和应用消费。
主要能力
- 抓取单页,返回 LLM 优化文本,可保留或排除指定选择器。
- 爬取文档站点、映射站点结构。
- 提取结构化数据、品牌资产。
- 总结内容、对比页面随时间的变化。
- 支持搜索功能。
- 使用 TLS 指纹技术绕过反机器人检查,无需浏览器。
- 本地优先:核心提取路径无需账号即可在本地运行。
- 托管 API 提供受保护站点访问、JavaScript 渲染、异步爬取和研究任务、监控和生产用量追踪,以及应用代码的 SDK。
使用方式
安装
- 预构建二进制:从 GitHub Releases 下载 macOS、Linux、Windows 二进制,ZIP 包无需 Rust。在 v0.6.22 发布页下载 webclaw-v0.6.22-x86_64-pc-windows-msvc.zip,解压后在包含 webclaw.exe 的文件夹打开 PowerShell 运行(PowerShell 需使用 .\ 前缀)。如需在其他文件夹运行,将该目录加入用户 PATH。若 Windows 提示缺少 Visual C++ 运行时 DLL,安装 Microsoft Visual C++ Redistributable for x64。ZIP 包含 x64 二进制,Windows ARM64 不在原生安装检查范围内。
- 从源码构建(Windows):安装 Rust(x86_64-pc-windows-msvc 工具链)、Visual Studio Build Tools(含 Desktop development with C++ 和 Windows SDK)、Git、CMake 3.22 或更新、LLVM(含 libclang.dll)、NASM。安装后打开新的 Developer PowerShell for Visual Studio。确保 CMake 和 NASM 在 PATH 中,若 bindgen 找不到 libclang,设置 LIBCLANG_PATH 指向 LLVM bin 目录。Cargo 包名为 webclaw-cli,可执行文件为 webclaw。这些包从 Git 安装,不是从 crates.io。首次源码构建可能需要几分钟。Windows CI 工作流在托管运行器上检查 Git 安装和已发布 ZIP,不代表干净 PC。Linux 容器(包括 macOS 上的 Docker)不验证 Windows 支持。若源码构建因缺少原生构建工具失败,安装平台先决条件。
- MCP 服务器零安装:将任何 MCP 客户端指向 npx 启动器。或运行 npx create-webclaw 自动检测 AI 工具并写入配置。
- 作为智能体技能:一条命令将 webclaw 加入 Claude Code、Cursor、Windsurf 等 MCP 智能体。智能体获得 scrape、crawl、map、extract、summarize、diff、brand、search 作为原生工具。大多数站点本地提取无需 API 密钥。设置 WEBCLAW_API_KEY 可处理受机器人保护和 JavaScript 渲染的页面。可在 skills.sh 找到。
使用场景
- 终端使用:抓取一页、爬取文档站点。
- 通过 MCP 接入 Claude/Cursor。
- 从应用调用托管 API。
- 自托管 OSS 服务器。
- 工作流示例:HTML 转 Markdown 用于 RAG、兼容 Firecrawl 的 API、MCP 网页抓取、使用 ColdProxy 的代理爬取、Cloudflare 诊断、提取品牌资产、对比页面变化。
适用场景
- AI 智能体和 RAG 流水线需要干净网页上下文。
- 需要绕过反机器人检查的网页抓取。
- 文档站点爬取和结构化数据提取。
限制
- 核心提取本地无需账号,但受保护站点访问、JavaScript 渲染、异步任务等需要托管 API。
- Windows ARM64 不在原生安装检查范围内。
- 源码构建需要多种原生工具,首次构建耗时较长。
- 关于收费、价格等具体信息暂未提供。
社区与贡献
webclaw-core 是纯提取逻辑,无网络 I/O,可独立于获取层使用。欢迎贡献实际且小的改进,如添加真实智能体和 RAG 工作流示例、改进 SDK 片段、报告提取效果差的页面、为混乱 HTML 添加失败测试用例、改进 MCP 客户端和本地设置文档、在更多 Linux/macOS 环境测试 CLI。报告页面提取问题时请附上相关信息,发布前请移除日志中的密钥、Cookie、私有令牌和客户数据。