camofox-browser是什么

Camofox Browser 是开源 AI Agent 反检测浏览器服务器，基于 Camoufox（Firefox C++ 级指纹魔改版）构建。通过 REST API 为 AI 提供结构化网页快照（体积缩减 90%+），生成稳定元素引用（如 e1、e2）供 AI 直接交互。Camofox Browser内置 C++ 层指纹伪造，可绕过 Cloudflare 等主流反爬验证；支持 Cookie 导入、会话持久化及 15+ 搜索宏。

camofox-browse的主要功能

• C++ 级反检测浏览： 底层基于 Camoufox 魔改 Firefox，在 C++ 实现层伪造硬件并发数、WebGL 渲染器、AudioContext、屏幕几何与 WebRTC 等指纹信息，JavaScript 层无法识破。
• 结构化网页快照： 将原始 HTML 提炼为带编号标签的 accessibility 快照（体积减少 90% 以上），AI 可直接通过 e1、e2 等稳定引用与页面交互。
• Cookie 导入与会话持久化： 支持导入 Netscape 格式 Cookie 文件实现免登录访问，用户会话的 Cookie 与 localStorage 自动持久化到本地，重启后保持登录状态。
• 搜索宏快捷指令： 内置 15+ 主流平台搜索宏（如 @google_search、@reddit_search、@youtube_search），一行命令直达目标页面，Reddit 宏直接返回 JSON 数据。
• 代理与 GeoIP 自动匹配： 支持住宅代理与 Backconnect 旋转代理，自动根据代理出口 IP 设置浏览器时区、语言与地理坐标，保持指纹一致性。
• YouTube 字幕提取： 集成 yt-dlp 快速提取任意 YouTube 视频字幕，无需 API Key，支持多语言筛选。
• VNC 可视化交互登录： 通过 noVNC 在浏览器中手动完成复杂网站的交互式登录，导出存储状态供后续 Agent 自动化复用。
• 会话追踪与调试： 支持按会话开启 Playwright 追踪，生成包含截图、DOM 快照与网络请求的 .zip 文件，便于事后排查。
• 轻量部署与弹性伸缩： 空闲时内存占用约 40MB，支持 Docker、Fly.io、Railway 一键部署，浏览器引擎懒加载 + 空闲自动关闭。

camofox-browse的技术原理

• C++ 层指纹欺骗： Camoufox 在 Firefox 源码层修改 navigator.hardwareConcurrency、WebGL 渲染字符串、AudioContext 指纹、屏幕分辨率与 WebRTC 等属性，反爬系统在 JS 执行前即收到伪造参数。
• Accessibility Tree 快照： 用 Playwright 的 accessibility 树提取页面语义结构，生成带稳定引用的文本化快照，替代原始 DOM 传递给 LLM。
• Playwright 浏览器上下文隔离： 每个用户对应独立的 BrowserContext，Cookie、localStorage、缓存完全隔离，避免会话串扰。
• 懒加载与空闲回收： 首次请求时启动 Camoufox 引擎（约 300MB），无活跃会话 5 分钟后自动关闭进程，降低常驻资源占用。
• 结构化 JSON 日志： 所有请求与响应输出单行 JSON 对象，包含 reqId 便于分布式环境下的日志聚合与链路追踪。

如何使用camofox-browse

• 安装依赖： 执行 npm install @askjo/camofox-browser，首次安装会自动下载约 300MB 的 Camoufox 引擎。
• 本地启动： 克隆仓库后运行 npm install && npm start，服务默认监听 http://localhost:9377。
• 配置访问密钥（生产环境）： 生成 32 位十六进制密钥并设置环境变量 CAMOFOX_ACCESS_KEY，所有请求需携带 Authorization: Bearer <key>。
• 导入 Cookie 实现免登录： 将浏览器导出的 Netscape 格式 Cookie 文件放入 ~/.camofox/cookies/ 目录，通过 API 或 OpenClaw 插件调用导入工具注入会话。
• 创建标签页并获取快照： 向 /tabs 发送 POST 请求创建标签页，再调用 /tabs/:id/snapshot 获取带 e1、e2 引用的结构化页面摘要。
• 执行页面交互： 通过 /tabs/:id/click 或 /tabs/:id/type 传入元素引用编号与文本内容，实现点击与输入操作。
• 使用搜索宏导航： 调用 /tabs/:id/navigate 并传入 "macro": "@google_search" 与 "query": "关键词"，直接获取搜索结果页。
• Docker 部署： 在项目根目录执行 make up，Makefile 会自动检测 CPU 架构并预下载二进制文件，约 30 秒完成构建启动。

camofox-browse的核心优势

• 绕过主流反爬与验证码： 由于指纹在 C++ 层即被伪造，可稳定通过 Google、Cloudflare 等平台的 bot 检测，避免频繁触发人机验证。
• Token 效率极高： 结构化快照比原始 HTML 缩减 90% 以上体积，大幅降低 LLM 上下文窗口占用与 API 调用成本。
• 元素引用稳定可靠： 页面布局微调后，e1、e2 等引用仍可通过 accessibility 树保持有效，减少 Agent 因 DOM 变化而操作失败的概率。
• 开箱即用的搜索能力： 15+ 搜索宏覆盖主流信息源，无需 Agent 自行构造搜索 URL 与解析页面，Reddit 等站点直接返回结构化 JSON。
• 生产级安全模型： Cookie 导入默认关闭（需 CAMOFOX_API_KEY），支持全局 Access Key 鉴权，路径遍历防护，所有敏感数据运行时注入，零硬编码密钥。

camofox-browse的项目地址

• GitHub仓库：https://github.com/jo-inc/camofox-browser

camofox-browse的同类竞品对比

camofox-browse的应用场景

• AI Agent 网页自动化： 为基于 LLM 的智能体提供可编程浏览器后端，执行数据抓取、表单填写、信息检索等任务。
• 电商与竞品监控： 绕过平台反爬机制，自动化抓取商品价格、库存与评价信息，支持登录态下的账号级数据采集。
• 社交媒体自动化： 导入 Cookie 后自动运营 Twitter、LinkedIn、Instagram 等账号，执行内容发布、互动与数据分析。
• 学术与舆情研究： 用搜索宏快速检索 Google、Wikipedia、Reddit 信息，提取 YouTube 视频字幕进行内容分析。
• 云端自动化测试： 部署在 VPS 或容器环境中，作为无头浏览器服务支撑 CI/CD 流程中的端到端测试与网页监控。