firefox-agent-bridge
通过WebSocket桥接AI智能体与真实Firefox浏览器交互
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:firefox-agent-bridge。 它的用途是:通过WebSocket桥接AI智能体与真实Firefox浏览器交互 完整的 Skill 内容见:https://321skill.com/skills/firefox-agent-bridge/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我在Firefox中打开GitHub,登录我的账户,然后抓取我最近仓库的提交记录。” 它会通过Firefox Agent Bridge发送一系列导航、输入、点击和获取页面内容的指令,控制你的真实Firefox浏览器完成整个流程,并将结果返回给你。或者,在编写自动化测试脚本时,你可以直接让AI通过WebSocket发送 `{"action": "click", "params": {"selector": "#submit-btn"}}` 来模拟用户点击。
介绍
Firefox Agent Bridge 解决了AI智能体(如Claude Code)无法直接与真实网页浏览器交互的难题。它通过一个Rust编写的本地WebSocket服务器、原生消息宿主和Firefox扩展,在AI智能体与一个正在运行的Firefox浏览器实例之间建立了一座安全、高效的桥梁。
使用方式分为两种:一是通过其提供的Rust CLI工具 browser 直接发送命令;二是让您的AI Agent SDK直接连接到 ws://127.0.0.1:8766 这个WebSocket端点,并发送标准化的JSON指令(如导航、点击、获取内容等),即可远程控制浏览器执行自动化任务。
这个Skill非常适合需要让AI在真实浏览器环境中进行端到端操作的全栈开发、智能体开发者和测试工程师。例如,开发基于浏览器的自动化测试流程,或构建能够自主完成网页操作(如填写表单、抓取数据)的AI智能体。
请注意,该工具主要支持Firefox浏览器,且需要手动安装浏览器扩展和本地宿主程序。在Windows系统上,部分高级功能(如持久会话模式)可能受限,但核心的指令控制流程可以正常运行。
核心特点
与许多基于无头浏览器或远程控制的方案不同,此Skill直接桥接到用户真实的、正在运行的Firefox浏览器会话,允许AI与包含用户登录状态、扩展和个性化设置的完整浏览器环境交互;其核心通信层采用高性能Rust编写,相比Node.js实现,命令执行速度提升近9倍。
注意事项
目前主要绑定Firefox浏览器,且Windows平台不支持需要Unix域套接字的持久会话模式。
常见问题
支持Chrome或Edge吗?
目前主要针对Firefox设计,核心架构依赖Firefox的原生消息传递机制。
安装复杂吗?
需要三步:安装Firefox扩展、构建/安装Rust原生宿主、安装CLI工具,但提供了详细的脚本和发布包简化流程。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/firefox-agent-bridge/raw/index.md 读取 firefox-agent-bridge 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/firefox-agent-bridge/raw/index.md(查看排版版本)