| name | wss-terminal |
| description | Use when extracting WSS terminal connection parameters (URL, cookie, protocol type) from browser pages for wss_connect tool usage |
WSS Terminal Probe
当页面包含 Web 终端（xterm.js 等）时，按以下步骤提取 WSS 直连参数。
前置条件
- 已通过
navigate_page 打开目标页面
take_snapshot 确认页面存在终端元素（.xterm、.terminal、Terminal input 等）
Step 1: 一键探测脚本
将以下 JS 复制到 evaluate_script 中执行：
() => {
const scripts = Array.from(document.querySelectorAll('script:not([src])'));
let wsScript = null;
for (const s of scripts) {
const t = s.textContent;
if (t.match(/WebSocket|ws:\/\/|wss:\/\/|onData|sendInput/)) {
wsScript = t;
break;
}
}
let wsUrl = null;
if (wsScript) {
const urlMatch = wsScript.match(/["'\x60](wss?:\/\/[^"'\x60]+)["'\x60]/);
if (urlMatch) wsUrl = urlMatch[1];
if (!wsUrl && wsScript.includes('location.host')) {
const pathMatch = wsScript.match(/["'\x60](\/ws\/[^"'\x60]*)["'\x60]/);
if (pathMatch) wsUrl = 'wss://' + location.host + pathMatch[1];
}
}
return {
wsUrl,
hasSendInput: wsScript?.includes('sendInput') || false,
hasBinaryPrefix: wsScript?.includes('CLIENT_CMD') || false,
hasGottyPrefix: wsScript?.match(/['"]1['"].*send/) !== null,
hasXterm: !!document.querySelector('.xterm'),
scriptLength: wsScript?.length || 0
};
}
Step 2: 判断协议类型
根据 Step 1 返回值映射：
| 特征 | 协议 |
|---|
hasSendInput=true 或 hasBinaryPrefix=true | ttyd |
hasGottyPrefix=true | gotty |
URL 包含 /wetty | wetty |
URL 包含 /api/v1/ + exec | k8s |
| 以上都不匹配 | generic |
Step 3: 提取认证凭证
3a. Cookie 提取
- 先试 JS 可访问的 cookie：
evaluate_script(() => document.cookie)
- 如果为空（httpOnly cookie），通过网络请求提取：
- 调用
list_network_requests 获取同域请求列表
- 选择一个成功的请求（200 状态码），调用
get_network_request(reqid=<id>)
- 从返回的 Request Headers 中提取
Cookie 字段值
- 如果仍为空，检查是否有
Authorization header（Bearer token 等），用 extra_headers 传递
3b. Origin 推断
从目标 URL 提取 Origin（scheme://host[:port]）：
wss://example.com/ws/shell → origin = "https://example.com"
ws://10.0.0.1:8080/ws → origin = "http://10.0.0.1:8080"
规则：wss 对应 https，ws 对应 http。
Step 4: 连接
wss_connect(
url=<Step1的wsUrl>,
cookie=<Step3a的cookie>,
protocol=<Step2的协议>,
origin=<Step3b的origin>,
extra_headers=<如有Authorization等额外header>,
subprotocols=<如服务器要求特定subprotocol，如["tty"]>
)
如果返回 4001 UNAUTHORIZED 或类似认证失败：
- 检查 Cookie 是否完整（httpOnly cookie 是否遗漏）
- 检查 Origin 是否正确
- 尝试添加
subprotocols（部分 ttyd 服务器要求 ["tty"]）
- 如果仍失败，回退到
window.__wt 方式（参见 additionalContext 中的初始化脚本）
手动分析回退
如果 Step 1 的探测脚本未找到 WebSocket 代码（高度混淆/打包的 JS），则：
- 用
evaluate_script 获取所有 <script src> 的 URL
- 用
WebFetch 下载 JS bundle
- 搜索
WebSocket、ws://、wss:// 关键词
- 从上下文中识别协议格式
