Bin-Huang/camoufox-cli

解決的問題

camoufox-cli 提供反偵測瀏覽器的命令列介面，讓 AI 代理能瀏覽網頁而不被識別為機器人。它透過在 C++ 層級偽造硬體與軟體指紋（例如 canvas、WebGL 和音訊），解決機器人偵測問題，使瀏覽器看起來像真實的人類使用者。

如何運作

此工具以 CLI 形式運作，透過 Unix socket 與 Python 守護程序通訊。該守護程序透過 Playwright 管理 Camoufox（基於 Firefox）瀏覽器實例。它允許代理使用簡化的可存取性樹狀快照系統與頁面互動，元素會被指派參考 ID（例如 @e1），進而可用於點擊、填寫表單與擷取文字。

適用對象

AI 代理（如 Claude Code、Cursor 和 OpenClaw）以及需要在避免指紋識別與機器人偵測系統的同時自動化瀏覽器任務的開發者。

主要特色

• C++ 層級指紋偽造：偽造 canvas、WebGL、音訊、螢幕指標與字型，以避開偵測。
• 持久身份：將指紋、作業系統與地區設定儲存至設定檔路徑，確保不同會話間維持相同身份。
• 代理友善互動：使用帶有 @ref 元素定位的可存取性樹狀快照，實現輕鬆導航與互動。
• 會話與標籤頁隔離：支援多個命名會話（獨立瀏覽器程序）與命名標籤頁（共用瀏覽器程序），以進行平行任務。
• Cookie 管理：可匯入與匯出 Cookie 為 JSON 格式，以維持會話持久性。
• 代理與 GeoIP 支援：整合代理支援，並根據代理 IP 自動進行 GeoIP 偽造。