browser-to-api · 从网页请求整理接口规范

作者提供的示例，实际效果取决于你的输入和使用工具。

输入

编辑构造材料（未运行）：
捕获 GET https://api.example.test/items/7，返回 200 application/json：{"id":7,"name":"Notebook"}。仅有这一条样本，不保留认证头。

输出

编辑示例 · 未运行

openapi: 3.1.0
info:
  title: Observed Items API
  version: 0.1.0
paths:
  /items/{id}:
    get:
      parameters:
        - name: id
          in: path
          required: true
          schema: {type: integer}
      responses:
        "200":
          description: Observed successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  id: {type: integer}
                  name: {type: string}

单一样本只能支持这些字段类型；没有断言所有响应都包含这些字段。

读取 browser-trace 记录，将可观察的 HTTP 交互整理成 OpenAPI 3.1。

具体任务

把已捕获请求整理成接口说明：读取 browser-trace 记录，将可观察的 HTTP 交互整理成 OpenAPI 3.1。

必需材料

browser-trace 的 .o11y/run 目录或脱敏请求响应记录

要纳入的域名和操作范围

可选材料

可选响应 body 捕获文件

已知认证与分页规则

使用门槛

能提供获准网络记录，具备 Node.js 18+。

这个 Skill 额外提供的方法

配对 CDP requestId 的请求与响应，合并 URL 模板并推断 JSON schema，同时输出覆盖率和置信度报告。

编辑示例（未运行）

把已捕获请求整理成接口说明

任务：把已捕获请求整理成接口说明

输入：
编辑构造材料（未运行）：
捕获 GET https://api.example.test/items/7，返回 200 application/json：{"id":7,"name":"Notebook"}。仅有这一条样本，不保留认证头。

结果片段：
```yaml
openapi: 3.1.0
info:
  title: Observed Items API
  version: 0.1.0
paths:
  /items/{id}:
    get:
      parameters:
        - name: id
          in: path
          required: true
          schema: {type: integer}
      responses:
        "200":
          description: Observed successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  id: {type: integer}
                  name: {type: string}
```
单一样本只能支持这些字段类型；没有断言所有响应都包含这些字段。

这是依据固定入口方法撰写的编辑示例，没有运行上游 Skill 或访问真实账号。配对 CDP requestId 的请求与响应，合并 URL 模板并推断 JSON schema，同时输出覆盖率和置信度报告。

首次任务

请使用已安装的 browser-to-api Skill。
任务：把已捕获请求整理成接口说明。

我的必需材料：
- browser-trace 的 .o11y/run 目录或脱敏请求响应记录：[粘贴我的实际材料或路径；缺少时写明]
- 要纳入的域名和操作范围：[粘贴我的实际材料或路径；缺少时写明]

可选补充：
- 可选响应 body 捕获文件：[可选，未提供时不要假定存在]
- 已知认证与分页规则：[可选，未提供时不要假定存在]

请先确认材料是否足够，只处理我提供的范围。本技能离线处理，不负责捕获流量；接口说明只覆盖观察样本，不推断未见过的权限或写操作。交付可直接审阅的代码或查询片段，明确尚未执行或验证的部分。不要代入页面例子的虚构数据。
验收：
1. 端点与方法均可定位捕获记录。
2. 未采集 body 的接口没有虚构响应 schema。
3. 报告注明样本数量、覆盖与敏感信息处理。

验收方法

端点与方法均可定位捕获记录。

未采集 body 的接口没有虚构响应 schema。

报告注明样本数量、覆盖与敏感信息处理。

依赖与准备

需要完整 Skill 目录，保留 scripts/start-capture.mjs、scripts/stop-capture.mjs、scripts/bisect-cdp.mjs、scripts/discover.mjs 等引用。需要 Node 18+ 和 sibling browser-trace 产物；脚本仅用 Node 标准库，不要求 npm install；可选 browse network body 捕获，jq 不是脚本必需。

使用边界

本技能离线处理，不负责捕获流量；接口说明只覆盖观察样本，不推断未见过的权限或写操作。

需要授权浏览记录；只能覆盖捕获到的请求，需移除令牌和私密响应。

页面中的例子为编辑撰写，未运行上游 Skill；不代表平台兼容认证或生产实测。

排错

只有端点没有字段：确认是否捕获响应 body；不能从 URL 推断响应结构。

令牌出现在样本：先脱敏请求头、cookie 与 body，再生成或分享文档。

固定来源

https://github.com/browserbase/skills/blob/6811ca31163332d9d60309cff48e77f09de37a17/skills/browser-to-api/SKILL.md

许可

MIT。许可原文：https://github.com/browserbase/skills/blob/6811ca31163332d9d60309cff48e77f09de37a17/skills/browser-to-api/LICENSE.txt

仓库热度

browserbase/skills 仓库 3,731 Stars（2026-09-30 核验）；这是父仓库指标，不是单个 Skill 的评分。

先看看示例

输入

输出

方法说明