Web-Rooter：基于 IR + Lint 模式的 AI Agent 联网工具

2.2 验证安装

wr --version
wr doctor
wr help

重要：安装后默认入口是 wr，不是 python main.py。

python main.py 仅用于源码调试和开发兜底。

2.3 系统要求

• Python 3.10+
• 网络访问（用于 Playwright Chromium 运行时下载）
• 推荐：Git

三、技术架构：CLI 是一等接口，MCP 只是适配层

从源码分析，Web-Rooter 采用分层架构设计：

┌─────────────────────────────────────────────────┐
│ Interface Layer (接口层)                        │
│ main.py / tools/ / scripts/                     │
│ CLI / MCP / HTTP Server 启动分发                 │
├─────────────────────────────────────────────────┤
│ Orchestration Layer (编排层)                    │
│ agents/web_agent.py                             │
│ 任务编排：visit/search/research/crawl           │
├─────────────────────────────────────────────────┤
│ Capability Layer (能力层)                       │
│ core/crawler.py, browser.py, search/*           │
│ HTTP 抓取、浏览器自动化、搜索引擎聚合            │
├─────────────────────────────────────────────────┤
│ Configuration Layer (配置层)                    │
│ config.py, core/engine-config/*.json            │
│ 全局运行参数、引擎配置                          │
├─────────────────────────────────────────────────┤
│ Validation Layer (验证层)                       │
│ wr doctor, ir-lint, safe-mode                   │
│ 环境检查、IR 语法验证、安全模式                  │
└─────────────────────────────────────────────────┘

这个设计的精妙之处在于：

1. CLI 是一等接口，MCP 只是适配层。很多 MCP 项目本末倒置，把 MCP 当成主入口，CLI 当成调试工具。Web-Rooter 反其道而行——CLI 是核心，MCP 只是让 Claude/Cursor 能调用 CLI 的适配器。这意味着即使 MCP 协议变了，核心功能不受影响。
2. 配置层支持热扩展。通过环境变量可以动态加载：
   • WEB_ROOTER_CHALLENGE_PROFILE_DIR：Cloudflare 挑战配置文件
   • WEB_ROOTER_AUTH_PROFILE_DIR：登录态配置文件
   • WEB_ROOTER_POSTPROCESSORS：抓取后处理扩展

四、MCP 工具：覆盖 AI 联网的全场景

截至本文编写，最新的 Web-Rooter 版本暴露了 28 个 MCP 工具，这是目前 MCP 生态中工具最丰富的项目之一：

4.1 基础工具

4.2 搜索工具（核心）

4.3 垂直领域工具（差异化优势）

4.4 运维工具（生产级思维）

使用建议：

1. web_workflow_schema（先拿能力边界）
2. web_workflow_template（生成本地模板并按任务修改）
3. web_workflow_run（一次执行可组合流程）
4. 细粒度调试时再用 web_search_internet / web_fetch / web_extract / web_crawl

五、CLI 命令全集：按场景分层设计

5.1 核心命令

wr help
wr --version
wr doctor
wr do <任务>[--skill=name][--dry-run][--strict][--js][--top=N][--crawl-assist][--crawl-pages=N][--command-timeout-sec=N][--html-first|--no-html-first]
wr do-plan <任务>[--skill=name][--strict][--js][--top=N][--crawl-assist][--crawl-pages=N][--html-first|--no-html-first]
wr do-submit <任务>[--skill=name][--strict][--js][--top=N][--crawl-assist][--crawl-pages=N][--timeout-sec=N][--html-first|--no-html-first]

5.2 作业管理

wr jobs[--limit=N][--status=queued|running|completed|failed]
wr jobs-clean [--keep=N][--days=N][--all]
wr job-status <job_id>[--with-result]
wr job-result <job_id>

5.3 快速查询

wr quick <查询>[--js][--top=N][--crawl-pages=N][--strict][--command-timeout-sec=N]
wr visit <URL>[--js]
wr html <URL>[--js][--max-chars=N][--no-fallback]

5.4 搜索与研究

wr web <查询>[--no-crawl][--crawl-pages=N][--num-results=N][--engine=name|a,b]
wr deep <查询>[--en][--crawl=N][--num-results=N][--variants=N][--engine=name|a,b][--news][--platforms][--commerce][--channel=x,y]
wr mindsearch <查询>[--turns=N][--branches=N][--num-results=N][--crawl=N][--planner=name][--strict-expand][--channel=x,y]

5.5 垂直领域

wr social [--platform=xiaohongshu|zhihu|tieba|douyin|bilibili|weibo|reddit|twitter]
wr shopping [--platform=taobao|jd|pinduoduo|meituan]
wr academic [--papers-only|--with-code][--no-abstracts][--num-results=N][--source=xxx]
wr crawl <URL>[pages][depth][--pattern=REGEX][--allow-external][--no-subdomains]

5.6 工作流与扩展

wr workflow-schema
wr workflow-template [path][--scenario=social_comments|academic_relations][--force]
wr workflow <path>[--var key=value][--set key=value][--strict][--dry-run]
wr processors [--load=module:object][--force]
wr planners [--load=module:object][--force]
wr challenge-profiles
wr auth-profiles
wr auth-hint
wr auth-template [path][--force]

5.7 运维观测

wr context [--limit=N][--event=type]
wr telemetry [--no-refresh]
wr pressure [--no-refresh]
wr events [--limit=N][--event=type][--source=name][--since=seq]
wr artifact [--nodes=N][--edges=N][--kind=page|url|domain|request|session]
wr safe-mode [status|on|off][--policy=strict]
wr skills [--resolve "<目标>"][--compact|--full]
wr ir-lint <IR/JSON>

六、总结

在当前环境下，"可追溯、可审计"正在成为生产环境的刚需。Web-Rooter 用一套简洁的 wr 命令，给出了一个优雅的答案：

• 不是让 AI"看起来答对"，而是让 AI"有执行链路、有引用、可审计"
• 不是堆砌功能，而是按 AI 的实际使用场景分层设计
• 不是玩具项目，而是有超时护栏、作业系统、预算控制的生产级工具

当然，Web-Rooter 也有局限：项目成熟度还在提升中，社区规模有限。但这些不是致命问题，而是成长中的烦恼。

如果你正在寻找一个轻量级的 AI 联网执行工具，并且重视"可追溯、可审计"，Web-Rooter 值得尝试。它可能不是最成熟的，但它代表了一种正确的方向——让 AI 的联网行为变得透明、可验证。