MCP server trình duyệt với một danh tính thực thụ
Thêm Clearcote vào config của MCP client và model sẽ có một trình duyệt để đọc, click và gõ phím thông qua hai mươi tool. Danh tính được đặt một lần, trong biến môi trường, nên danh sách tool luôn ngắn gọn và fingerprint luôn nhất quán trong lúc agent làm việc.
Chạy bản build mở mà không cần khóa. Thêm khóa GitHub miễn phí để dùng bản build mới nhất.
Thêm vào config của client
{
"mcpServers": {
"clearcote": {
"command": "npx",
"args": ["-y", "clearcote-mcp"],
"env": {
"CLEARCOTE_FINGERPRINT": "acct-1",
"CLEARCOTE_TIMEZONE": "America/New_York",
"CLEARCOTE_ACCEPT_LANGUAGE": "en-US"
}
}
}
}Điểm nổi bật
Hai mươi tool
navigate, read_page, page_elements, click, fill_field và screenshot_page, cùng các tool để chờ, nhấn phím, quản lý tab, cookie, PDF và phiên đã lưu.
Danh tính nằm ngoài prompt
Seed, platform, brand, ngôn ngữ và múi giờ là các biến môi trường CLEARCOTE_*. Model không bao giờ phải bận tâm suy luận về fingerprint.
Những client bạn đang dùng
Claude Desktop, Cursor và Cline dùng chung một cấu trúc config. Cài từ PyPI, rồi chạy trực tiếp hoặc qua trình khởi chạy npx.
Không có switch automation
Server khởi động trình duyệt mà không có switch automation của Playwright, nên navigator.webdriver vẫn là false, và engine giữ các tác dụng phụ thường gặp của CDP tránh xa trang.
Lối thoát sang CDP thô
get_cdp_endpoint trả về CDP URL của trình duyệt, nên một script có thể tiếp tục đúng phiên mà agent đang làm việc.
Bản build mới nhất, chỉ một biến
Thêm CLEARCOTE_LICENSE_KEY để chạy bản build có giấy phép mới nhất thay vì bản build mở.
MCP server hoạt động như thế nào
Server khởi động một trình duyệt Clearcote và giữ nó chừng nào server còn chạy. Mỗi lệnh gọi tool đều tác động lên trình duyệt dùng chung đó: model đọc trang dưới dạng text hoặc markdown, liệt kê các link, nút và ô nhập đang hiển thị kèm CSS selector cho từng phần tử nếu có, rồi thao tác với chúng qua các selector đó, nên hiếm khi phải tự viết selector.
Danh tính được cố định khi server khởi động. Các thông số persona cơ bản (seed, platform, brand, ngôn ngữ, múi giờ, proxy và geoip) là các biến CLEARCOTE_*, nên mỗi mục server trong config là một danh tính, và không tool nào có thể thay đổi nó giữa chừng một task. Với các flag fingerprint còn lại, hãy dùng trực tiếp SDK.
Có hai cách để giao quyền điều khiển Clearcote cho một model. Server này giữ model ở bên ngoài trình duyệt, gọi các tool. Còn agent trong trình duyệt thì chạy bên trong process của trình duyệt, và giao tiếp với một endpoint tương thích OpenAI do bạn chọn.
Các tool dùng nhiều nhất
| Tool | Chức năng |
|---|---|
read_page | Đọc trang đang hiển thị dưới dạng text hoặc markdown |
page_elements | Liệt kê tối đa 200 link, nút và ô nhập đang hiển thị, kèm CSS selector cho từng phần tử nếu có |
click | Click vào một phần tử |
fill_field | Gõ vào một ô input hoặc textarea |
screenshot_page | Chụp ảnh PNG toàn trang, lưu vào thư mục ghi của server |
navigate | Tải một URL trong tab hiện tại và trả về URL cuối cùng cùng tiêu đề trang |
save_profile | Lưu cookie và storage vào một file có tên, để khôi phục cookie sau này |
get_cdp_endpoint | Trả về CDP URL cho một client thô |
Ngoài ra còn có get_page_html, press_key, wait_for, evaluate_js, current_page, get_cookies, list_tabs, new_tab, close_tab, load_profile, get_egress_info và save_page_pdf (chỉ ở chế độ headless).
Mọi người dùng nó để làm gì
Nghiên cứu bằng trình duyệt thật
Cho model đọc những trang cần JavaScript để hiển thị, thay vì chỉ fetch văn bản thuần.
Việc vặt thường ngày trên web
Đăng ký, trang cài đặt và dashboard mà nếu không bạn sẽ phải tự click qua từng bước.
Debug cùng trợ lý
Nhờ Cursor tái hiện một bug trên site staging của bạn và chụp màn hình từng bước.
Làm prototype cho automation
Đi qua một luồng cùng model, rồi lấy CDP endpoint và viết script cho luồng đó.
Clearcote được xây dựng cho quyền riêng tư, kiểm thử, nghiên cứu và tự động hóa hợp pháp. Bạn chịu trách nhiệm về cách mình sử dụng nó và về việc tuân thủ điều khoản của các trang web bạn truy cập.
Gói nào có tính năng này
MCP server miễn phí ở mọi gói. Nó chạy bản build mở trừ khi tìm thấy khóa giấy phép (CLEARCOTE_LICENSE_KEY, hoặc khóa đã lưu bằng clearcote login); khóa GitHub miễn phí chạy bản build mới nhất, mỗi lần một trình duyệt.
Câu hỏi thường gặp
Nó hoạt động với những MCP client nào?
Các client khởi chạy MCP server từ một file config. Ví dụ ở trên là Claude Desktop, còn Cursor và Cline dùng cùng một cấu trúc.
Model có điều khiển fingerprint không?
Không. Danh tính lấy từ biến môi trường khi server khởi động, và không tool nào thay đổi nó. Nhờ vậy persona nhất quán trong suốt phiên và danh sách tool được giữ ngắn gọn.
Cần Node hay Python?
Cách nào cũng cần Python 3.10 trở lên: package npm chỉ là trình khởi chạy cho chính server Python đó. Cài bằng pip và ghim mcp dưới 2.0, như trong khối cài đặt ở trên (clearcote-mcp 0.1.0 không chạy được trên mcp 2.x), sau đó dùng clearcote-mcp hoặc npx -y clearcote-mcp làm lệnh chạy.
Khác gì so với agent trong trình duyệt?
MCP server cho phép một model bên ngoài (model trong chat client của bạn) điều khiển trình duyệt thông qua các tool. Agent trong trình duyệt thì chạy bên trong trình duyệt và gọi tới endpoint model mà bạn cấu hình. Cả hai đều điều khiển cùng một engine.
Script có thể tiếp quản phiên của agent không?
Được. get_cdp_endpoint trả về CDP URL của trình duyệt mà agent đang dùng, và Playwright hoặc Puppeteer có thể kết nối vào đó.
Tìm hiểu sâu hơn trong tài liệu
Tính năng liên quan
Cho browser-use, Stagehand, Crawl4AI hoặc agent của riêng bạn một Chromium có danh tính thiết lập ở cấp engine, hoặc chạy agent trong trình duyệt của Clearcote (bật khi cần) với model của riêng bạn.
Chạy Clearcote như một CDP endpoint thường trực từ Docker image chính thức, serve() hoặc CLI, rồi kết nối bất kỳ framework nào mà không cần sửa code.
Khởi chạy trình duyệt Clearcote trên cloud bằng một lệnh gọi API rồi kết nối Playwright hoặc Puppeteer qua CDP. Đã kèm IP dân cư, tính phí theo GB lưu lượng.
Canvas, WebGL, WebGPU, audio, font, màn hình và phần cứng được suy ra trong engine C++ từ một seed, với locale và múi giờ được đặt cho khớp, để mọi bề mặt đều nhất quán với nhau.
Bài đọc liên quan
Dùng thử Clearcote
Thay thế drop-in cho Playwright & Puppeteer, nhất quán đến tận TLS handshake, với một bản build mã nguồn mở để bắt đầu.
Miễn phí cho một trình duyệt với GitHub. Không cần thẻ.