CamoFox MCP 技能

CamoFox MCP 为 OpenClaw 智能体提供了一套开箱即用、面向生产环境的反检测浏览器自动化工具包，基于 MCP HTTP 协议传输。它将 OpenClaw 与 CamoFox Browser 连接起来，使智能体能够执行网页浏览、点击、输入、内容提取、Cookie/会话管理、隐蔽搜索工作流以及资源下载等操作，同时显著降低传统自动化栈常见的高封禁率问题。

该技能存在的原因

绝大多数浏览器自动化流程最终都会遭遇 CAPTCHA、指纹检测或机器人识别机制。CamoFox 正是为应对这一现实而专门构建的：

• 按标签页/会话粒度实现反检测指纹伪装
• 在对自动化行为高度敏感的网站上具备更强的抗检测韧性
• 生成面向智能体推理优化的、Token 开销更低的可访问性快照（accessibility snapshot）
• 通过 Cookie/配置文件工具实现会话持久化
• 内置覆盖 14 种搜索引擎的搜索宏（search macros）

安装配置

1) 启动 CamoFox Browser

必须首先运行 CamoFox Browser（默认地址为 http://localhost:9377）。

2) 以 HTTP 模式启动 CamoFox MCP

CAMOFOX_TRANSPORT=http npx camofox-mcp@1.10.0

可选示例：

CAMOFOX_TRANSPORT=http CAMOFOX_API_KEY=your-key npx camofox-mcp@1.10.0
CAMOFOX_TRANSPORT=http CAMOFOX_HTTP_PORT=8080 npx camofox-mcp@1.10.0

3) 配置 OpenClaw

添加如下 MCP 服务端配置：

{"mcpServers":{"camofox":{"url":"http://localhost:3000/mcp"}}}

替代性的技能生成流程：

npx @filiksyos/mcptoskill http://localhost:3000/mcp

触发短语

当用户提出以下类型任务时，启用本技能：

• 浏览该网站并提取数据
• 自动化完成该登录/搜索/表单流程
• 使用隐蔽型或反检测型浏览器
• 获取页面快照，并执行点击/输入等交互流程
• 采集该页面指定区域内的所有链接/图片/PDF 文件
• 持久化会话 Cookie 并支持后续恢复
• 在浏览器中执行网络搜索并汇总结果
• 下载文件并返回元数据及/或内容

工具目录（共 41 个工具）

健康状态（1 个）

• server_status：检查 CamoFox 服务端健康状况及浏览器连接状态。

标签页（3 个）

• create_tab：创建一个具备反检测指纹能力的新浏览器标签页。
• close_tab：关闭指定浏览器标签页并释放相关资源。
• list_tabs：列出所有已打开的浏览器标签页及其 URL 和标题。

导航（4 个）

• navigate：将指定标签页导航至目标 URL。
• go_back：在浏览器历史记录中后退一页。
• go_forward：在浏览器历史记录中前进一页。
• refresh：重新加载当前页面。

交互（8 个）

• click：根据元素引用（ref）或 CSS 选择器点击指定元素。
• type_text：向输入框中输入文本。
• scroll：按指定像素值向上或向下滚动页面。
• camofox_scroll_element：滚动指定容器元素。
• camofox_evaluate_js：在隔离的页面上下文中执行 JavaScript 代码。
• camofox_hover：鼠标悬停于指定元素之上。
• camofox_wait_for：等待页面达到就绪状态（如 DOM 加载完成、网络空闲等）。
• camofox_press_key：模拟按下键盘按键。

观测（4 个）

• snapshot：获取可访问性树（accessibility tree）快照（读取页面内容的首要方式）。
• screenshot：截取当前页面视觉截图，并以 base64 编码 PNG 格式返回。
• get_links：提取页面中全部超链接。
• camofox_wait_for_text：等待指定文本出现在页面中。

下载（3 个）

• list_downloads：列出已下载文件（支持可选过滤条件）。
• get_download：获取已下载文件（支持可选内联内容返回）。
• delete_download：从磁盘中删除指定已下载文件。

内容提取（3 个）

• extract_resources：从指定 DOM 范围内提取图片、链接、媒体、文档等资源。
• batch_download：一次性提取并下载指定范围内的全部资源。
• resolve_blobs：将 blob URL 解析为可下载的 base64 数据。

搜索（1 个）

• web_search：在 14 种搜索引擎（Google、YouTube、Amazon、Reddit 等）中执行统一搜索。

会话（3 个）

• import_cookies：导入 Cookie 以维持已认证会话状态。
• get_stats：获取当前会话的用量统计与性能指标。
• camofox_close_session：关闭属于某用户会话的所有标签页。

批量工作流（6 个）

• fill_form：一次性填充多个表单字段。
• type_and_submit：输入文本并同步触发按键操作（例如 Enter 提交）。
• navigate_and_snapshot：组合执行导航、等待就绪、获取快照三步操作。
• scroll_and_snapshot：滚动页面后立即获取快照，用于捕获“视口下方”（below-fold）内容。
• camofox_scroll_element_and_snapshot：滚动指定容器元素后立即获取快照。
• batch_click：按顺序依次点击多个元素。

配置文件（4 个）

• save_profile：将当前标签页的 Cookie 保存为具名配置文件。
• load_profile：将已保存的配置文件 Cookie 加载至指定标签页。
• list_profiles：列出所有已保存的配置文件及其元数据。
• delete_profile：删除指定已保存的配置文件。

预设（1 个）

• list_presets：列出所有可用的地理区域预设（geo presets）。

CamoFox 的独特之处

• 以隐蔽性为首要设计原则，专为需在对抗性网站上保持稳定运行的 AI 智能体打造
• 提供丰富的工具集（共 41 个），兼顾底层细粒度控制与高层抽象工作流
• 采用“快照优先”（snapshot-first）设计，在保留可操作上下文的同时显著降低 Token 消耗
• 原生支持配置文件与会话管理，适用于长期运行且需身份认证的自动化任务
• 提供原生 HTTP 协议的 MCP 接口，兼容 OpenClaw 及其他远程 MCP 兼容客户端