Biến lưu lượng truy cập website thành đặc tả API với OpenCode Browse

OpenCode Browse cho phép agent lập trình của bạn ghi lại các lời gọi API mà một trang web thực hiện trong khi bạn đã đăng nhập. Bài viết này sẽ hướng dẫn cách chuyển lưu lượng đó thành đặc tả OpenAPI và kiểm thử bằng Apidog CLI — tất cả chỉ với một prompt duy nhất cho agent.

Ashley Innocent

Ashley Innocent

17 tháng 11 2026

Biến lưu lượng truy cập website thành đặc tả API với OpenCode Browse

Apidog cho doanh nghiệp

Triển khai tại chỗ

SSO & RBAC

Tuân thủ SOC 2

Khám phá Apidog Enterprise

Để biến lưu lượng mạng của website thành một đặc tả API, hãy để agent lập trình điều khiển trình duyệt thực của bạn bằng OpenCode Browse: nó bắt đầu một phiên ghi nhận network trên một tab, bạn click duyệt qua trang web khi đã đăng nhập, sau đó nó dừng phiên ghi nhận để lấy mọi request với thông tin xác thực đã được ẩn đi. Agent sau đó viết file OpenAPI từ các giao dịch đó, và Apidog CLI nhập file này rồi chạy kiểm thử dựa trên nó.

Bài hướng dẫn này đi qua vòng lặp đó chỉ với một prompt duy nhất cho agent: Browse ghi nhận những gì, ẩn đi những gì, và các lệnh apidog hoàn tất công việc.

OpenCode Browse là gì?

OpenCode Browse là một MCP server kết hợp với tiện ích mở rộng Chromium cho phép agent lập trình của bạn sử dụng trình duyệt thực của bạn, với các tab, phiên đăng nhập và tiện ích mở rộng sẵn có. Agent có thể mở tab nền, đọc trang, click, nhập liệu, chụp màn hình, ghi hình tab và ghi nhận lưu lượng mạng. Khi một bước cần bạn tham gia (đăng nhập, xác thực 2FA, thanh toán), agent trả lại tab và chờ cho đến khi bạn nhấn Continue.

Mục Theo nguồn
Giấy phép MIT (file LICENSE trong repository)
Mã nguồn công khai đầu tiên Repository được tạo ngày 27 tháng 10 năm 2026
Bản phát hành hiện tại v0.1.0, phát hành ngày 16 tháng 11 năm 2026 (viết lại thành một binary Rust duy nhất)
Trình duyệt Chrome, Edge, Brave, Arc, Helium, Vivaldi, Opera, Chromium
Agent OpenCode, Claude Code, Codex, Cursor, Zed và khoảng 30 MCP client khác
Giá Chưa được công bố trên trang sản phẩm

Trang sản phẩm không liệt kê giá hay ngày ra mắt, vì vậy hãy coi giấy phép MIT là tín hiệu chi phí duy nhất bạn có thể xác nhận ở thời điểm hiện tại. Nếu bạn đang so sánh với hướng đi qua DevTools, bài hướng dẫn của chúng tôi về Chrome DevTools MCP với Claude sẽ đề cập đến phương án thay thế này.

Tại sao phải ghi nhận lưu lượng từ trình duyệt thực của bạn?

Hầu hết các API chưa được tài liệu hóa đều nằm sau màn hình đăng nhập. Một trình duyệt headless khởi động mà không có cookie nào, nên agent của bạn sẽ vấp phải bức tường đăng nhập. Browse hoạt động ngay trong profile bạn đang dùng, vì vậy agent nhìn thấy cùng các request đã xác thực như bạn. Điều này hữu ích cho ba công việc:

Cách thủ công là xuất HAR từ DevTools; xem bài hướng dẫn của chúng tôi về reverse engineering API. Cách dùng agent thì viết đặc tả thay cho bạn.

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ách biến lưu lượng mạng của website thành đặc tả API: 5 bước

  1. Cài đặt Browse và ghép nối tiện ích mở rộng với trình duyệt của bạn.
  2. Yêu cầu agent mở trang web trong một tab Browse và bắt đầu phiên ghi nhận network được lọc theo XHR và Fetch.
  3. Click duyệt qua các tính năng bạn muốn tài liệu hóa, sau đó bảo agent dừng phiên ghi nhận.
  4. Để agent nhóm các giao dịch thành các path và viết openapi.json.
  5. Nhập đặc tả bằng Apidog CLI, tạo test case và chạy nó.

Bước 1: Cài đặt Browse và kết nối agent của bạn

Browse cài đặt chỉ bằng một script trên macOS và Linux:

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

Trên Windows, chạy irm https://opencode.ai/browse/install.ps1 | iex trong PowerShell. Bạn cũng có thể dùng npm i -g @opencode/browse rồi browse install.

browse install đặt binary vào vị trí, thêm Browse MCP server vào các agent mà nó tìm thấy, và ghép nối tiện ích mở rộng từ Chrome Web Store. Để bỏ qua bộ chọn tương tác:

browse install -a claude codex   # Chỉ Claude Code và Codex
browse install -y                # mọi agent tìm thấy trên máy này

Khởi động lại agent của bạn sau đó. browse status báo cáo relay, tiện ích mở rộng và ghép nối có hoạt động ổn định hay không.

Một chi tiết thay đổi cách agent của bạn hoạt động. OpenCode nhận các công cụ thuần (navigate, snapshot, click, network và các công cụ khác). Claude Code, Codex, Cursor và các client khác nhận execute, status và tabs, trong đó execute chạy JavaScript có thể gọi mọi công cụ của Browse. Dù cách nào, agent vẫn tiếp cận được phiên ghi nhận network như nhau.

Bước 2: Bắt đầu phiên ghi nhận mạng có lọc

Công cụ network nhận một action là start, status, stop hoặc cancel, mỗi tab một phiên ghi nhận. Với start, bạn có thể thu hẹp phạm vi ghi nhận:

Tùy chọn Chức năng Mặc định
urlFilter Chỉ ghi nhận các URL chứa văn bản này Không có
resourceTypes Chỉ ghi nhận các loại này, ví dụ ["XHR", "Fetch"] Mọi loại
methods Chỉ ghi nhận các HTTP method này Mọi method
bodies Ghi nhận body của request và response true
maxDurationMs Kết thúc và hủy phiên ghi nhận sau khoảng thời gian này 1,800,000 (30 phút)

Hãy lọc theo XHR và Fetch, và thêm một urlFilter như /api/ để bỏ qua các analytics beacon. Lệnh gọi trông như sau:

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

Để giữ agent ở một trang web duy nhất, hãy mở tab với allowedOrigins. README của Browse nói rõ rằng điều này giới hạn việc điều hướng, không giới hạn các request mà trang tự tạo ra, nên đây là một biện pháp phòng ngừa, không phải ranh giới dữ liệu.

Bước 3: Duyệt qua trang web, sau đó dừng phiên ghi nhận

Bây giờ hãy sử dụng trang web trong tab của agent: mở một danh sách, lọc nó, xem trang chi tiết, tạo và xóa một bản ghi thử. Nếu trang yêu cầu bạn đăng nhập giữa phiên, agent sẽ gọi handoff, bạn hoàn tất đăng nhập, rồi nhấn Continue.

Khi bạn xong việc, agent gửi {"action": "stop"}. Lệnh này trả về mọi giao dịch: method, URL, header, trạng thái và body. Các giới hạn cần nắm rõ:

Thông tin xác thực luôn được thay bằng [redacted]: header authorization và API key, mọi giá trị cookie, các trường query, JSON và form có tên gợi ý là bí mật, và các đoạn path giống token. README cảnh báo rằng một bí mật nằm dưới tên trường thông thường vẫn có thể lọt qua, vì vậy hãy đọc kỹ đặc tả trước khi chia sẻ.

Một thay đổi cần lưu ý: phiên bản 0.0.17 (ngày 14 tháng 11 năm 2026) đã loại bỏ xuất HAR, và phiên ghi nhận giờ trả về lưu lượng đã ẩn thông tin trực tiếp. Nếu bạn cần file HAR, hãy xuất từ DevTools và dùng bài hướng dẫn của chúng tôi về nhập file HAR vào Apidog.

Bước 4: Để agent viết đặc tả OpenAPI

Lưu lượng thô chưa phải là đặc tả. Các lệnh gọi đến /api/orders/1042, /api/orders/877 và /api/orders/15 nên trở thành một path duy nhất, /api/orders/{orderId}, với một response schema. Một agent lập trình giỏi đúng việc này: nhận ra mẫu hình và suy luận kiểu dữ liệu từ các response thực.

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

Hãy yêu cầu agent tuân theo một vài quy tắc để kết quả nhập vào dễ dàng:

Bước 5: Nhập đặc tả và kiểm thử với Apidog CLI

Khi openapi.json đã có, giao phần còn lại cho chính agent đó. Apidog CLI cung cấp các lệnh để nhập đặc tả, tạo test case và chạy chúng, và mọi lệnh đều in JSON có cấu trúc mà agent của bạn có thể đọc.

Cài đặt một lần:

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

Sau đó đưa cho agent một prompt duy nhất bao trùm cả công việc:

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 sẽ chạy các lệnh dưới đây. Mọi flag đều lấy từ apidog <cmd> --help trên 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

Nhập vào một AI branch giúp đặc tả thu được không ảnh hưởng đến thiết kế chính của bạn cho đến khi bạn xem xét. Nếu bạn ghi nhận lại sau này và nhập lại, hãy giữ info.title không đổi hoặc truyền --module-map "<info.title>=<moduleId>", để Apidog cập nhật endpoint tại chỗ thay vì tạo một bản sao thứ hai của mỗi endpoint.

Khi test đã thông qua, chính lệnh apidog run ... -r junit đó có thể đưa thẳng vào CI. Bài hướng dẫn CI/CD với Apidog CLI của chúng tôi trình bày cách thiết lập pipeline, và Apidog CLI trong Claude Code đi sâu hơn về phía agent.

Mẹo để có đặc tả thu được sạch hơn

Câu hỏi thường gặp

OpenCode Browse có miễn phí không? Repository được cấp phép MIT, và trang sản phẩm không liệt kê giá. Đó là tất cả những gì nguồn xác nhận tính đến ngày 17 tháng 11 năm 2026, vì vậy hãy kiểm tra lại trang trước khi lên kế hoạch dựa trên chi phí.

OpenCode Browse hoạt động với Claude Code, hay chỉ với OpenCode? Nó hoạt động với Claude Code, Codex, Cursor, Zed và khoảng 30 MCP client khác. browse install -a claude thiết lập Claude Code. OpenCode nhận các công cụ thuần, còn các client khác nhận công cụ execute gọi các công cụ đó từ JavaScript.

Browse có thể xuất file HAR không? Không còn nữa. Phiên bản 0.0.17 đã loại bỏ xuất HAR, và network giờ trả về lưu lượng đã ẩn thông tin trực tiếp dưới dạng dữ liệu có cấu trúc. Nếu cần file HAR, hãy lưu một file từ Chrome DevTools và nhập bằng apidog import --format har.

Có phải cookie phiên hay token của tôi sẽ xuất hiện trong đặc tả? Browse ẩn các header authorization và API key, mọi giá trị cookie, các trường có tên gợi ý là bí mật và các đoạn path giống token. Một bí mật lưu dưới tên trường thông thường vẫn có thể xuất hiện, vì vậy hãy xem lại file trước khi chia sẻ.

Nên dùng định dạng nhập Apidog nào cho kết quả của agent? Dùng --format openapi cho đặc tả mà agent viết. Apidog CLI cũng chấp nhận Postman, HAR, Insomnia, Swagger 2.0 và hơn 20 định dạng khác thông qua cùng lệnh apidog import.

Thực hành thiết kế API trong Apidog

Khám phá cách dễ dàng hơn để xây dựng và sử dụng API