Surf CLI — Control Chrome for AI Agents (No MCP)

简介

Surf CLI 通过“本地扩展 + native host”让 AI Agent 控制 Chrome：零配置、agent-agnostic，不需要单独起 MCP server，适合把浏览器当作通用工具接口。

• 适合谁： 需要真实浏览器状态（cookies、tabs）的 Agent，以及想要本地控制、不额外起服务的团队
• 可搭配： Node.js + Chrome 扩展流程、通过 surf install 安装 native host、README 描述多浏览器支持（brave/edge/arc 等）
• 准备时间： 15–25 分钟

实战建议

• README Quick Start 是 4 步：npm 全局安装、加载 unpacked 扩展、surf install <extension-id>、最后 surf tab.list 测试。
• README 列出支持浏览器：chrome、chromium、brave、edge、arc、helium，并提供 --browser all。

Agent 集成的安全姿势

浏览器控制的风险在于“可导航、可点击、可带 cookies”。务实护栏：

• 先让 Agent 进入“只读阶段”：列出 tabs、收集 URL、提取文本。
• 对可交互域名做 allowlist，避免无意跳转到不可信站点。
• 扩展与 native host 的更新要走 PR/审核，不要临时在本机随手改。

排障清单

• 扩展路径变化时，重新执行 surf extension-path 并重新加载 unpacked extension。
• 包管理器导致二进制路径不标准时，README 给出 SURF_NODE_PATH / SURF_HOST_PATH / SURF_EXTENSION_PATH 等环境变量配置方式。

FAQ

这是 MCP 方案吗？ 答：README 将 Surf 定位为 CLI + 扩展/native host 流程，并强调无需配置 MCP server。

最容易卡在哪一步？ 答：通常是加载 unpacked 扩展，以及复制 extension id 用于 surf install。

能用其它浏览器吗？ 答：可以。README 列出多浏览器并提供 --browser 参数（包含 --browser all）。