Ubah Trafik Jaringan Website Menjadi Spesifikasi API dengan OpenCode Browse

OpenCode Browse memungkinkan agen coding Anda merekam panggilan API yang dilakukan sebuah situs saat Anda sedang masuk. Berikut cara mengubah lalu lintas tersebut menjadi spesifikasi OpenAPI dan mengujinya dengan Apidog CLI, hanya dengan satu prompt untuk agen.

Ashley Innocent

Ashley Innocent

17 November 2026

Ubah Trafik Jaringan Website Menjadi Spesifikasi API dengan OpenCode Browse

Apidog untuk Perusahaan

Penerapan On-Premises

SSO & RBAC

Sesuai SOC 2

Jelajahi Apidog Enterprise

Untuk mengubah lalu lintas jaringan website menjadi spesifikasi API, biarkan coding agent mengendalikan browser asli Anda dengan OpenCode Browse: ia memulai capture network pada sebuah tab, Anda menjelajahi situs dalam kondisi sudah login, lalu ia menghentikan capture untuk mendapatkan setiap request dengan kredensial yang telah disamarkan. Agent kemudian menulis file OpenAPI dari pertukaran data tersebut, dan Apidog CLI mengimpornya serta menjalankan pengujian terhadapnya.

Panduan ini membahas alur kerja tersebut dengan satu prompt agent: apa saja yang di-capture Browse, apa yang disembunyikan, serta perintah apidog yang menyelesaikan pekerjaannya.

Apa itu OpenCode Browse?

OpenCode Browse adalah MCP server ditambah ekstensi Chromium yang memungkinkan coding agent Anda menggunakan browser asli Anda, dengan tab, login, dan ekstensi Anda sendiri. Agent dapat membuka tab di latar belakang, membaca halaman, mengeklik, mengetik, mengambil screenshot, merekam tab, dan menangkap lalu lintas jaringan. Ketika ada langkah yang membutuhkan Anda (login, permintaan 2FA, atau pembayaran), agent menyerahkan kembali tab tersebut dan menunggu hingga Anda mengeklik Continue.

Item Apa kata sumbernya
Lisensi MIT (file LICENSE di repositori)
Kode publik pertama Repositori dibuat 27 Oktober 2026
Rilis saat ini v0.1.0, dipublikasikan 16 November 2026 (penulisan ulang sebagai satu binary Rust)
Browser Chrome, Edge, Brave, Arc, Helium, Vivaldi, Opera, Chromium
Agent OpenCode, Claude Code, Codex, Cursor, Zed dan sekitar 30 klien MCP lainnya
Harga Tidak disebutkan di halaman produk

Halaman produk tidak mencantumkan harga atau tanggal peluncuran, jadi anggap lisensi MIT sebagai satu-satunya sinyal biaya yang bisa Anda konfirmasi hari ini. Jika Anda membandingkannya dengan pendekatan DevTools, panduan kami tentang Chrome DevTools MCP dengan Claude membahas alternatif tersebut.

Mengapa menangkap lalu lintas dari browser asli Anda?

Sebagian besar API yang tidak terdokumentasi berada di balik login. Browser headless dimulai tanpa cookie, sehingga agent Anda menghadapi tembok halaman login. Browse bekerja di dalam profil yang sudah Anda gunakan, sehingga agent melihat request terautentikasi yang sama seperti yang Anda lihat. Ini membantu untuk tiga pekerjaan:

Versi manualnya adalah ekspor HAR dari DevTools; lihat panduan kami tentang reverse engineering API. Versi agent menulis spesifikasinya untuk Anda.

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

Cara mengubah lalu lintas jaringan website menjadi spesifikasi API: 5 langkah

  1. Instal Browse dan pasangkan ekstensinya dengan browser Anda.
  2. Minta agent Anda membuka situs di tab Browse dan memulai capture network yang difilter ke XHR dan Fetch.
  3. Jelajahi fitur yang ingin Anda dokumentasikan, lalu beri tahu agent untuk menghentikan capture.
  4. Minta agent mengelompokkan pertukaran data menjadi path dan menulis openapi.json.
  5. Impor spesifikasi dengan Apidog CLI, buat test case, dan jalankan.

Langkah 1: Instal Browse dan hubungkan agent Anda

Browse dapat diinstal dengan satu skrip di macOS dan Linux:

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

Di Windows, jalankan irm https://opencode.ai/browse/install.ps1 | iex di PowerShell. Anda juga bisa menggunakan npm i -g @opencode/browse lalu browse install.

browse install menempatkan binary, menambahkan Browse MCP server ke agent yang ditemukannya, dan memasangkan ekstensi dari Chrome Web Store. Untuk melewati pemilih interaktif:

browse install -a claude codex   # hanya Claude Code dan Codex
browse install -y                # semua agent yang ada di komputer ini

Setelah itu, restart agent Anda. browse status melaporkan apakah relay, ekstensi, dan pairing dalam kondisi sehat.

Satu detail mengubah cara kerja agent Anda. OpenCode mendapatkan tools biasa (navigate, snapshot, click, network, dan lainnya). Claude Code, Codex, Cursor, dan klien lainnya mendapatkan execute, status, dan tabs, di mana execute menjalankan JavaScript yang dapat memanggil semua Browse tool. Bagaimanapun, agent tetap mencapai capture network yang sama.

Langkah 2: Mulai capture jaringan yang difilter

Tool network menerima action berupa start, status, stop, atau cancel, dengan satu capture per tab. Pada start, Anda bisa mempersempit apa yang direkam:

Opsi Fungsinya Default
urlFilter Hanya merekam URL yang mengandung teks ini Tidak ada
resourceTypes Hanya merekam tipe ini, misalnya ["XHR", "Fetch"] Semua tipe
methods Hanya merekam method HTTP ini Semua method
bodies Merekam body request dan response true
maxDurationMs Mengakhiri dan membuang capture setelah durasi ini 1.800.000 (30 menit)

Filter ke XHR dan Fetch, lalu tambahkan urlFilter seperti /api/ untuk melewati beacon analitik. Panggilannya terlihat seperti ini:

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

Untuk menjaga agent tetap di satu situs, buka tab dengan allowedOrigins. README Browse menegaskan bahwa ini membatasi navigasi, bukan request yang dibuat oleh halaman itu sendiri, jadi ini adalah pengaman, bukan batas data.

Langkah 3: Jelajahi situs, lalu hentikan capture

Sekarang gunakan situs tersebut di tab milik agent: buka daftar, filter, lihat halaman detail, buat dan hapus data uji. Jika situs meminta Anda login di tengah sesi, agent memanggil handoff, Anda menyelesaikan login, lalu Anda mengeklik Continue.

Setelah selesai, agent mengirim {"action": "stop"}. Itu mengembalikan setiap pertukaran data: method, URL, header, status, dan body. Batasannya perlu diketahui:

Kredensial selalu diganti dengan [redacted]: header authorization dan API key, semua nilai cookie, field query, JSON, dan form yang namanya mengandung rahasia, serta segmen path yang mirip token. README memperingatkan bahwa rahasia yang tersimpan di bawah nama field biasa masih bisa lolos, jadi baca spesifikasinya sebelum membagikannya.

Satu perubahan yang perlu diperhitungkan: versi 0.0.17 (14 November 2026) menghapus ekspor HAR, dan capture kini mengembalikan lalu lintas yang telah disamarkan secara langsung. Jika Anda membutuhkan file HAR, ekspor dari DevTools dan gunakan panduan kami tentang mengimpor file HAR ke Apidog.

Langkah 4: Biarkan agent menulis spesifikasi OpenAPI

Lalu lintas mentah bukanlah spesifikasi. Panggilan ke /api/orders/1042, /api/orders/877, dan /api/orders/15 seharusnya menjadi satu path, /api/orders/{orderId}, dengan satu skema response. Coding agent memang jago dalam hal ini: menemukan pola dan menginferensi tipe dari response nyata.

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

Minta agent mengikuti beberapa aturan agar hasilnya mudah diimpor:

Langkah 5: Impor spesifikasi dan uji dengan Apidog CLI

Setelah openapi.json ada, serahkan sisanya kepada agent yang sama. Apidog CLI menyediakan perintah untuk mengimpor spesifikasi, membuat test case, dan menjalankannya, dan setiap perintah mencetak JSON terstruktur yang bisa dibaca agent Anda.

Atur sekali saja:

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

Lalu berikan agent Anda satu prompt yang mencakup seluruh pekerjaan:

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.

Agent menjalankan perintah berikut. Setiap flag di sini berasal dari apidog <cmd> --help pada 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

Mengimpor ke branch AI menjaga spesifikasi hasil capture tetap terpisah dari desain utama Anda hingga Anda meninjaunya. Jika nanti Anda men-capture ulang dan mengimpor lagi, pertahankan info.title tidak berubah atau berikan --module-map "<info.title>=<moduleId>", sehingga Apidog memperbarui endpoint di tempatnya alih-alih membuat salinan kedua dari masing-masing.

Setelah pengujian berhasil, perintah apidog run ... -r junit yang sama bisa langsung dimasukkan ke CI. Panduan CI/CD Apidog CLI kami menunjukkan setup pipeline-nya, dan Apidog CLI di Claude Code membahas sisi agent secara lebih mendalam.

Tips untuk spesifikasi hasil capture yang lebih bersih

FAQ

Apakah OpenCode Browse gratis? Repositorinya dilisensikan MIT, dan halaman produk tidak mencantumkan harga. Itulah semua yang bisa dikonfirmasi sumber per 17 November 2026, jadi periksa kembali halamannya sebelum merencanakan anggaran.

Apakah OpenCode Browse bekerja dengan Claude Code, atau hanya OpenCode? Ia bekerja dengan Claude Code, Codex, Cursor, Zed, dan sekitar 30 klien MCP lainnya. browse install -a claude menyiapkan Claude Code. OpenCode mendapatkan tools biasa, sementara klien lain mendapatkan tool execute yang memanggil tools yang sama dari JavaScript.

Bisakah Browse mengekspor file HAR? Tidak lagi. Versi 0.0.17 menghapus ekspor HAR, dan network kini mengembalikan lalu lintas yang disamarkan langsung sebagai data terstruktur. Untuk file HAR, simpan satu dari Chrome DevTools dan impor dengan apidog import --format har.

Apakah cookie atau token sesi saya bisa masuk ke dalam spesifikasi? Browse menyamarkan header authorization dan API key, semua nilai cookie, field bernama rahasia, dan segmen path mirip token. Rahasia yang tersimpan di bawah nama field biasa masih bisa muncul, jadi tinjau filenya sebelum membagikannya.

Format impor Apidog mana yang sebaiknya saya gunakan untuk hasil agent? Gunakan --format openapi untuk spesifikasi yang ditulis agent. Apidog CLI juga menerima Postman, HAR, Insomnia, Swagger 2.0, dan lebih dari 20 format lainnya melalui perintah apidog import yang sama.

Mengembangkan API dengan Apidog

Apidog adalah alat pengembangan API yang membantu Anda mengembangkan API dengan lebih mudah dan efisien.