Transforme o Tráfego de Rede de Sites em uma Especificação de API com OpenCode Browse

O OpenCode Browse permite que seu agente de programação capture as chamadas de API que um site faz enquanto você está autenticado. Veja como transformar esse tráfego em uma especificação OpenAPI e testá-la com o Apidog CLI, usando um único prompt para o agente.

Ashley Innocent

Ashley Innocent

17 novembro 2026

Transforme o Tráfego de Rede de Sites em uma Especificação de API com OpenCode Browse

Apidog para empresas

Implantação local

SSO & RBAC

Conforme SOC 2

Explorar Apidog Enterprise

Para transformar o tráfego de rede de um site em uma especificação de API, deixe um agente de programação controlar seu navegador real com o OpenCode Browse: ele inicia uma captura network em uma aba, você navega pelo site já autenticado, e ele interrompe a captura para obter cada requisição com credenciais anonimizadas. O agente então escreve um arquivo OpenAPI a partir dessas trocas, e a Apidog CLI o importa e executa um teste com base nele.

Este guia percorre esse ciclo com um único prompt de agente: o que o Browse captura, o que ele oculta e os comandos do apidog que concluem o trabalho.

O que é o OpenCode Browse?

O OpenCode Browse é um servidor MCP mais uma extensão para Chromium que permite ao seu agente de programação usar seu navegador real, com suas abas, logins e extensões. Os agentes abrem abas em segundo plano, leem páginas, clicam, digitam, tiram capturas de tela, gravam abas e capturam o tráfego de rede. Quando uma etapa precisa de você (um login, um prompt de 2FA, um pagamento), o agente devolve a aba e aguarda até você clicar em Continuar.

Item O que a fonte diz
Licença MIT (arquivo LICENSE do repositório)
Primeiro código público Repositório criado em 27 de outubro de 2026
Release atual v0.1.0, publicada em 16 de novembro de 2026 (uma reescrita como um único binário Rust)
Navegadores Chrome, Edge, Brave, Arc, Helium, Vivaldi, Opera, Chromium
Agentes OpenCode, Claude Code, Codex, Cursor, Zed e cerca de 30 outros clientes MCP
Preço Não informado na página do produto

A página do produto não lista preço nem data de lançamento, então trate a licença MIT como o único sinal de custo que você pode confirmar hoje. Se você está comparando com o caminho via DevTools, nosso guia sobre o Chrome DevTools MCP com Claude cobre a alternativa.

Por que capturar o tráfego do seu navegador real?

A maioria das APIs não documentadas fica atrás de um login. Um navegador headless começa sem cookies, então seu agente esbarra em uma barreira de autenticação. O Browse funciona dentro do perfil que você já usa, então o agente vê as mesmas requisições autenticadas que você. Isso ajuda em três tarefas:

A versão manual é uma exportação HAR do DevTools; veja nosso guia sobre engenharia reversa de APIs. A versão com agente escreve a especificação para você.

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

Como transformar o tráfego de rede de um site em uma especificação de API: 5 etapas

  1. Instale o Browse e pareie a extensão com seu navegador.
  2. Peça ao seu agente para abrir o site em uma aba do Browse e iniciar uma captura network filtrada para XHR e Fetch.
  3. Navegue pelas funcionalidades que deseja documentar e, em seguida, peça ao agente para interromper a captura.
  4. Faça o agrupar as trocas em paths e escrever o openapi.json.
  5. Importe a especificação com a Apidog CLI, crie um caso de teste e execute-o.

Etapa 1: Instalar o Browse e conectar seu agente

O Browse é instalado com um único script no macOS e Linux:

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

No Windows, execute irm https://opencode.ai/browse/install.ps1 | iex no PowerShell. Você também pode usar npm i -g @opencode/browse e depois browse install.

O browse install coloca o binário no lugar, adiciona o servidor MCP do Browse aos agentes que encontrar e pareia a extensão da Chrome Web Store. Para pular o seletor interativo:

browse install -a claude codex   # apenas Claude Code e Codex
browse install -y                # todos os agentes encontrados neste computador

Reinicie seu agente depois. O browse status informa se o relay, a extensão e o pareamento estão saudáveis.

Um detalhe muda como seu agente trabalha. O OpenCode recebe ferramentas diretas (navigate, snapshot, click, network e as demais). Claude Code, Codex, Cursor e outros clientes recebem execute, status e tabs, onde execute roda JavaScript que pode chamar todas as ferramentas do Browse. De qualquer forma, o agente chega à mesma captura network.

Etapa 2: Iniciar uma captura de rede filtrada

A ferramenta network recebe uma action de start, status, stop ou cancel, uma captura por aba. No start, você pode restringir o que é gravado:

Opção O que faz Padrão
urlFilter Captura apenas URLs que contêm este texto Nenhum
resourceTypes Captura apenas estes tipos, como ["XHR", "Fetch"] Todos os tipos
methods Captura apenas estes métodos HTTP Todos os métodos
bodies Captura os corpos de requisição e resposta true
maxDurationMs Encerra e descarta a captura após esse tempo 1.800.000 (30 minutos)

Filtre para XHR e Fetch e adicione um urlFilter como /api/ para ignorar beacons de analytics. A chamada fica assim:

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

Para manter o agente em um único site, abra a aba com allowedOrigins. O README do Browse deixa claro que isso limita a navegação, não as requisições que uma página faz por conta própria, então é uma proteção, não uma fronteira de dados.

Etapa 3: Navegar pelo site e, em seguida, interromper a captura

Agora use o site na aba do agente: abra uma lista, filtre-a, visualize uma página de detalhes, crie e exclua um registro de teste. Se o site pedir login no meio da sessão, o agente chama handoff, você conclui o login e clica em Continuar.

Quando terminar, o agente envia {"action": "stop"}. Isso retorna cada troca: método, URL, cabeçalhos, status e corpos. Os limites valem a pena conhecer:

Credenciais são sempre substituídas por [redacted]: cabeçalhos de autorização e chaves de API, todos os valores de cookies, campos de consulta, JSON e formulário com nomes de segredo, e segmentos de caminho semelhantes a tokens. O README adverte que um segredo sob um nome de campo comum ainda pode escapar, então leia a especificação antes de compartilhá-la.

Uma mudança para planejar: a versão 0.0.17 (14 de novembro de 2026) removeu a exportação HAR, e as capturas agora retornam o tráfego anonimizado diretamente. Se você precisar de um arquivo HAR, exporte-o do DevTools e use nosso guia sobre importar um arquivo HAR para a Apidog.

Etapa 4: Deixar o agente escrever a especificação OpenAPI

Tráfego bruto não é uma especificação. Chamadas para /api/orders/1042, /api/orders/877 e /api/orders/15 devem se tornar um único path, /api/orders/{orderId}, com um único schema de resposta. Um agente de programação é bom exatamente nisso: identificar o padrão e inferir tipos a partir de respostas reais.

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

Peça ao agente para seguir algumas regras para que a saída seja importada sem problemas:

Etapa 5: Importar a especificação e testá-la com a Apidog CLI

Assim que o openapi.json existir, entregue o restante ao mesmo agente. A Apidog CLI oferece comandos para importar especificações, criar casos de teste e executá-los, e cada comando imprime JSON estruturado que seu agente consegue ler.

Configure uma vez:

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

Em seguida, dê ao seu agente um único prompt que cobre todo o trabalho:

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.

O agente executa os comandos abaixo. Cada flag aqui vem de apidog <cmd> --help na 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 para uma branch de IA mantém uma especificação capturada longe do seu design principal até que você a revise. Se você recapturar mais tarde e importar novamente, mantenha o info.title inalterado ou passe --module-map "<info.title>=<moduleId>", para que a Apidog atualize os endpoints no lugar em vez de criar uma segunda cópia de cada um.

Assim que o teste passar, o mesmo comando apidog run ... -r junit vai direto para o CI. Nosso guia de CI/CD da Apidog CLI mostra a configuração do pipeline, e o Apidog CLI no Claude Code cobre o lado do agente com mais profundidade.

Dicas para uma especificação capturada mais limpa

Perguntas frequentes

O OpenCode Browse é gratuito? O repositório tem licença MIT, e a página do produto não lista preço. Isso é tudo que a fonte confirma até 17 de novembro de 2026, então consulte a página novamente antes de planejar com base no custo.

O OpenCode Browse funciona com Claude Code, ou apenas com OpenCode? Funciona com Claude Code, Codex, Cursor, Zed e cerca de 30 outros clientes MCP. O browse install -a claude configura o Claude Code. O OpenCode recebe ferramentas diretas, e os outros clientes recebem uma ferramenta execute que chama as mesmas ferramentas via JavaScript.

O Browse pode exportar um arquivo HAR? Não mais. A versão 0.0.17 removeu a exportação HAR, e o network agora retorna o tráfego anonimizado diretamente como dados estruturados. Para um arquivo HAR, salve um no Chrome DevTools e importe-o com apidog import --format har.

Meus cookies de sessão ou tokens acabarão na especificação? O Browse anonimiza cabeçalhos de autorização e chaves de API, todos os valores de cookies, campos com nomes de segredo e segmentos de caminho semelhantes a tokens. Um segredo armazenado sob um nome de campo comum ainda pode aparecer, então revise o arquivo antes de compartilhá-lo.

Qual formato de importação da Apidog devo usar para a saída do agente? Use --format openapi para a especificação que o agente escreve. A Apidog CLI também aceita Postman, HAR, Insomnia, Swagger 2.0 e mais de 20 outros formatos pelo mesmo comando apidog import.

Pratique o design de API no Apidog

Descubra uma forma mais fácil de construir e usar APIs