ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

camofox-browser快速上手:3步跑通你的第一个反检测浏览器Agent

camofox-browser快速上手:3步跑通你的第一个反检测浏览器Agent camofox-browser快速上手3步跑通你的第一个反检测浏览器Agent【免费下载链接】camofox-browserStealth headless browser for AI agents — bypass Cloudflare, bot detection, and anti-scraping. Drop-in Puppeteer/Playwright replacement.项目地址: https://gitcode.com/GitHub_Trending/ca/camofox-browsercamofox-browser是一个面向 AI Agent 的反检测无头浏览器服务端基于 CamoufoxC 级指纹伪装的 Firefox 分支能绕过 Cloudflare、Google 验证码和绝大多数机器人检测。它是 Puppeteer / Playwright 的直接替代品浏览器访问不到网页的痛点3 条命令就能跑通。为什么 AI Agent 需要反检测浏览器如果你让 Agent 用常规方式上网大概率会遇到这三种情况Playwright 被拦截— 大量网站能识别自动化工具签名Headless Chrome 被指纹识别—navigator.hardwareConcurrency、WebGL、WebRTC 等指纹暴露机器身份Stealth 插件反而成为指纹— 注入脚本的行为本身会被检测系统标记camofox-browser 的思路是换引擎Camoufox 在C 实现层直接修补 Firefox所有指纹在 JavaScript 执行前就已完成伪装——没有 shim、没有 wrapper、没有破绽。本项目再把它包装成一套Agent 友好的 REST API能力说明元素引用Element Refs页面元素获得e1、e2等稳定 ID点击不再依赖脆弱的 CSS 选择器Token 高效快照可访问性快照比原始 HTML 小约90%Agent 阅读成本大降会话隔离每个用户独立的 cookies / 存储天然多租户低内存占用懒启动 空闲关闭空闲时仅约 40MB树莓派、$5 VPS 都能跑搜索宏google_search、reddit_search等 14 个常用站点直达服务入口在 server.js快照与元素引用逻辑在 lib/snapshot.js搜索宏定义在 lib/macros.js。3步快速开始环境要求Node.js ≥ 22默认端口9377。第1步克隆并安装 camofox-browsergit clone https://gitcode.com/GitHub_Trending/ca/camofox-browser cd camofox-browser npm installnpm install会自动下载 Camoufox 浏览器内核约 300MB。没有源码、想直接试用一条命令即可npx askjo/camofox-browser第2步启动反检测浏览器服务器npm start # - http://localhost:9377浏览器访问http://localhost:9377/docs可查看自动生成的交互式 OpenAPI 文档健康检查走GET /health。全部环境变量端口、代理、超时等集中在 lib/config.js 统一管理camofox.config.json则控制插件加载。第3步跑通你的第一个浏览 Agent用 3 个 curl 完成「打开页面 → 读取页面 → 点击元素」的完整闭环# 1. 创建标签页 curl -X POST http://localhost:9377/tabs \ -H Content-Type: application/json \ -d {userId: agent1, sessionKey: task1, url: https://example.com} # 2. 获取带元素引用的可访问性快照 curl http://localhost:9377/tabs/TAB_ID/snapshot?userIdagent1 # - { snapshot: [heading] Example Domain ... [link e1] More information..., ... } # 3. 通过元素引用点击 curl -X POST http://localhost:9377/tabs/TAB_ID/click \ -H Content-Type: application/json \ -d {userId: agent1, ref: e1}至此你的 AI Agent 已经拥有了一双能看见页面快照、能动手操作click/type/scroll且不被网站识别的眼睛和手。进阶让 Agent 更省事的实用功能搜索宏告别 URL 拼接导航时不必自己拼 URL直接用宏curl -X POST http://localhost:9377/tabs/TAB_ID/navigate \ -H Content-Type: application/json \ -d {userId: agent1, macro: google_search, query: best coffee beans}内置 14 个宏google_search、youtube_search、amazon_search、reddit_search、wikipedia_search等。其中 Reddit 宏直接返回 JSON无需解析 HTML。Cookie 导入跳过登录墙把浏览器导出的 Netscape 格式 cookies 文件放入~/.camofox/cookies/Agent 说一句导入我的 LinkedIn cookies即可完成认证浏览。该功能默认关闭需设置CAMOFOX_API_KEY环境变量启用实现细节见 lib/cookies.js。会话持久化登录一次长期有效persistence 插件plugins/persistence/会把每个用户的 cookies 和 localStorage 落盘到~/.camofox/profiles/浏览器重启后认证状态自动恢复。YouTube 字幕提取免 API Keyyoutube 插件plugins/youtube/基于 yt-dlp 提取任意视频字幕curl -X POST http://localhost:9377/youtube/transcript \ -H Content-Type: application/json \ -d {url: https://www.youtube.com/watch?vVIDEO_ID, languages: [en]}部署不止能跑在本地方式命令适合场景npm 一键运行npx askjo/camofox-browser快速体验源码运行npm install npm start二次开发Dockermake up自动识别 CPU 架构生产部署Railway / Fly.io仓库自带 railway.toml 与 Dockerfile云托管 Docker 部署请用make up而非直接docker build——Makefile 会预先下载 Camoufox 二进制把构建时间从 ~3 分钟压到 ~30 秒。常见问题Q内存占用高吗不高。浏览器懒启动、空闲 5 分钟自动关闭空闲状态约 40MB可以和其他服务共享一台低配机器。Q和 Playwright 怎么切换API 设计是 drop-in replacement 思路创建 tab、快照、点击、输入、滚动、截图语义与 Playwright 一一对应你的 Agent 只需把调用目标换成 REST 接口即可。完整端点清单见 openapi.json。Q如何限制访问设置CAMOFOX_ACCESS_KEY后除/health外所有请求都需Authorization: Bearer key可安全暴露到局域网之外。Q会话多久过期用户会话 30 分钟无活动自动过期达到 tab 上限时自动回收最旧标签页长会话不会撞墙。写在最后camofox-browser 把反检测从浏览器插件的猫鼠游戏变成了 C 层的工程问题再用一套极简 REST API 交给 AI Agent——3 步启动、元素引用交互、90% 的 token 节省是自建 Agent 浏览能力目前最省心的选择之一。想深入了解 API 细节可以从 AGENTS.md 的核心工作流章节入手MCP 集成方案在 mcp/ 目录测试用例含真实站点测试在 tests/ 目录。【免费下载链接】camofox-browserStealth headless browser for AI agents — bypass Cloudflare, bot detection, and anti-scraping. Drop-in Puppeteer/Playwright replacement.项目地址: https://gitcode.com/GitHub_Trending/ca/camofox-browser创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表