API Tracer

录制浏览器中的网络请求，分析 API 端点，生成可用于自动化的报告。

安装

首次使用前，在 skill 目录下执行：

cd skills/api-tracer && npm install

前置条件

需要 Playwright Skill 已启动浏览器。API Tracer 通过 CDP 连接到同一浏览器实例。

使用方式

所有命令格式：

node skills/api-tracer/tool.js <命令> '<JSON参数>'

核心工作流

1. 启动录制

node skills/api-tracer/tool.js start '{"name": "my-session"}'

可选参数：

• name：会话名称（默认自动生成）
• filter：URL 过滤关键词，只录制包含此关键词的请求
• wsEndpoint：手动指定浏览器 WebSocket 地址

2. 操作页面

录制启动后，通过 Playwright Skill 操作页面或手动在浏览器中操作：

node skills/playwright/tool.js navigate '{"url":"https://example.com"}'
node skills/playwright/tool.js click '{"ref":"e5","element":"登录按钮"}'

所有网络请求会被自动捕获。

3. 查看录制状态

node skills/api-tracer/tool.js status '{}'

4. 停止录制

node skills/api-tracer/tool.js stop '{}'

停止后数据自动保存。

5. 查看录制结果

列出所有请求：

node skills/api-tracer/tool.js detail '{"name": "my-session"}'

按 URL 过滤：

node skills/api-tracer/tool.js detail '{"name": "my-session", "filter": "api/"}'

查看单个请求详情（含 headers、body）：

node skills/api-tracer/tool.js detail '{"name": "my-session", "index": 0}'

6. 生成分析报告

JSON 格式：

node skills/api-tracer/tool.js report '{"name": "my-session"}'

Markdown 格式：

node skills/api-tracer/tool.js report '{"name": "my-session", "format": "markdown"}'

curl 命令导出：

node skills/api-tracer/tool.js report '{"name": "my-session", "format": "curl"}'

命令参考

命令	说明
start	启动录制（后台 daemon）
stop	停止录制并保存
status	查看录制状态
sessions	列出所有历史会话
detail	查看会话的请求列表或单个请求详情
report	生成分析报告（json/markdown/curl）
delete	删除历史会话

自然语言交互指南

用户说	执行
"开始录制网络请求"	start '{"name": "session-name"}'
"只录制 API 请求"	start '{"name": "session-name", "filter": "api/"}'
"停止录制"	stop '{}'
"录制状态" / "在录制吗"	status '{}'
"看看录制了什么"	detail '{"name": "session-name"}'
"看看第 3 个请求的详情"	detail '{"name": "session-name", "index": 2}'
"生成 API 报告"	report '{"name": "session-name", "format": "markdown"}'
"导出为 curl"	report '{"name": "session-name", "format": "curl"}'
"有哪些录制"	sessions '{}'
"删除这个录制"	delete '{"name": "session-name"}'

报告内容

分析报告包含：

• API 端点列表（自动去重）
• 每个端点的 HTTP 方法、URL 模式
• 请求头（重要字段）
• Cookie 列表
• 请求体格式和 schema
• 响应体格式和 schema
• 认证方式自动识别（Bearer Token / API Key 等）

典型场景

场景：分析一个网站的 API 接口

# 1. 用 Playwright 打开网站
node skills/playwright/tool.js navigate '{"url":"https://app.example.com"}'

# 2. 启动 API 录制
node skills/api-tracer/tool.js start '{"name": "example-api", "filter": "api/"}'

# 3. 通过 Playwright 操作页面（登录、浏览等）
node skills/playwright/tool.js fillForm '{"fields":[...]}'
node skills/playwright/tool.js click '{"ref":"e5","element":"登录"}'

# 4. 停止录制
node skills/api-tracer/tool.js stop '{}'

# 5. 生成报告
node skills/api-tracer/tool.js report '{"name": "example-api", "format": "markdown"}'