没有接口文档,如何利用 AI 辅助接口测试、接口自动化测试?分享我的抓包+Skill 方案…

在 AI 驱动的接口测试与自动化流程里，能否让 AI 拿到精准、完整、可直接解析的接口数据源，是整个链路最核心、也是最关键的第一步。

但现实中，不少测试同学都会遇到一个痛点：开发没给完整接口文档，自己又没有项目代码查阅权限——接口用例写不了，自动化脚本也推不动。只能打开浏览器 F12 抓包，把 CURL 一个个复制出来，再手工整理成文档，效率低、还容易漏字段。

有没有一种方式，能直接从浏览器抓包文件里，自动生成一份初版接口文档，再交给 AI 做用例生成和自动化？

针对这个场景，我开发了对应的Skill。今天这篇，给大家分享下思路和使用案例

一、背景说明

之前我分享过几套接口文档获取方案：YApi / Swagger 一键拉取、扫描后端源码生成接口文档——这些在「有平台、有代码权限」的项目里是可行的。

但在不少团队里，还会遇到更棘手的场景：

1.开发不提供接口文档：口头说你抓包看吧。

2. 没有代码权限：不少公司，测试同学是没有查看代码仓库的权限。

3. 手工整理抓包数据：F12 里请求一多，复制 CURL、对照参数，重复劳动极多；

4. 信息残缺：漏掉 Header、Cookie、公共参数，AI 生成的接口用例和脚本直接跑偏。

我的思路是：把浏览器导出的 HAR 抓包文件，交给 Skill 自动解析，先出接口清单、再生成 Markdown 文档，让测试同学在无文档、无代码的特殊场景下，也能快速拿到 AI 可用的结构化接口上下文。

二、什么是 HAR 文件？

HAR = HTTP Archive，后缀 .har，本质是一份 JSON 格式的日志文件，专门记录浏览器发起的所有网络请求全过程。你在浏览器点开页面、调用接口时，每一次网络收发数据都会被完整记录下来，全部存在这个文件里。

哪里可以找到har文件？

我们平时在浏览器抓包时，开发者工具里面就能导出HAR文件，如下图：

内部记录了什么内容呢？

1.请求基础信息：请求 URL、请求方法 GET/POST、状态码 200/404/502、域名、Cookie、Headers

2.耗时细分（排查性能也常用）：DNS 解析时间、TCP 连接建立、SSL/TLS 握手耗时、等待服务器响应（TTFB）、文件下载耗时

3.传输数据：请求体 payload、返回响应体、图片/接口/JS/CSS 大小、压缩前后体积

4.附加信息：页面加载时间、缓存命中情况、重定向链路、错误详情

因此，HAR 文件可以作为接口文档的上下文信息，适合作为 AI 辅助接口测试的数据源。

三、Skill整体执行流程

四、实操步骤

1、Skill获取&安装

下载 Skill 包，解压到项目中的 Skill 目录下，例如：cursor里面是.claude/skills

skill获取方式：

可以自己根据Raina提供的思路进行开发skill，如果需要现成的，也可以加入知识星球获取~里面还有很多AI赋能测试全流程的实战教程，学习过程中有疑惑也可以进行提问~

2、har获取

按照你想要进行测试的流程去页面请求接口，这里我以公寓管理为案例，我下面进行新增、修改、删除、查询的操作

可以看到，在我进行操作之后，执行了下面这些接口

点击下载按钮，下载har文件到本地

3、执行Skill

首先先将下载后的har文件，移动到项目中，如下

之后进行Skill的执行，输入：

❝

/har-to-api-doc @har文件

AI输出：

AI根据har文件，列出了4个接口，也就是我们刚刚操作的增删改查的接口，这里是没有问题的

AI还输出了下面的信息，让我们进行判断需要生成的接口

这里的接口都是我需要的，因此我继续输入“全部”

在输出后，AI则会根据输入，产出一份md格式的接口文档，下面看看相关的截图

这里AI按照har的要求，整理出了4个接口，并且整理出了公共请求头

对请求参数也进行了整理，对字段的名称按照意思进行了翻译，如果遇到不确定的字段，则标注“待补充”

五、使用说明与边界

我们直接通过 HAR 文件去生成接口文档，会有不少事项是不确认的，例如：

参数缺失、响应字段缺失
必填项不清、异常编码不明确
业务规则、枚举含义无法从单次抓包推断

因此，对于待确认或者待补充项，可以找开发或者产品进行补充。但即便如此，这种方案也能进行一定的提效，适用于开发不提供接口文档、但我们又要去实现接口测试或者接口自动化测试的特殊场景。

拿到初版文档之后，你可以：

找开发/产品补充「待补充」字段；
将 Markdown 文档作为上下文，对接接口用例生成、接口自动化脚本等后续 Skill；
业务迭代后，重新走一遍业务流程、导出新的 HAR，一键刷新文档。

六、小结

接口文档是接口测试与自动化的根基。YApi、Swagger、源码扫描能覆盖大部分场景，但针对那些连接口文档都能拿到的小伙伴，har-to-api-doc Skill 的核心价值，就是把浏览器里现成的网络交互数据，快速转成 AI 可读的结构化接口文档——让你不再卡在「第一步整理接口信息」，而是把精力放在用例设计、场景串联和质量判断上。

以上是今天的分享，文中 Skill包、详细教程和配套示例，均已整理至【Raina的AI&测试实战圈】知识星球。跟着步骤操作就可以上手，遇到问题也可以在里面提问，感兴趣的小伙伴可以加入了解哦～