Convierte el tráfico de red de un sitio web en una especificación de API con OpenCode Browse

OpenCode Browse permite que tu agente de programación capture las llamadas a la API que realiza un sitio mientras tienes la sesión iniciada. Te contamos cómo convertir ese tráfico en una especificación OpenAPI y probarla con Apidog CLI, todo con un único prompt para el agente.

Ashley Innocent

Ashley Innocent

17 November 2026

Convierte el tráfico de red de un sitio web en una especificación de API con OpenCode Browse

Apidog para empresas

Despliegue local

SSO & RBAC

Conforme con SOC 2

Explorar Apidog Enterprise

Para convertir el tráfico de red de un sitio web en una especificación de API, deja que un agente de programación controle tu navegador real con OpenCode Browse: inicia una captura de network en una pestaña, tú navegas por el sitio con la sesión iniciada, y detiene la captura para obtener cada solicitud con las credenciales ocultas. Después, el agente escribe un archivo OpenAPI a partir de esos intercambios, y Apidog CLI lo importa y ejecuta una prueba contra él.

Esta guía recorre ese ciclo con un solo prompt para el agente: qué captura Browse, qué oculta y los comandos de apidog que completan el trabajo.

¿Qué es OpenCode Browse?

OpenCode Browse es un servidor MCP más una extensión de Chromium que permite a tu agente de programación usar tu navegador real, con tus pestañas, inicios de sesión y extensiones. Los agentes abren pestañas en segundo plano, leen páginas, hacen clic, escriben, toman capturas de pantalla, graban pestañas y capturan el tráfico de red. Cuando un paso te necesita (un inicio de sesión, un prompt de 2FA, un pago), el agente te devuelve la pestaña y espera hasta que hagas clic en Continuar.

Elemento Lo que dice la fuente
Licencia MIT (el archivo LICENSE del repositorio)
Primer código público Repositorio creado el 27 de octubre de 2026
Versión actual v0.1.0, publicada el 16 de noviembre de 2026 (una reescritura como un único binario de Rust)
Navegadores Chrome, Edge, Brave, Arc, Helium, Vivaldi, Opera, Chromium
Agentes OpenCode, Claude Code, Codex, Cursor, Zed y unos 30 clientes MCP más
Precio No se indica en la página del producto

La página del producto no muestra precio ni fecha de lanzamiento, así que considera la licencia MIT como la única señal de coste que puedes confirmar hoy. Si lo estás comparando con la ruta de DevTools, nuestra guía sobre Chrome DevTools MCP con Claude cubre la alternativa.

¿Por qué capturar el tráfico desde tu navegador real?

La mayoría de las API sin documentar están detrás de un inicio de sesión. Un navegador headless arranca sin cookies, así que tu agente se topa con un muro de inicio de sesión. Browse funciona dentro del perfil que ya usas, por lo que el agente ve las mismas solicitudes autenticadas que tú. Eso ayuda en tres tareas:

La versión manual es una exportación HAR desde DevTools; consulta nuestra guía sobre ingeniería inversa de APIs. La versión con agente escribe la especificación por ti.

Pipeline diagram: a signed-in browser tab feeds a Browse network capture with credentials redacted, a coding agent writes openapi.json from it, and Apidog CLI imports the file, creates a test case and runs it

Cómo convertir el tráfico de red de un sitio web en una especificación de API: 5 pasos

  1. Instala Browse y empareja la extensión con tu navegador.
  2. Pide a tu agente que abra el sitio en una pestaña de Browse e inicie una captura de network filtrada a XHR y Fetch.
  3. Navega por las funciones que quieras documentar y luego dile al agente que detenga la captura.
  4. Haz que el agente agrupe los intercambios en rutas y escriba openapi.json.
  5. Importa la especificación con Apidog CLI, crea un caso de prueba y ejecútalo.

Paso 1: Instala Browse y conecta tu agente

Browse se instala con un solo script en macOS y Linux:

curl -fsSL https://opencode.ai/browse/install | bash

En Windows, ejecuta irm https://opencode.ai/browse/install.ps1 | iex en PowerShell. También puedes usar npm i -g @opencode/browse y luego browse install.

browse install coloca el binario, añade el servidor MCP de Browse a los agentes que encuentra y empareja la extensión de Chrome Web Store. Para saltarte el selector interactivo:

browse install -a claude codex   # solo Claude Code y Codex
browse install -y                # todos los agentes encontrados en este equipo

Reinicia tu agente después. browse status informa de si el relay, la extensión y el emparejamiento están en buen estado.

Un detalle cambia cómo trabaja tu agente. OpenCode obtiene herramientas simples (navigate, snapshot, click, network y el resto). Claude Code, Codex, Cursor y otros clientes obtienen execute, status y tabs, donde execute ejecuta JavaScript que puede llamar a todas las herramientas de Browse. En cualquier caso, el agente accede a la misma captura de network.

Paso 2: Inicia una captura de red filtrada

La herramienta network toma una action de start, status, stop o cancel, con una captura por pestaña. En start puedes acotar lo que graba:

Opción Qué hace Valor por defecto
urlFilter Captura solo URLs que contengan este texto Ninguno
resourceTypes Captura solo estos tipos, como ["XHR", "Fetch"] Todos los tipos
methods Captura solo estos métodos HTTP Todos los métodos
bodies Captura los cuerpos de solicitud y respuesta true
maxDurationMs Finaliza y descarta la captura transcurrido este tiempo 1.800.000 (30 minutos)

Filtra a XHR y Fetch, y añade un urlFilter como /api/ para omitir los beacons de analítica. La llamada queda así:

{
  "action": "start",
  "tab": "<tabId>",
  "resourceTypes": ["XHR", "Fetch"],
  "urlFilter": "/api/"
}

Para mantener al agente en un solo sitio, abre la pestaña con allowedOrigins. El README de Browse deja claro que esto limita la navegación, no las solicitudes que una página hace por sí misma, así que es una salvaguarda, no un límite de datos.

Paso 3: Navega por el sitio y detén la captura

Ahora usa el sitio en la pestaña del agente: abre una lista, filtra, visualiza una página de detalle, crea y elimina un registro de prueba. Si el sitio te pide iniciar sesión a mitad de sesión, el agente llama a handoff, tú completas el inicio de sesión y haces clic en Continuar.

Cuando termines, el agente envía {"action": "stop"}. Eso devuelve cada intercambio: método, URL, cabeceras, estado y cuerpos. Conviene conocer los límites:

Las credenciales siempre se sustituyen por [redacted]: cabeceras de autorización y claves de API, cada valor de cookie, campos de consulta, JSON y formulario con nombres de secretos, y segmentos de ruta con aspecto de token. El README advierte que un secreto bajo un nombre de campo común aún puede colarse, así que revisa la especificación antes de compartirla.

Un cambio que debes tener en cuenta: la versión 0.0.17 (14 de noviembre de 2026) eliminó la exportación HAR, y las capturas ahora devuelven directamente el tráfico oculto. Si necesitas un archivo HAR, expórtalo desde DevTools y usa nuestra guía sobre importar un archivo HAR a Apidog.

Paso 4: Deja que el agente escriba la especificación OpenAPI

El tráfico en bruto no es una especificación. Las llamadas a /api/orders/1042, /api/orders/877 y /api/orders/15 deberían convertirse en una sola ruta, /api/orders/{orderId}, con un único esquema de respuesta. Un agente de programación es bueno precisamente en esto: detectar el patrón e inferir los tipos a partir de respuestas reales.

Diagram showing three captured GET requests to /api/orders/1042, /api/orders/877 and /api/orders/15 with JSON bodies, grouped by pattern into one OpenAPI path GET /api/orders/{orderId} with an integer orderId parameter and an Order response schema, with the Authorization header shown as redacted

Pide al agente que siga unas pocas reglas para que el resultado se importe limpiamente:

Paso 5: Importa la especificación y pruébala con Apidog CLI

Una vez que existe openapi.json, delega el resto al mismo agente. Apidog CLI le ofrece comandos para importar especificaciones, crear casos de prueba y ejecutarlos, y cada comando imprime JSON estructurado que tu agente puede leer.

Configúralo una vez:

npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
apidog skill install

Luego dale a tu agente un solo prompt que cubra todo el trabajo:

Open https://app.example.com in a Browse tab limited to app.example.com.
Start a network capture for XHR and Fetch requests whose URL contains /api/.
Hand the tab to me, wait while I use the orders pages, then stop the capture.
Write openapi.json (OpenAPI 3.1, info.title "Example Orders API") with path
parameters for IDs and schemas from the real responses. Create an AI branch in
Apidog project <projectId>, import the spec there, create a test case for
GET /api/orders/{orderId} that asserts status 200 and a numeric id, run it
against environment <envId> and summarize any failures.

El agente ejecuta los comandos siguientes. Cada opción aquí proviene de apidog <cmd> --help en Apidog CLI 2.2.12:

apidog branch create --project <projectId> --type ai \
  --name "ai/20261117-from-main-orders-capture" --from main
apidog import --project <projectId> --branch "ai/20261117-from-main-orders-capture" \
  --format openapi --file ./openapi.json
apidog endpoint list --project <projectId> --branch "ai/20261117-from-main-orders-capture" \
  --path-contains /api/orders
apidog test-case category --project <projectId> --branch "ai/20261117-from-main-orders-capture"
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <projectId> --branch "ai/20261117-from-main-orders-capture" \
  --file case.json
apidog run --test-case <caseId> --project <projectId> --branch "ai/20261117-from-main-orders-capture" \
  -e <envId> -r cli,json

Importar en una rama de IA mantiene una especificación capturada alejada de tu diseño principal hasta que la hayas revisado. Si vuelves a capturar más tarde e importas de nuevo, mantén info.title sin cambios o pasa --module-map "<info.title>=<moduleId>", para que Apidog actualice los endpoints en su lugar en lugar de crear una segunda copia de cada uno.

Cuando la prueba pase, el mismo comando apidog run ... -r junit entra directamente en CI. Nuestra guía de CI/CD con Apidog CLI muestra la configuración del pipeline, y Apidog CLI en Claude Code cubre el lado del agente con más profundidad.

Consejos para una especificación capturada más limpia

Preguntas frecuentes

¿Es OpenCode Browse gratuito? El repositorio está bajo licencia MIT y la página del producto no indica precio. Eso es todo lo que la fuente confirma a fecha del 17 de noviembre de 2026, así que vuelve a consultar la página antes de planificar en función del coste.

¿OpenCode Browse funciona con Claude Code o solo con OpenCode? Funciona con Claude Code, Codex, Cursor, Zed y unos 30 clientes MCP más. browse install -a claude configura Claude Code. OpenCode obtiene herramientas simples, y los demás clientes obtienen una herramienta execute que llama a las mismas herramientas desde JavaScript.

¿Puede Browse exportar un archivo HAR? Ya no. La versión 0.0.17 eliminó la exportación HAR, y network ahora devuelve directamente el tráfico oculto como datos estructurados. Para un archivo HAR, guarda uno desde Chrome DevTools e impórtalo con apidog import --format har.

¿Mis cookies de sesión o tokens acabarán en la especificación? Browse oculta las cabeceras de autorización y claves de API, todos los valores de cookies, los campos con nombres de secretos y los segmentos de ruta con aspecto de token. Un secreto almacenado bajo un nombre de campo común aún puede aparecer, así que revisa el archivo antes de compartirlo.

¿Qué formato de importación de Apidog debo usar para la salida del agente? Usa --format openapi para la especificación que escribe el agente. Apidog CLI también acepta Postman, HAR, Insomnia, Swagger 2.0 y más de 20 formatos adicionales mediante el mismo comando apidog import.

Practica el diseño de API en Apidog

Descubre una forma más fácil de construir y usar APIs