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:
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
Thông tin xác thực
Lấy mã thông báo
- Đăng ký hoặc đăng nhập tại gologin.com
- Mở API & MCP trong bảng điều khiển
- Mở tab API
- Nhấp Mã thông báo mới
- 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:- 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ẹ - 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
connectOverCDPcủ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
- Unix socket tại
${TMPDIR:-/tmp}/gologin-agent-browser.sock - HTTP localhost tại
127.0.0.1:${GOLOGIN_DAEMON_PORT:-44777}
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:
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
Cookie và bộ nhớ lưu trữ
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.--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-hostvà--proxy-port(cùng với--proxy-mode http|socks4|socks5,--proxy-user,--proxy-pass) - Trong môi trường chạy cloud,
openkhô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-createvàprofile-updatechấp nhận--proxy-country
Liên quan
- Gologin Web Access CLI — CLI hợp nhất (scraping + trình duyệt)
- Môi trường chạy cục bộ — chạy hồ sơ Orbita cục bộ với CLI này
- Bắt đầu với Cloud Browser — ví dụ về Puppeteer/Playwright
- AI Skills — các skill cắm là chạy cho Claude Code
Gói npm
gologin-agent-browser-cli
Mã nguồn
GologinLabs/agent-browser