SuperAPI AI 工具集

cloakbrowser

办公与效率

查看项目

更新于 10-16 09:47

技能介绍

用途:CloakBrowser 用于对会拦截自动化工具的网站进行抓取、截图、生成 PDF 与浏览器自动化。它由源码补丁版 Chromium 和 Playwright 风格的 Python 封装组成,指纹在 C++ 层修改(canvas、WebGL、音频、字体、WebRTC、TLS、CDP 输入、navigator.webdriver、插件列表、window.chrome 等),而非易被升级破坏的 JS 兼容层。

主要能力:提供 CLI 管理二进制(install、info、update、clear-cache),以及实现 fetch、screenshot、pdf、eval-js、check-stealth 的现成脚本,脚本普遍支持 --humanize、--proxy、--geoip、--wait、--timeout 等参数。也可通过 serve.sh 启动 CDP 服务,供多个工具调用共享长期会话。

使用方式:安装用 uv tool install cloakbrowser 与 cloakbrowser install(下载约 206 MB 的 Chromium)。脚本按绝对路径调用,如 $SK/fetch.py https://example.com --text。内联 Python 使用 from cloakbrowser import launch,API 与 Playwright 同步 API 一致,但 launch() 是顶层函数,隐身参数放在 launch() 上。持久会话用 launch_persistent_context(user_data_dir)。

适用场景:目标站点拦截普通抓取或自动化时;需要截图、PDF、执行 JS 取值,或进行登录、点击、条件等待等多步交互流程时。

限制与注意:不要用 pip 系统级安装,也不要用 playwright install 或系统 Python 导入模块;简单未受保护站点无需开启 humanize,会增加延迟;一次性抓取不必常驻 CDP 服务。启动慢可设 auto_update=False 或 CLOAKBROWSER_AUTO_UPDATE=0 跳过更新检查;仍被拦截时按 humanize、住宅代理加 geoip、持久化配置的顺序排查。