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），仅供参考 
长河君 · 2026/11/6 1:21:34 · 阅读 1.2k 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），仅供参考