SuperAPI AI 工具集

skill

智能体与模型

查看项目

更新于 10-28 11:12

技能介绍

CamoFox MCP Skill 是一个为 OpenClaw 智能体提供的反检测浏览器自动化技能,基于 MCP HTTP 传输连接 CamoFox Browser,让智能体能够浏览、点击、输入、提取内容、管理 Cookie 与会话、执行搜索工作流并下载资源,同时降低标准自动化栈常见的封禁率。

用途方面,该技能主要解决浏览器自动化中频繁遇到的验证码、指纹检测和机器人检测问题。CamoFox 针对这一现实场景设计,提供每标签页/会话的反检测指纹、对严格检测自动化站点的更强韧性、令牌高效的可访问性快照、通过 Cookie/配置文件工具实现会话持久化,以及覆盖 14 个搜索引擎的内置搜索宏。

主要能力包括 47 个工具,分为多个类别。健康检查 1 个:server_status 检查 CamoFox 服务器健康状态与浏览器连接。标签页 3 个:create_tab 创建带反检测指纹的新标签页,支持 URL、用户/会话隔离、视口/显示尺寸、地理位置覆盖、代理配置等;close_tab 关闭标签页并释放资源;list_tabs 列出所有打开的标签页。导航 4 个:navigate、go_back、go_forward、refresh。交互 8 个:click、type_text、scroll、camofox_scroll_element、camofox_evaluate_js、camofox_hover、camofox_wait_for、camofox_press_key。观察 8 个:snapshot(首选的页面内容读取方式)、screenshot、get_links、camofox_get_page_html、camofox_query_selector、camofox_wait_for_text、camofox_wait_for_selector、youtube_transcript。下载 3 个:list_downloads、get_download、delete_download。提取 4 个:extract_resources、extract_structured、batch_download、resolve_blobs。搜索 1 个:web_search 支持 google、youtube、amazon、reddit、wikipedia、twitter、yelp、spotify、netflix、linkedin、instagram、tiktok、twitch 等 14 个宏。会话 4 个:import_cookies、get_stats、camofox_close_session、toggle_display。批量工作流 6 个:fill_form、type_and_submit、navigate_and_snapshot、scroll_and_snapshot、camofox_scroll_element_and_snapshot、batch_click。配置文件 4 个:save_profile、load_profile、list_profiles、delete_profile。预设 1 个:list_presets 列出 CamoFox 服务器支持的地理预设。

使用方式上,首先需要启动 CamoFox Browser(默认 http://localhost:9377),建议使用 camofox-browser 2.4.7 或更新版本。然后以 HTTP 模式启动 CamoFox MCP,例如运行 CAMOFOX_TRANSPORT=http npx camofox-mcp@1.16.0,可附加 CAMOFOX_API_KEY、CAMOFOX_HTTP_HOST、CAMOFOX_HTTP_API_KEY、CAMOFOX_HTTP_PORT、CAMOFOX_VIEWPORT 等环境变量。接着在 OpenClaw 中添加 MCP 服务器配置,指向 http://localhost:3000/mcp。也可以通过 npx @filiksyos/mcptoskill http://localhost:3000/mcp 生成技能。使用前先调用 server_status 验证服务器运行,然后 create_tab 创建标签页,navigate 导航,snapshot 读取内容,再用 click、type_text 等交互工具操作。自定义搜索引擎可通过设置 CAMOFOX_SEARCH_URL_TEMPLATE 环境变量实现,模板必须是绝对 HTTP(S) URL,且路径或查询中恰好包含一个字面量 {query},不支持在主机、凭据或片段中出现;修改后需重启 MCP。

适用场景包括:浏览站点并提取数据;自动化登录、搜索或表单流程;使用隐蔽或反检测浏览器;通过快照点击输入完成工作流;从页面特定区域收集所有链接、图片或 PDF;持久化会话 Cookie 并稍后恢复;在浏览器中运行网页搜索并总结结果;下载文件并返回元数据或内容。

限制方面,资料未提供收费、价格或具体平台兼容性细节(仅提及 Windows x64 在 camofox-browser 2.4.7 下仅支持 headless: true)。CamoFox Browser 必须先在默认地址运行。自定义搜索依赖浏览器导航与快照,不自建新宏或直接 MCP HTTP 抓取;自托管或私有 SearXNG 需要浏览器现有网络策略允许。搜索 URL 中不应存储密钥,因为导航 URL 可能出现在工具输出、浏览器历史和日志中。