Bin-Huang/camoufox-cli

解决的问题

camoufox-cli 为反检测浏览器提供命令行界面，使 AI 代理能够浏览网页而不被识别为机器人。它通过在 C++ 层级伪造硬件和软件指纹（如 canvas、WebGL 和音频），解决了机器人检测问题，使浏览器看起来像真实的用户。

工作原理

该工具作为 CLI 运行，通过 Unix 套接字与 Python 守护进程通信。该守护进程通过 Playwright 管理 Camoufox（基于 Firefox）浏览器实例。它允许代理使用简化的可访问性树快照系统与页面交互，元素被分配引用 ID（例如 @e1），然后可用于点击、填写表单和提取文本。

适用人群

AI 代理（如 Claude Code、Cursor 和 OpenClaw）以及需要在避免指纹识别和机器人检测系统的同时自动化浏览器任务的开发者。

主要亮点

• C++ 层级指纹伪造：伪造 canvas、WebGL、音频、屏幕指标和字体，以绕过检测。
• 持久身份：将指纹、操作系统和区域设置保存到配置文件路径，确保在不同会话间保持同一身份。
• 代理友好型交互：使用带有 @ref 元素定位的可访问性树快照，实现轻松导航和交互。
• 会话与标签页隔离：支持多个命名会话（独立浏览器进程）和命名标签页（共享浏览器进程），实现并行任务处理。
• Cookie 管理：支持以 JSON 格式导入和导出 Cookie，实现会话持久化。
• 代理与 GeoIP 支持：集成代理支持，并根据代理 IP 自动进行 GeoIP 伪造。