SuperAPI AI 工具集

using-webctl

智能体与模型

查看项目

更新于 10-16 02:35

技能介绍

用途:在 Claude.ai 容器内使用 webctl CLI 做浏览器自动化、网页抓取与页面交互。容器流量经带认证的出口代理(HTTP_PROXY 环境变量含 JWT 凭据),Chromium 对 HTTPS CONNECT 隧道不处理代理认证,导致 HTTPS 导航失败,即使 curl 正常。

主要能力:本地转发代理(端口 18080)拦截 Chromium 连接并注入 Proxy-Authorization 头,再转发到真实出口代理;提供会话管理、导航、观察、交互与等待等命令。

使用方式:先安装并初始化: pip install webctl --break-system-packages webctl setup 将 scripts/auth_proxy.py 复制到 webctl 的 daemon 目录,并给 session_manager.py 打补丁,使 new_context 传入 proxy=proxy_config(移动模拟与桌面两个分支都要加;旧版只有单个 new_context 时注入该处)。随后验证: webctl start --mode unattended webctl --quiet navigate "https://github.com" webctl snapshot --interactive-only --limit 10 webctl stop 常用命令包括 start/stop/status、navigate/back/forward/reload、snapshot/query/screenshot、click/type/select,以及 wait network-idle 等条件。查询语法支持 role=button、name~="partial"、name="exact"、nth=0。

适用场景:需要浏览器自动化、抓取或页面交互,且受出口代理限制的环境。

限制:补丁为会话本地,容器重置后失效;仅可访问网络配置中允许的域名;不支持 Firefox(下载被出口策略阻止)。若报 ERR_TUNNEL_CONNECTION_FAILED,检查 auth_proxy.py 是否就位、session_manager 是否已打补丁,并重启 daemon;多匹配错误可加限定或 nth=0;可用 netstat -tlnp | grep 18080 确认代理运行。可用 --interactive-only、--limit、grep 与 --quiet 减少上下文消耗。