redf0x1/camofox-browser

解决的问题

CamoFox 浏览器服务器为 AI 代理和自动化工具提供了一种方式，使其在不被反机器人系统检测的情况下浏览网页。传统的浏览器自动化工具通常依赖于脆弱的 JavaScript 补丁，容易被绕过；CamoFox 通过使用在 C++ 引擎级别实现指纹伪装的 Firefox 分支来解决这一问题。

工作原理

它将 Camoufox 隐蔽浏览器引擎封装在基于 TypeScript 的 REST API 和全面的 CLI 中。这使得任何语言或 AI 代理都可以通过 HTTP 端点或终端命令控制浏览器。它为每个用户管理隔离的浏览器上下文（会话），持久化配置文件（Cookie 和存储），并提供「可访问性快照」——一种结构化、token 高效的页面表示，允许代理使用稳定的引用（例如 e1、e2）与元素交互。

适用人群

• AI 代理开发者：需要与具有严格机器人检测的网站交互的 LLM 驱动代理的开发者。
• DevOps/QA 工程师：需要强大、语言无关的浏览器自动化工具用于测试或爬取的用户。
• 安全研究人员：需要高保真指纹伪装和隔离会话管理的用户。

主要亮点

• 引擎级隐身：使用 C++ 级别指纹伪装，而非 JavaScript 注入，以绕过 Cloudflare 和 Google 的机器人检测。
• AI 就绪接口：提供 REST API、MCP 集成以及支持 JSON 输出的 CLI，便于 LLM 解析。
• LLM 安全认证库：采用 AES-256-GCM 加密存储，允许代理在不直接查看原始密码的情况下将凭据注入页面。
• 结构化交互：使用带有稳定元素引用的可访问性快照，实现精确、token 高效的导航。
• 内置自动化：包含 14 个热门网站（Google、YouTube、Reddit 等）的搜索宏，并支持流水线脚本。