SuperAPI AI 工具集

firefox-browser

前端与建站

查看项目

更新于 10-15 16:46

技能介绍

用途:通过 WebSocket 控制用户真实的 Firefox 浏览器会话,使用其现有登录状态与 Cookie,而非无头浏览器,适合需要以用户身份浏览和操作已认证页面的场景。

主要能力:会话与标签页管理(listTabs、newSession、newWindow、setActiveTab、getActiveTab);导航与页面信息(navigate、getContent 支持 annotated/text/html、getInteractables、screenshot);交互(click、type、fillForm、waitFor、scroll、evaluate);控制流(fork、killFork、listForks、tryUntil、parallel);认证与保险库(autoLogin、vaultStatus、vaultSync、getAuthContext、requestAuth)。type 与 fillForm 可自动处理 ProseMirror、Lexical、Draft.js、Tiptap、Slate、CKEditor、Quill 等富文本编辑器。

使用方式:命令格式为 browser <action> '<json_params>'。若 Firefox 未运行,先执行 nohup firefox &>/dev/null &,再用 browser ping 检查连接,browser listTabs '{}' 查看标签页,browser newSession '{"url": "https://example.com"}' 新建会话,browser getContent '{"format": "annotated"}' 读取带可交互元素标注的页面。可用 tabId 隔离并行任务,用 fork 试探多条路径,用 tryUntil 处理不确定 UI,用 parallel 同时处理多个 URL。

认证:集成 Bitwarden 保险库(经 bronzewarden)实现自动填充凭据,凭据由本地原生宿主解密并经原生消息通道发送,不经过 WebSocket;保险库在宿主启动时用系统钥匙串中的主密码自动解锁。

限制:需 Firefox 已运行且扩展已加载,连接被拒时可能需在 about:debugging 重新加载扩展;元素未找到时可用 annotated 格式查看页面;资料未提供平台支持范围、收费与价格信息。