SuperAPI AI 工具集

surf

通用与其它

查看项目

更新于 10-16 07:19

技能介绍

Surf 用于通过命令行或 Unix socket 控制 Chrome,实现浏览器自动化、测试与调试。主要能力包括:导航与标签/窗口管理;用 page.read 获取可访问性树与元素 ref,再按 ref 或坐标点击、输入、悬停、拖拽;语义定位(locate.role、locate.text、locate.label);表单填写、下拉选择、文件上传、iframe 切换;滚动、等待、对话框处理;网络请求与控制台检查、JavaScript 执行、性能指标与截图;设备/网络/CPU/地理位置模拟;Cookie、历史与书签操作;健康检查与冒烟测试。

AI 助手功能无需 API Key,使用浏览器已登录会话,需先在 Chrome 登录对应服务。示例:surf chatgpt "explain this code"、surf gemini "summarize" --with-page、surf perplexity "deep dive" --mode research、surf grok "summarize this page" --with-page。Grok 可用 surf grok --validate 校验界面与模型,必要时 --save-models。

多步任务可用工作流:surf do 'go "https://example.com" | click e5 | screenshot',或把 JSON 工作流放在 ~/.surf/workflows/ 或 ./.surf/workflows/,用 surf do my-workflow --email ... 运行,支持 --dry-run、--on-error、--step-delay、--json 等选项,并带自动等待。

限制与注意:首次 CDP 操作较慢(约 5-8 秒);AI 查询需已登录,思考型模型可能需 45 秒以上;服务 UI 变化可能导致模型选择或元素查找失败,需检查更新;contenteditable 编辑器需 --method js;iframe 内容需先 frame.switch。官方未提供收费、价格与平台支持等更多信息。