用途:把浏览器中的一次操作录制下来,转化成可重复直接调用网站内部 API 的独立客户端(脚本、CLI 或库),避免每次都驱动浏览器。
主要能力:录制网络流量生成 HAR;默认在 HAR 中嵌入文本响应体(JSON/HTML/JS),便于离线分析端点结构;用 jq 查询过滤真实 API;提取请求头、POST 体、响应结构与鉴权材料;按每个流程生成一个函数并做类型标注;生成后逐一真实校验端点。
工作流程:1) 录制,运行 agent-browser network har start,驱动目标流程后执行 agent-browser network har stop /tmp/site.har;每类流程至少用不同输入跑两遍,便于对比出参数。2) 识别端点,用 jq 筛选 JSON 调用,忽略分析、遥测与第三方域名。3) 提取结构与鉴权,对比各端点请求头,找出 authorization、cookie、x-csrf-token 等;用 agent-browser cookies get --json > cookies.json 导出会话 Cookie。4) 生成客户端,鉴权材料从文件或环境变量加载。5) 校验,对真实 API 调用每个函数并比对响应结构。
适用场景:需要批量、频繁访问某站内部接口时,如批量抓取、自动化查询、自建 CLI 工具。
限制与注意:内部 API 通常无版本控制且会随时变动,应保留 HAR 以便重新生成;HAR 含会话凭证,须当作机密处理,不纳入版本控制并在用完后删除;生成客户端应遵守网站服务条款与速率限制,批量抓取需加延迟;--content all 会嵌入二进制体(base64),--content none 关闭嵌入,单个体上限 2 MB。常见失败如 401/403(会话过期需重新登录导出 Cookie)、写操作的 CSRF 问题、签名或过期参数等,部分需回退到浏览器驱动。其余细节资料暂未提供。