【免费下载链接】surf-cliThe CLI for AI agents to control Chrome. Zero config, agent-agnostic, battle-tested.项目地址https://gitcode.com/gh_mirrors/su/surf-cli点击查看免费下载Surf 是一款面向 AI 智能体AI Agent的 Chrome 浏览器自动化命令行工具主打零配置、不绑定任何 AI 提供商装好浏览器扩展后用几条surf命令就能让 AI 替你打开网页、读取内容、点击元素、截图。本文带你 4 步完成安装并跑通第一个浏览器自动化任务同时覆盖多浏览器与 WSL 环境的配置方法。一、Surf 是什么解决什么问题大多数浏览器自动化工具要么需要复杂的 MCP 服务配置要么绑定特定 AI 服务商还常常在真实页面上翻车。Surf 走的是另一条路Agent-Agnostic不绑定智能体纯 CLI 命令 Unix socketClaude Code、GPT、Gemini、Cursor 甚至 shell 脚本都能驱动零配置装扩展、跑命令没有 MCP 服务器、中转进程或订阅实用默认值截图自动压缩到 1200px 省 token、动作后自动截图省往返、受限页面给出警告而非直接失败无需 API Key 的 AI 能力直接复用你浏览器里已登录的 ChatGPT / Gemini / Perplexity 会话工作流程很简单详见 README.mdCLI (surf) → Unix Socket → Native Host → Chrome Extension → CDP/Scripting API二、一键安装步骤4 步跑通 Surf第 1 步全局安装 Surf CLI确保本机已安装 Node.js然后执行npm install -g surf-cli安装完成后surf命令即可在任意目录使用。第 2 步在 Chrome 中加载扩展打开chrome://extensions开启右上角开发者模式Developer mode点击加载已解压的扩展程序Load unpacked粘贴以下命令输出的路径surf extension-path加载后在扩展列表里复制 Surf 的扩展 ID32 位字母第 3 步要用。第 3 步安装 native host把上一步复制的扩展 ID 传给surf install它会自动注册 Chrome 的 native messaging 组件surf install extension-id第 4 步重启 Chrome 并验证完全重启 Chrome不是刷新页面然后在终端测试surf tab.list能列出你当前打开的标签页就说明安装成功了 三、跑通第一个 Chrome 自动化四个最常用命令命令速查见 native/cli.cjs 的帮助输出surf --helpsurf go https://example.com # 打开网页 surf read # 读取页面无障碍树 可见文本 surf click e5 # 点击元素e1、e2… 是 read 输出的元素引用 surf snap # 截图自动保存到 /tmp一个典型的手动自动化小流程surf go https://example.com surf read surf click e3 surf screenshotread输出的每个元素都带有稳定的e1、e2引用比 CSS 选择器更抗页面变动click等动作执行后还会自动截图并报告页面变化无需额外命令。 想批量执行多步操作可以用 workflow 一条命令跑完surf do go https://example.com | read | click e5 | screenshot详情见 native/do-executor.cjs。四、多浏览器支持一次安装全浏览器生效Surf 支持chrome、chromium、brave、edge、arc、helium通过--browser参数指定实现位于 scripts/install-native-host.cjssurf install extension-id # Chrome默认 surf install extension-id --browser brave # Brave surf install extension-id --browser helium # Helium surf install extension-id --browser all # 一次性安装到所有支持的浏览器卸载同理surf uninstall --all可清除所有浏览器的配置。五、WSL 支持在 WSL2 里驱动 Chrome如果你习惯在 WSL2 中工作Surf 也给出了两种路径场景 AWSL2 Windows 侧 Chrome推荐直接在 WSL2 里运行surf install extension-id即可。Surf 会自动检测到 WSL2在 Windows 侧注册 native messaging manifest生成的 Windows 包装脚本通过wsl.exe拉起 WSL 内的 host因此 WSL 里的surf命令依然连接同一个 socket。装完重启 Windows 的 Chrome即可。场景 BWSLg 内的 Linux 浏览器如果你用的是 WSLg 图形栈里的 Linux 版浏览器如 Chromium加一个--target linuxsurf install extension-id --target linux遇到扩展报错Access to the specified native messaging host is forbidden时回到同一个 WSL 发行版中重新执行surf install extension-id并确认扩展 ID 确实从chrome://extensions复制。六、连不上怎么办用 surf doctor 一键自检如果命令报Socket connect failed先别慌——运行内置诊断工具源码见 native/doctor.cjs它不依赖浏览器连接就能检查工作surf doctor # 默认浏览器 surf doctor --browser all # 检查所有浏览器doctor会依次检查 socket 路径、native messaging manifest、allowed_origins与扩展 ID 是否匹配、wrapper 脚本路径并打印下一步修复建议。常见修复手段安装后重启浏览器确认 Surf 扩展已启用且 ID 与surf install传入的一致如果设置了SURF_SOCKET确保两侧浏览器拉起的 host 和你的 shell使用同一个值更多排障思路可参考 skills/surf/references/troubleshooting.md。七、下一步学什么跑通第一步之后可以按需深入README.md完整命令参考50 命令、远程 Tailscale 部署、AI 查询、网络抓包docs/threads-and-feeds.md如何用配方一次抓取整条 X 帖子串 / 信息流skills/surf/SKILL.md给 AI 编码智能体安装的 Surf 技能文件skills/deep-x-research/SKILL.md基于 Surf 的深度 X 研究技能总结步骤命令 / 操作说明1npm install -g surf-cli全局安装 CLI2加载扩展chrome://extensions加载surf extension-path路径3surf install extension-id注册 native host4重启 Chrome surf tab.list验证连接至此你就拥有了一条零配置、可被任意 AI Agent 驱动的 Chrome 自动化通道。多浏览器加--browserWSL 场景按浏览器位置选默认或--target linux出问题时交给surf doctor自检——四步之后剩下的就是探索 50 命令的玩法了。赞分享【免费下载链接】surf-cliThe CLI for AI agents to control Chrome. Zero config, agent-agnostic, battle-tested.项目地址https://gitcode.com/gh_mirrors/su/surf-cli点击查看免费下载相关推荐Sitegeist快速上手指南5步在Chrome中安装并跑通第一个自动化任务Sitegeist快速上手指南5步在Chrome中安装并跑通第一个自动化任务 Sitegeist 是一款运行在浏览器侧边栏的 AI 自动化助手扩展它能替你完BrowserCode 快速上手1 条命令安装浏览器 AI 代理10 分钟跑通第一个自动化任务BrowserCode 快速上手1 条命令安装浏览器 AI 代理10 分钟跑通第一个自动化任务 BrowserCode 是一个浏览器原生的 AI 代理框架Puppeteer 快速上手从安装到编写第一个浏览器自动化脚本Puppeteer 快速上手从安装到编写第一个浏览器自动化脚本 Puppeteer 是面向 Chrome 与 Firefox 的官方 JavaScript 自测试网页爬虫开发工具上一篇性能反超旗舰、价格大降“智能密度”革命是怎么发生的下一篇GWToolbox自动寻路完全指南NavMesh网格、A*算法与地图数据加载原理详解创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考