Chuyển đến nội dung chính
Gologin Web Access là một CLI hợp nhất, kết hợp hai sản phẩm của Gologin trong cùng một bộ lệnh:
  • Web Unlocker — đọc và trích xuất dữ liệu không lưu trạng thái. Phù hợp khi bạn muốn lấy nội dung trang nhanh chóng mà không cần duy trì phiên trình duyệt.
  • Trình duyệt đám mây — tương tác có lưu trạng thái. Phù hợp khi bạn cần điều hướng, nhấp chuột, nhập văn bản, chụp ảnh màn hình hoặc chạy các quy trình nhiều bước được giữ nguyên giữa các lệnh.
Cả hai chế độ dùng chung một mô hình cấu hình và một bộ thông tin xác thực. Bạn nên cấu hình sẵn cả hai loại thông tin xác thực ngay từ đầu để các agent không phải dừng lại hỏi khóa còn thiếu giữa chừng khi đang thực hiện tác vụ.

Cài đặt

Yêu cầu Node.js >= 18.17.

Thông tin xác thực

Hai loại thông tin xác thực khác nhau của Gologin vận hành hai chế độ:

Tệp cấu hình

Lưu thông tin xác thực trong ~/.gologin-web-access/config.json:
Hoặc tạo tệp bằng lệnh config init. Lệnh này không có chế độ tương tác: bạn truyền các khóa qua cờ, hoặc lệnh sẽ lấy chúng từ các biến môi trường ở trên. Sau đó lệnh sẽ kiểm tra các khóa với các API của Gologin:
Thêm --no-validate để bỏ qua bước kiểm tra khóa. Nếu tệp cấu hình đã tồn tại, config init sẽ giữ nguyên tệp đó trừ khi bạn thêm --force.

Bắt đầu nhanh — đọc một trang

Bắt đầu nhanh — tương tác với một trang web


Tham chiếu lệnh — scraping / read

Các lệnh này dùng Web Unlocker. Chúng không lưu trạng thái — không có phiên trình duyệt nào được duy trì.

Một trang đơn

Tùy chọn chung: --format text|markdown|html, --source auto|unlocker|browser, --fallback none|browser

Thao tác hàng loạt

Tùy chọn hàng loạt: --format, --source, --only-main-content, --retry <n>, --backoff-ms <ms>, --summary, --output <path>, --strict Theo mặc định, batch-scrape trả về mã thoát 0 khi chỉ thành công một phần. Thêm --strict để lệnh báo lỗi khi có bất kỳ lỗi nào.

Tìm kiếm và khám phá

Tùy chọn: --limit <n>, --max-depth <n>, --concurrency <n>, --only-main-content

Tác vụ crawl bất đồng bộ

Theo dõi thay đổi

Runbook


Tham chiếu lệnh — browser / interact

Các lệnh này dùng Trình duyệt đám mây. Chúng duy trì một phiên có lưu trạng thái thông qua daemon cục bộ.

Quản lý phiên

Tùy chọn: --profile <id> để dùng một hồ sơ Gologin cụ thể.

Đọc trang

Tương tác

Điều hướng

Tab

Nâng cao


Các trường hợp sử dụng và ví dụ

Scrape trang bảng giá của đối thủ

Lệnh trả về tiêu đề, mô tả, các heading và liên kết dưới dạng JSON có cấu trúc. Nếu trang nằm sau cookie wall hoặc thử thách xác minh, trường outcome sẽ cho bạn biết — và nextActionHint gợi ý chuyển sang chế độ trình duyệt.

Xây dựng bộ dữ liệu nghiên cứu từ một trang tài liệu

Đưa kết quả đầu ra vào một LLM để tóm tắt, hỏi đáp hoặc tinh chỉnh (fine-tuning).

Theo dõi thay đổi của các trang

Chạy hằng ngày bằng cron. So sánh các điểm khác biệt để phát hiện thay đổi giá, tính năng mới hoặc nội dung bị gỡ bỏ.

Trích xuất dữ liệu có cấu trúc bằng schema

Hãy xác định những gì bạn muốn trích xuất. Schema ánh xạ từng trường đầu ra với một bộ chọn CSS:
Một chuỗi thuần sẽ trả về văn bản của phần tử khớp đầu tiên. Một đối tượng có thể có các thuộc tính sau:
  • selector — bộ chọn CSS
  • type — text (mặc định), html, attr hoặc exists
  • attribute — tên thuộc tính khi type là attr
  • all — true trả về mọi kết quả khớp dưới dạng danh sách
  • fields — một schema lồng nhau được áp dụng bên trong từng kết quả khớp
Sau đó, thực hiện trích xuất:
Có thể dùng cho nhiều trang với batch-extract.

Tìm kiếm trên web và scrape kết quả

Đăng nhập vào một trang web và tương tác

Khi scrape là chưa đủ — bạn cần nhấp chuột, nhập văn bản, điều hướng:

Phân tích tài liệu cục bộ

Không chỉ các trang web — bạn còn có thể phân tích tệp PDF, tài liệu Word, tệp Excel:

Tự động hóa quy trình nhiều bước bằng runbook

Xác định một chuỗi các bước trong JSON rồi chạy lại khi cần:

Định tuyến nguồn

Các lệnh hỗ trợ --source có thể định tuyến qua các backend khác nhau:

Đầu ra có cấu trúc

scrape-json trả về siêu dữ liệu phong phú, bao gồm:
  • title, description, headings, headingsByLevel, links
  • Phân loại kết quả (outcome): ok, empty, incomplete, authwall, challenge, blocked, cookie_wall
  • nextActionHint — gợi ý bước tiếp theo khi không thể truy cập đầy đủ trang
search trả về requestedLimit, returnedCount, warnings, cacheTtlMs và position cho từng kết quả.

Liên quan

Gói npm

gologin-web-access

Mã nguồn

GologinLabs/gologin-web-access