62
// 项目简介
Camofox-browser 是一款专为 AI Agent 提供可靠网页浏览能力的服务器，利用 Camoufox 引擎实现 C++ 级别的指纹伪装。它提供 REST API，通过可访问性快照、稳定的元素引用和内置搜索宏简化了交互过程。该系统针对效率和部署进行了优化，具备自动空闲关闭和会话隔离功能，以支持可扩展的 Agent 操作。
// 技术分析
Camofox-browser 是一款专为 AI 智能体设计的反检测浏览器服务器，利用定制的 Firefox 分支在 C++ 层面实现了指纹伪装。通过解决 Playwright 和 headless Chrome 等标准自动化工具的局限性，它提供了一个强大且隐蔽的环境，能够绕过现代机器人检测机制。该项目通过可访问性快照、稳定的元素引用和智能会话管理等功能，优先考虑了自主智能体的效率和可靠性，使其适用于 VPS 或共享基础设施等资源受限的环境。
// 核心亮点
01
实现 C++ 级别的反检测，有效绕过 Cloudflare 和 Google 等复杂的机器人防护系统。
02
提供稳定的元素引用（如 e1, e2 等），确保 AI 智能体无论 DOM 如何变化都能进行可靠的交互。
03
生成比原始 HTML 小约 90% 的 Token 高效可访问性快照，优化 LLM 上下文使用。
04
具备轻量级架构，空闲时内存占用约为 40MB，支持在低成本硬件上部署。
05
支持会话隔离和 Cookie 注入，无需交互式登录即可实现已认证的浏览会话。
06
内置搜索宏和自动化的 GeoIP/代理配置，简化复杂的网页导航和数据检索任务。
// 典型使用场景
01
利用 C++ 级别的指纹伪装绕过 Google 和 Cloudflare 等网站的高级机器人检测
02
通过节省 Token 的可访问性快照和稳定的元素引用，使 AI Agent 能够与网页进行交互
03
通过自动化的 Cookie 注入和基于代理的 GeoIP 路由来管理已认证的浏览会话
// 快速开始
首先，克隆存储库并运行 'npm install'，然后运行 'npm start' 以在 9377 端口启动服务器。对于容器化环境，请使用提供的 Makefile 通过 Docker 进行构建和部署，并确保先获取必要的浏览器二进制文件。开发人员随后可以通过 REST API 或安装 OpenClaw 插件与浏览器进行交互。