Bin-Huang/camoufox-cli

解决的问题

它为 AI 代理提供了一种在浏览网页时避免被检测的方法。许多网站使用指纹识别来识别并封锁自动化机器人；此工具允许代理通过伪造硬件与软件特征、维护持久身份，并透过简化的命令行界面与页面互动，来模拟真实人类用户。

运作原理

此工具作为 Camoufox 浏览器的 CLI 封装。它使用一个通过 Playwright 与浏览器通讯的 Python 守护进程。AI 代理将 shell 指令发送到 CLI，随后传递给守护进程以执行诸如导航至 URL、点击元素或截图等操作。为了防止检测，它会伪造 C++ 层级的指纹（包括 canvas、WebGL 与音频），并可将这些身份存储至磁盘，以便代理能以相同的“设备”返回网站。

目标对象

开发 AI 代理（使用如 Claude Code、Cursor 或 OpenClaw 等框架）且需要执行网页自动化、数据提取或与具有严格反机器人保护的网站进行互动的开发者。

特色亮点

• 防检测： 伪造 canvas、WebGL、音频、屏幕指标与字体以规避机器人检测。
• 代理友善互动： 使用具有唯一元素参考 (@ref) 的辅助功能树快照，让代理能轻松定位并点击元素。
• 身份管理： 支持持久化指纹与 Cookie，允许代理在多次启动间维持稳定的会话。
• 会话隔离： 支持多个具有不同指纹与代理服务器的隔离浏览器进程，用于多账号管理。
• json 输出： 提供 --json 标志以进行结构化数据提取，使代理更容易解析结果。