Chuyển đến nội dung chính
Gologin Agent Browser CLI biến các hồ sơ trình duyệt Gologin thành một môi trường chạy liên tục, có thể điều khiển bằng script cho AI agent. Các phiên chạy trong Gologin Cloud Browser hoặc trong Orbita trên chính máy của bạn. CLI cung cấp snapshot trang gọn nhẹ, tương tác dựa trên ref, bộ nhớ phiên và đầu ra thân thiện với shell. Khác với việc tự viết mã Puppeteer/Playwright từ đầu, CLI này cung cấp cho agent sẵn một bộ lệnh để tự động hóa trình duyệt — không cần mã mẫu, không cần mã quản lý phiên.

Môi trường chạy Cloud hoặc cục bộ

CLI có hai môi trường chạy với cùng một bộ lệnh. Cả hai đều dùng hồ sơ, dấu vân tay và proxy của Gologin, và một daemon giữ các phiên luôn hoạt động giữa các lần gọi CLI. Chọn môi trường chạy cho từng lệnh bằng --runtime cloud|local|auto, hoặc đặt GOLOGIN_AGENT_BROWSER_RUNTIME một lần:
Theo mặc định (auto), các lệnh về hồ sơ, runbook và job chạy cục bộ, còn tất cả lệnh khác chạy trên cloud. Sau khi mở một phiên cục bộ, hãy truyền --runtime local cho cả các lệnh tiếp theo. Xem Môi trường chạy cục bộ để biết các yêu cầu và những lệnh chỉ dành cho local.

Cài đặt

Hoặc chạy mà không cần cài đặt toàn cục:
Yêu cầu Node.js >= 18. Môi trường chạy cục bộ cần Node.js 20 trở lên.

Thông tin xác thực

Lấy mã thông báo

  1. Đăng ký hoặc đăng nhập tại gologin.com
  2. Mở API & MCP trong bảng điều khiển
  3. Mở tab API
  4. Nhấp Mã thông báo mới
  5. Sao chép mã thông báo truy cập vừa được tạo

Tệp cấu hình

~/.gologin-agent-browser/config.json

Kiến trúc

Gồm hai phần:
  1. CLI gologin-agent-browser — phân tích lệnh, chọn môi trường chạy, tự động khởi động daemon tương ứng và in ra kết quả gọn nhẹ
  2. Các daemon cục bộ chạy liên tục, mỗi môi trường chạy một daemon — quản lý các phiên trình duyệt đang hoạt động, kết nối với Gologin Cloud Browser hoặc Orbita cục bộ qua connectOverCDP của Playwright, giữ trang đang hoạt động trong bộ nhớ, tạo snapshot, phân giải ref và theo dõi siêu dữ liệu phiên
Kênh truyền tải chỉ ở phạm vi cục bộ. Daemon cloud lắng nghe tại:
  • Unix socket tại ${TMPDIR:-/tmp}/gologin-agent-browser.sock
  • HTTP localhost tại 127.0.0.1:${GOLOGIN_DAEMON_PORT:-44777}
Trong môi trường chạy cloud, nếu bạn không cung cấp ID hồ sơ, daemon sẽ tạo một hồ sơ cloud Gologin tạm thời thông qua API.

Cách ref hoạt động

snapshot in ra chế độ xem trang gọn nhẹ và gán các ref như @e1, @e2, @e3 cho các phần tử có thể tương tác. Bạn thao tác trực tiếp trên chúng:
Ref chỉ hoạt động theo kiểu cố gắng tối đa và nên được tạo lại sau khi điều hướng hoặc khi DOM thay đổi lớn. Các lệnh cũng chấp nhận bộ chọn CSS thay cho ref. Trên các trang động, find thường là lựa chọn dự phòng tốt hơn so với ref đã lỗi thời: lệnh này tìm phần tử trên trang đang hiển thị và thao tác với nó chỉ trong một bước.

Bắt đầu nhanh


Ví dụ vòng lặp của agent

Một vòng lặp điển hình của AI agent:

Tham chiếu đầy đủ các lệnh

Chẩn đoán

Quản lý phiên

Đọc trang

Tương tác

Bàn phím và cuộn trang

Điều hướng

Tab

Nâng cao

Hồ sơ, proxy và Gologin API

Các lệnh này gọi Gologin API bằng mã thông báo của bạn và không cần daemon trình duyệt.
Thêm --help vào bất kỳ lệnh nào để in cách sử dụng của lệnh đó.

Chỉ dành cho môi trường chạy cục bộ

profiles, profile, profile-create, profile-update, profile-import, profile-sync, profile-delete, run, batch, jobs và job quản lý hồ sơ cục bộ, runbook và lịch sử job. Xem Môi trường chạy cục bộ.

Bí danh


Trường hợp sử dụng và ví dụ

Kiểm tra xem trang web của bạn có vượt qua các bài kiểm tra anti-detect không

Đăng nhập vào ứng dụng web và trích xuất dữ liệu bảng điều khiển

Điền biểu mẫu nhiều bước

Chụp ảnh màn hình các trang của đối thủ cạnh tranh

Tìm kiếm trên trang web chặn scraping

Một số trang web yêu cầu thực thi JavaScript, đăng nhập hoặc tương tác trước khi hiển thị kết quả. Hãy dùng trình duyệt để tìm kiếm:

Lưu và khôi phục trạng thái phiên

Xuất cookie và bộ nhớ lưu trữ để tái sử dụng giữa các phiên:

Phiên song song

Dùng các ID --session rõ ràng cho các tác vụ cloud độc lập. Dọn dẹp bằng close --all hoặc sessions --prune --older-than-ms.

Quy tắc về proxy

  • Hồ sơ được cấu hình sẵn: proxy được đặt trên hồ sơ thông qua bảng điều khiển hoặc API của Gologin, ví dụ proxy add-gologin <profileId> --country us
  • Hồ sơ cloud tạm thời: không dùng proxy, hoặc dùng proxy của riêng bạn với --proxy-host và --proxy-port (cùng với --proxy-mode http|socks4|socks5, --proxy-user, --proxy-pass)
  • Trong môi trường chạy cloud, open không chấp nhận --proxy-country. Để dùng lưu lượng proxy Gologin từ một quốc gia, hãy thêm proxy Gologin vào một hồ sơ và mở hồ sơ đó bằng --profile
  • Trong môi trường chạy cục bộ, open, profile-create và profile-update chấp nhận --proxy-country

Liên quan

Gói npm

gologin-agent-browser-cli

Mã nguồn

GologinLabs/agent-browser