- 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ài đặt
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:
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:
--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
Cookie và bộ nhớ lưu trữ
Nâng cao
Các trường hợp sử dụng và ví dụ
Scrape trang bảng giá của đối thủ
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
Theo dõi thay đổi của các trang
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:selector— bộ chọn CSStype—text(mặc định),html,attrhoặcexistsattribute— tên thuộc tính khitypelàattrall—truetrả về mọi kết quả khớp dưới dạng danh sáchfields— một schema lồng nhau được áp dụng bên trong từng kết quả khớp
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
- Web Unlocker SDK — SDK TypeScript dùng để lập trình
- Web Unlocker là gì — tổng quan sản phẩm
- Agent Browser CLI — CLI chỉ dành cho trình duyệt, phục vụ các AI agent
- Môi trường chạy cục bộ — Agent Browser CLI với các hồ sơ Orbita cục bộ
- AI Skills — các skill cắm là chạy dành cho Claude Code
Gói npm
gologin-web-access
Mã nguồn
GologinLabs/gologin-web-access