Agent Browser with Camoufox

核心用法

本skill提供camoufox + agent-browser的自动化部署方案，解决浏览器自动化中的反检测难题。核心流程为：

1. 安装依赖: 通过uv安装camoufox Python包，自动下载浏览器二进制
2. 源码修改: 关键修改browser.ts中的getBrowserType函数，使其通过检测camoufox或firefox关键字自动识别浏览器类型，而非默认Chromium
3. 重新编译: 重新编译Rust CLI并替换系统npm包中的二进制文件
4. 一键脚本: 提供install.sh脚本自动化上述繁琐流程

关键代码修改:

private getBrowserType(executablePath: string): 'chromium' | 'firefox' {
  const lowerPath = executablePath.toLowerCase();
  if (lowerPath.includes('firefox') || lowerPath.includes('camoufox')) {
    return 'firefox';
  }
  return 'chromium';
}

显著优点

• 反检测能力强: camoufox基于Firefox深度修改，可绕过Bilibili、Cloudflare等主流风控系统
• 自动化程度高: 一键脚本替代7+手动步骤，大幅降低部署门槛
• 源码级修改: 不依赖外部补丁，修改透明可追溯
• 路径智能识别: 自动从可执行路径推断浏览器类型，无需额外配置

潜在局限

• 平台限制: 示例路径仅覆盖macOS (~/Library/Caches/...)，Linux/Windows需手动适配
• 维护成本: agent-browser升级后需重新应用修改和编译
• Rust依赖: 编译需要Rust工具链，增加环境复杂度
• 非官方支持: 修改属于第三方hack，无上游维护保障

适合人群

• 需要进行高隐蔽性浏览器自动化的开发者
• 受限于Chromium检测机制、需切换Firefox内核的用户
• 愿意承担一定维护成本以换取反检测能力的专业场景

常规风险

• 安全审计缺失: 认证报告显示"仅用于简介提取，未执行安全扫描"，实际安全性未验证
• 供应链风险: 从GitHub/npm安装多环节依赖，任一环节被篡改将导致风险
• 权限操作: 脚本涉及全局npm包替换、系统路径写入，需警惕恶意注入
• 合规风险: 反检测技术可能违反部分平台服务条款