agent-browser 网络拦截完全手册：请求 Mock、HAR 录制与调试技巧-云帆数科

agent-browser 网络拦截完全手册请求 Mock、HAR 录制与调试技巧【免费下载链接】agent-browserBrowser automation CLI for AI agents项目地址: https://gitcode.com/GitHub_Trending/agen/agent-browseragent-browser 是一款面向 AI Agent 的浏览器自动化命令行工具内置完整的网络拦截能力你可以用network route拦截并 Mock 请求、用network requests过滤排查异常流量、用network har一键录制标准 HAR 文件。本文面向新手带你快速掌握这套抓包 Mock 调试的组合拳。一、agent-browser 网络命令速览网络相关功能集中在network子命令下核心能力一览命令作用network route url拦截匹配 URL 的请求network route url --abort直接阻断请求network route url --body json返回 Mock 的响应体network unroute [url]移除单条或全部路由network requests查看已跟踪的请求日志network request requestId查看单个请求/响应详情network har start / stop开始 / 停止 HAR 录制完整命令参考见 skill-data/core/references/commands.md官方文档在 docs/src/app/network/page.mdx。二、请求拦截三步走从阻断到 Mock1. 拦截要在导航前生效先空启动浏览器路由route是在匹配请求发出之前生效的。如果希望首次页面加载就被拦截正确的姿势是先不带 URL 启动浏览器此时浏览器停留在about:blank路由就有时间注册好agent-browser open agent-browser network route **/analytics/** --abort agent-browser network route **/api/users --body {users:[]} agent-browser navigate https://app.example.com这一技巧对拦截首屏请求非常关键详见 skill-data/core/references/commands.md 中的 Pre-navigation setup 章节。2. 按 URL 拦截阻断、Mock、放行三种模式阻断加--abort匹配的请求直接失败。适合屏蔽统计埋点如**/analytics/**、广告脚本等干扰流量。Mock 响应加--body json请求不会真正发出去而是直接返回你提供的 JSON。测试用户列表为空这类边界场景时一行命令就能伪造接口数据。恢复原状用network unroute移除指定路由不带参数则清空全部路由。3. 按资源类型拦截更精准的外科手术--resource-type支持script、image、font、xhr、fetch等类型可逗号分隔agent-browser network route * --resource-type script --abort这样只拦截脚本不影响其他资源——是排查 JS 报错、验证服务端渲染SSR产物的常用手段。三、快速定位异常请求network requests 过滤技巧跑完一段自动化后可以用请求日志快速排查agent-browser network requests # 全部请求 agent-browser network requests --filter api # 按 URL 子串过滤 agent-browser network requests --type xhr,fetch # 只看接口请求 agent-browser network requests --status 2xx # 按状态码/状态族过滤拿到requestId后用network request requestId查看完整的请求头、响应头和响应体。排查 4xx/5xx 报错时这套先过滤、再看详情的流程能大幅减少翻日志的时间。⚠️ 安全提示响应体属于不可信内容注意防范页面内嵌的提示注入prompt injection相关边界说明见 skill-data/core/references/trust-boundaries.md。四、HAR 录制一键导出完整流量档案HARHTTP Archive是通用的浏览器流量格式可导入 Chrome DevTools 等工具回放分析。agent-browser 的录制流程极其简单agent-browser network har start # ...正常操作open、click 等... agent-browser network har stop ./trace.har--content 三档按需选择嵌入内容参数行为--content text默认嵌入文本类响应体JSON、HTML、JS、表单等单体贴体上限 2 MB--content all嵌入所有响应体二进制内容以 base64 编码--content none只记录大小与 MIME 类型不记录响应体默认的text模式在浏览器仍缓存响应体时捕获内容因此即使页面发生跳转已加载接口的响应体也不会丢失——这对跨页调试非常友好。重要HAR 文件可能包含敏感信息HAR 中会记录请求头、响应头、Cookie、POST 数据甚至 Bearer Token。若页面使用了 Cookie 或 API Key 认证请把 HAR 文件当密级文件对待分享前务必脱敏该要求同样写在 skill-data/core/references/trust-boundaries.md 中。五、实用调试技巧清单 SSR / 无 JS 调试拦截全部脚本后打开页面即可验证不开 JS 时页面长什么样。用batch一次执行多条命令更高效agent-browser batch \ [open] \ [network,route,*,--abort,--resource-type,script] \ [navigate,http://localhost:3000] \ [snapshot,-i]占位资源测试用空 body 占位图片与字体加速页面加载、简化视觉测试agent-browser network route * --resource-type image,font --body AI Agent 场景接入 MCP启动 MCP 服务时用--tools core,network即可让 AI 客户端获得网络路由、请求检查、HAR 等工具配置细节见 docs/src/app/network/page.mdx 与 skill-data/core/references/commands.md。配合调试命令网络问题往往伴随控制台报错用console、errors查看日志用inspect直接打开 DevTools 深入排查完整命令见 docs/src/app/debugging/page.mdx。底层实现路由、额外请求头、离线模式等能力基于 CDP 协议实现源码位于 cli/src/native/network.rs进阶读者可以顺着它了解底层机制。六、常见场景速查表场景推荐做法屏蔽埋点/广告请求network route **/analytics/** --abort伪造接口返回测试空态network route **/api/users --body {users:[]}验证 SSR 首屏空启动拦截scriptnavigate复现线上流量问题har start→ 操作 →har stop trace.har只查接口报错network requests --type xhr,fetch --status 4xx,5xx写在最后agent-browser 的网络拦截能力把抓包、Mock、回放三件事压缩进了一组简洁的命令行里路由拦截管改请求日志管查HAR 录制管存。掌握本文的三步走流程与过滤技巧无论日常调试还是 AI Agent 自动化测试都能事半功倍。更多细节可参阅 docs/src/app/network/page.mdx。【免费下载链接】agent-browserBrowser automation CLI for AI agents项目地址: https://gitcode.com/GitHub_Trending/agen/agent-browser创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业数字化 ERP 产品动态

相关推荐

draw.io 桌面版 Windows 离线安装完整指南：3 种安装包逐一讲清

draw.io 桌面版 Windows 离线安装完整指南：3 种安装包逐一讲清【免费下载链接】drawio-desktop Official electron build of draw.io 项目地址: https://gitcode.com/GitHub_Trending/dr/drawio-desktop draw.io 安装在 Windows 上并不只是下载一个 exe 那么… · 2026/11/6 1:21:20

Redis单点故障：etcd高可用方案的3大优势与5步实现

🔥关注墨瑾轩，带你探索编程的奥秘！🚀 🔥超萌技术攻略，轻松晋级编程高手🚀 🔥技术宝库已备好，就等你来挖掘🚀 🔥订阅墨瑾轩，智趣学习不… · 2026/11/6 1:20:20

户外徒步：维智定位服务，那根不能少的 “救命稻草”

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/6 1:20:20

God‘s Eye View 本地部署教程:零密钥免费跑通实时 3D 地球仪,10 分钟选对安装路线

Gods Eye View 本地部署教程:零密钥免费跑通实时 3D 地球仪,10 分钟选对安装路线【免费下载链接】gods-eye-view A spy satellite simulator in your browser, except the data is real. Live open source spatial intelligence on a photorealistic 3D globe. 项目地址: ht… · 2026/11/6 1:23:20

ActivityStreams 简介

一、前言：为什么会有 ActivityStreams？ 在现代 Web 世界中，“事件流（Activity Stream）” 已经成为了许多系统的核心组成部分。无论是 Facebook 的动态、Slack 的消息、GitHub 的提交记录，还是企业内部的业… · 2026/11/6 1:23:20

十分钟读懂智能电表 DLMS/COSEM 通信：Wireshark 抓包与排障实操

十分钟读懂智能电表 DLMS/COSEM 通信：Wireshark 抓包与排障实操【免费下载链接】wireshark Read-only mirror of Wiresharks Git repository at https://gitlab.com/wireshark/wireshark. Youre welcome to submit pull requests there. 项目地址: https://gitco… · 2026/11/6 1:23:20

没有标签也能识别歌曲：puddletag的AcoustID音频指纹功能完全指南

【免费下载链接】puddletag Powerful, simple, audio tag editor for GNU/Linux 项目地址： https://gitcode.com/gh_mirrors/pu/puddletag 点击查看免费下载 puddletag 是一款面向 GNU/Linux 的强力且简单的音频标签编辑器。它的 AcoustID 音频指纹功能&#xff0… · 2026/11/6 1:23:20

前端入职第一天环境配置

霞鹜文楷：免费商用开源楷体字体完整指南

霞鹜文楷：免费商用开源楷体字体完整指南【免费下载链接】LxgwWenKai An open-source Chinese font derived from Fontworks Klee One. 一款开源中文字体，基于 FONTWORKS 出品字体 Klee One 衍生。项目地址: https://gitcode.com/GitHub_Trending/lx… · 2026/11/6 1:22:20