Bỏ qua điều hướng
Agents / Automation Beginner-friendly

agent-browser: Cho AI agent điều khiển trình duyệt bằng CLI

agent-browser biến thao tác trình duyệt thành CLI và MCP dễ gọi từ AI agent, từ đọc accessibility tree đến click, nhập liệu, screenshot và quản lý session.

6/10/2026 ⭐ 43,554 VibeToolPro
agent-browser: Cho AI agent điều khiển trình duyệt bằng CLI

Use cases

  • Cho coding agent hoặc workflow AI thao tác website qua lệnh open, snapshot, click, fill và screenshot
  • Tự động hóa luồng web cần session thật như đăng nhập, điền form, kiểm tra UI hoặc thu thập dữ liệu
  • Expose browser automation cho MCP client bằng bộ tool typed thay vì tự ghép shell command

Hướng dẫn bắt đầu

  1. Cài agent-browser, tải Chrome for Testing rồi thử open, snapshot và click trên một website không quan trọng
  2. Chạy một workflow nhỏ có fill, wait và screenshot; giới hạn domain và không dùng credential thật khi chưa cần
  3. Chỉ sau khi flow ổn định mới nối vào AI agent hoặc MCP client và thêm rule xác nhận cho thao tác có hậu quả

AI agent có thể viết code rất tốt nhưng thường bị chặn khi công việc chuyển sang trình duyệt: mở trang, đọc trạng thái UI, bấm đúng nút, điền form rồi kiểm tra kết quả. Nếu mỗi agent phải tự nối Playwright hoặc tự xử lý DOM từ đầu, phần browser execution nhanh chóng trở thành một project riêng. agent-browser đưa lớp này về một giao diện CLI gọn hơn để agent có thể gọi trực tiếp.

agent-browser là gì?

agent-browser là công cụ browser automation từ Vercel Labs. Dự án cung cấp CLI native viết bằng Rust, điều khiển Chrome và expose các thao tác quen thuộc như mở URL, đọc trang, lấy accessibility snapshot, click, fill, wait, screenshot, quản lý tab, cookie, storage và network.

Workflow cốt lõi khá hợp với agent: mở trang, gọi snapshot để lấy accessibility tree có các ref như @e2, rồi dùng những ref đó cho lệnh click hoặc fill. Repo vẫn hỗ trợ CSS selector và semantic locator khi cần.

Luồng agent-browser biến yêu cầu của AI agent thành snapshot, thao tác CLI và trạng thái trình duyệt.

Vì sao repo này đáng chú ý?

Điểm đáng xem nhất là nó đóng gói browser control thành primitive nhỏ, rõ và dễ compose. Agent không cần luôn nhận toàn bộ HTML; accessibility snapshot cho một biểu diễn ngắn hơn, có ref để hành động ở bước tiếp theo. README cũng có read để lấy text theo hướng agent-friendly và nhiều lệnh quan sát như screenshot, console, network hay state.

agent-browser còn có MCP server qua lệnh agent-browser mcp. MCP client có thể gọi các tool typed như open, snapshot, click, fill, wait hay screenshot; profile mặc định chỉ expose nhóm core để giữ tool surface nhỏ hơn.

Tại thời điểm research ngày 06/10/2026, GitHub ghi nhận 43.554 stars. Repo không archived, nhánh main vẫn có commit mới trong ngày và package hiện ở phiên bản 0.38.2. Đây là tín hiệu dự án đang được phát triển tích cực, không phải bằng chứng rằng mọi website đều tự động hóa ổn định.

Khi nào nên dùng?

Repo hợp khi agent cần làm việc với một website không có API phù hợp, hoặc khi chính UI là thứ cần kiểm tra. Coding agent có thể dùng nó để chạy smoke flow sau khi sửa frontend; workflow nội bộ có thể điền form, tải file hoặc đọc trạng thái sau đăng nhập; agent nghiên cứu có thể kết hợp read, snapshot và screenshot để quan sát trang.

Nó cũng đáng thử nếu bạn muốn browser automation dùng được từ nhiều host khác nhau. CLI phù hợp cho shell-based agent, còn MCP phù hợp khi host đã có protocol và approval flow riêng.

Ba use case chính của agent-browser: kiểm tra UI, thao tác workflow web và cấp browser tool cho MCP client.

Lưu ý trước khi áp dụng

Browser automation vẫn phụ thuộc vào trạng thái website thật. Modal, consent banner, thay đổi DOM, loading không ổn định hoặc quyền đăng nhập có thể làm một flow thất bại dù lệnh đúng. README khuyến nghị lấy snapshot mới khi phần tử bị che hoặc trạng thái trang đã thay đổi; với wait, nên chờ một điều kiện cụ thể thay vì mặc định dựa vào network idle.

Rủi ro lớn hơn nằm ở quyền. Công cụ có thể thao tác cookie, storage, credential, upload, download và network. Khi nối với AI agent, website và nội dung trang phải được coi là dữ liệu không tin cậy. README của dự án cũng cảnh báo metadata/tool do trang cung cấp qua WebMCP không phải ranh giới an toàn; thao tác có hậu quả vẫn cần policy xác nhận của host.

Vì vậy nên giới hạn domain, dùng profile/session tách biệt và bắt đầu bằng tài khoản test. Đừng trao browser đã đăng nhập vào hệ thống quan trọng cho một agent chỉ vì flow demo hoạt động.

Trade-off của agent-browser: quyền thao tác trình duyệt càng rộng thì càng cần giới hạn domain, session riêng và xác nhận thao tác quan trọng.

Khi nào chưa cần dùng?

Nếu dịch vụ đã có API ổn định, gọi API trực tiếp thường dễ test và ít phụ thuộc UI hơn. Nếu nhu cầu chỉ là một script browser cố định trong codebase, Playwright hoặc Puppeteer có thể rõ ràng hơn vì logic, selector và assertion nằm cùng test code.

Bạn cũng chưa cần nối agent-browser vào agent ngay khi chỉ muốn thử automation. Chạy CLI thủ công trước giúp tách lỗi browser khỏi lỗi reasoning của model.

Phù hợp với ai?

agent-browser phù hợp với AI engineer, developer và automation builder đang xây agent có khả năng thực thi trên web. Nó đặc biệt hợp với workflow agentic chạy qua shell hoặc MCP. Người mới vẫn có thể bắt đầu từ Quick Start, nhưng cần hiểu browser state và ranh giới quyền trước khi dùng credential thật.

Bắt đầu thực tế như thế nào?

Cài agent-browser, chạy agent-browser install, sau đó thử chuỗi nhỏ: open → snapshot → click → screenshot trên một site test. Tiếp theo thêm một form đơn giản với fill và wait, đồng thời giới hạn domain. Khi flow chạy lặp lại ổn định, mới đưa nó vào agent hoặc MCP client và thêm rule xác nhận cho login, upload, submit, purchase hoặc bất kỳ thao tác nào tạo thay đổi bên ngoài.