surf-cli

零配置让 AI 直接操控 Chrome，省去繁琐调试

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署智能体 🍴 复刻 62 🐛 待处理 12 👀 关注 1

GitHub ↗

GitHub 星标 ★ 686

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源项目，MIT许可证，完全免费，无付费版本。

项目预览

项目数据

分类智能体

开发团队nicobailon

GitHubhttps://github.com/nicobailon/surf-cli

定价模式🏷️完全免费

价格说明开源项目，MIT许可证，完全免费，无付费版本。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型ai-agents,browser-automation,chrome,cli,devtools

GitHub 星标★ 686

上线时间2025-12-28 00:00:00

代码更新2026-11-08

仓库体积4.9 MB

本站数据更新2026-11-10

维护状态活跃

收录时间2026-08-09

浏览次数6

项目介绍

surf-cli 是一个让 AI 智能体通过命令行控制 Chrome 浏览器的工具，主打零配置、与具体 AI 框架无关。它解决了 AI 在自动化操作浏览器时配置复杂、依赖特定智能体框架的问题，提供了一套简洁的 CLI 接口，使任何 AI 智能体都能轻松驱动 Chrome 执行网页操作。核心能力包括：无需配置文件即可快速启动，兼容多种 AI 智能体（如 LangChain、AutoGPT 等），并经过实际项目验证，稳定性较好。它基于 JavaScript 和 Chrome DevTools 协议，实现了对浏览器的精细控制，适合需要网页自动化、数据抓取或 UI 测试的 AI 应用场景。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 686

技术标签

ai-agents browser-automation chrome cli devtools

使用教程

难度：进阶约 30 分钟部署方式：本地安装 4 步

环境要求

Node.js 18+
Chromium 浏览器

安装与启动步骤

1安装 CLI

给 agent 用的浏览器自动化命令行，npm 全局装。
```
npm install -g surf-cli
```
2看命令清单

50 多个命令，先看全量帮助再挑常用。
```
surf --help-full
```
3上传文件示例

按元素 ref 定位输入框，ref 可从页面快照里取。
```
surf upload --ref e5 --files ./report.pdf
```
4接进 agent 流程

把命令写进工具描述，让 agent 按 ref 操作而不是猜选择器。