camofox-browser – 专为 AI Agent打造的开源反检测浏览器

camofox-browser是一款专为 AI Agent(智能体)量身打造的开源反检测浏览器。简单来说，它就像是给 AI爬虫穿上了一件“隐身衣”，让它在访问网页时能够完美伪装成真实的人类用户，从而轻松绕过各类网站的反爬虫检测和机器人验证。它的底层核心是基于深度定制的 Firefox 分支——Camoufox。

1. C++ 底层的极致伪装

与传统通过 JavaScript 注入来修改指纹的方式不同，camofox-browser直接在 Firefox 的 C++ 源码层进行了魔改。

全方位伪造：它能在 JS 代码执行前，就伪造好硬件并发数 (navigator.hardwareConcurrency)、WebGL 渲染器、AudioContext 音频指纹、屏幕几何参数以及 WebRTC 等关键信息。
无法被识破：这种底层拦截技术让网站的反爬系统在 JavaScript 层面完全无法察觉出它是自动化工具，能够轻松绕过 Cloudflare Turnstile 等主流检测系统。

2. 专为 AI 打造的结构化快照

这是它区别于普通反检测浏览器的最大特色。

页面提炼：它不会把冗长复杂的原始 HTML 直接丢给大模型，而是将网页提炼成一份带编号标签的简洁「目录清单」（Accessibility 快照）。
精准交互：清单上的每个按钮、链接都贴有稳定的编号便利贴（如 e1、e2）。AI 想点击哪里，直接报编号即可。
大幅降本：这种结构化快照的体积比原始 HTML 减少了 90% 以上，为需要长时间运行的 AI Agent 节省了大量的 Token 开销和处理时间。

3. 丰富的自动化与调试功能

搜索宏快捷指令：内置了 15+ 主流平台的搜索宏（如 @google_search、@youtube_search、@reddit_search 等），一行命令即可直达目标页面。其中 Reddit 宏还能直接返回 JSON 数据，无需二次解析。
会话持久化与免登录：支持导入 Netscape 格式的 Cookie 文件，自动持久化用户的登录状态（Cookie 与 localStorage），重启后依然保持登录，方便 AI 操作已登录的账号。
代理与 GeoIP 自动匹配：支持住宅代理，并能自动根据代理出口的 IP 设置浏览器的时区、语言和地理坐标，保持指纹的一致性。
可视化调试：提供 noVNC 可视化交互，方便手动完成复杂的验证码登录；同时支持 Playwright 追踪，生成包含截图和 DOM 快照的调试文件。

如何快速上手

camofox-browser 的部署非常轻量，支持 Docker 一键部署，空闲时内存占用仅约 40MB。

安装依赖（首次安装会自动下载约 300MB 的 Camoufox 引擎）：
bash
```
1npm install @askjo/camofox-browser
```
本地启动：
bash
```
1npm start
```
调用接口：启动后默认监听 9377 端口，你可以通过发送 REST 请求来创建标签页、获取页面快照或执行点击/输入等交互操作。