jo-inc/camofox-browser

项目概览

其技术路线直接在 C++ 层修改 Firefox（基于 Camoufox）以实现指纹伪装，早于 JavaScript 执行发生；同时通过 REST API 为 AI agent 提供无障碍快照而非原始 HTML，直接切中当前 LLM 网页交互中令牌消耗与反检测两大痛点。

项目类型

AI Agent · 基础设施

应用场景

自动化执行

部署方式

查看项目说明

License

MIT

适合谁

• 需要绕过机器人检测以浏览真实网页的 AI agent 开发者与工程师。
• 寻求以低基础设施开销（如 Raspberry Pi、5美元 VPS）运行浏览器自动化任务的团队。

核心能力

• 将反检测引擎封装在 REST API 中。该 API 为 AI agent 提供无障碍快照、稳定的元素引用以及搜索宏，用于网页交互和数据提取，而不是直接抓取原始 HTML。
• 采用延迟启动浏览器和空闲关闭机制，在空闲状态时将内存占用维持在约 40MB。
• 提供隔离的用户会话，并持久化存储 cookies 和 localStorage，确保这些会话数据能够在浏览器重启后依然保留。

限制与风险

• 当无障碍快照无法满足需求时，不适合用于获取原始、庞大杂乱的 HTML。
• 使用 GitHub Issues 报告匿名化的崩溃或挂起遥测数据。

如何开始

• 提供清晰的设置说明，无需编写代码即可通过 npx @askjo/camofox-browser 指令快速运行项目。

核验依据

• README: Anti-detection browser server for AI agents, powered by Camoufox
• README: This project wraps that engine in a REST API built for agents: accessibility snapshots instead of bloated HTML, stable element refs for clicking, and search macros for common site…
• README: AI agents need to browse the real web. Playwright gets blocked. Headless Chrome gets fingerprinted. Stealth plugins become the fingerprint.
• README: Camoufox patches Firefox at the **C++ implementation level** - `navigator.hardwareConcurrency`, WebGL renderers, AudioContext, screen geometry, WebRTC - all spoofed before JavaScr…
• README: - **Telemetry** - automatic [anonymized crash/hang telemetry](lib/reporter.js#L28-L290) via GitHub Issues. Identifies which sites cause failures and common failure patterns. Priva…

内容核验时间：