Công cụ MCP & API HTTP cục bộ

1. check_connection → list_profiles
2. open_profile với chính xác profile_id; giữ lại các dữ liệu trả về browser_session_id.
3. browser_pages để chọn chính xác page_id.
4. browser_snapshot để lấy các tham chiếu phần tử mới và một snapshot_id.
5. Sử dụng phiên, trang, ảnh chụp nhanh và các tham chiếu phần tử tương ứng cho các hành động. Thực hiện một ảnh chụp nhanh mới sau khi trang thay đổi.
6. release_browser khi hoàn tất. Sử dụng close_profile chỉ khi được yêu cầu đóng hồ sơ.

Một hồ sơ chỉ có một khách hàng điều khiển độc quyền tại một thời điểm. ID là mờ và không thể sử dụng lại sau khi khởi động lại trình duyệt. Chọn visible chế độ khi một người cần đăng nhập hoặc kiểm tra công việc; headless dành cho các tác vụ nền tương thích.

Hồ sơ & trang

• check_connection
• list_profiles
• open_profile
• close_profile
• release_browser
• browser_pages
• browser_new_page
• browser_close_page
• browser_activate_page

Điều hướng & tương tác

• browser_navigate
• browser_back
• browser_forward
• browser_reload
• browser_snapshot
• browser_click
• browser_click_coordinates
• browser_type
• browser_press
• browser_hover
• browser_select
• browser_scroll
• browser_drag
• browser_wait
• browser_handle_next_dialog

Dữ liệu & tập tin

• browser_screenshot
• browser_upload_files
• browser_get_cookies
• browser_set_cookies
• browser_clear_cookies
• browser_storage_get
• browser_storage_set
• browser_storage_clear
• browser_grant_permissions
• browser_prepare_download
• browser_wait_download
• browser_evaluate

Đây là tên công cụ, không phải sơ đồ yêu cầu hoàn chỉnh. Máy chủ MCP được kết nối sẽ quảng bá tên tham số hiện tại và các trường bắt buộc cho client AI; sử dụng lược đồ đó thay vì đoán các đối số. Các công cụ cookie, lưu trữ, tải lên và JavaScript có thể truy cập dữ liệu nhạy cảm.

Bật API cục bộ chỉ khi một tích hợp cục bộ cần HTTP. Sao chép điểm cuối loopback hiện tại và mã truy cập từ API & MCP; cổng được gán động. MCP vẫn khả dụng khi HTTP bị vô hiệu hóa.

GET http://127.0.0.1:<port>/v1/status
Authorization: Bearer <access-token>
X-IFox9-Client-ID: my-integration

Mã là bắt buộc. ID khách hàng tùy chọn được khuyến nghị và phải gồm 1–64 ký tự ASCII, chữ số, gạch dưới hoặc gạch ngang. Ví dụ chỉ sử dụng các trình giữ chỗ. Không bao giờ công khai mã thực của bạn.

GET /v1/profiles liệt kê các hồ sơ; POST /v1/profiles/open mở một hồ sơ. Các phản hồi thành công sử dụng {"ok":true,"data":…}; các thất bại sử dụng {"ok":false,"error":{"code":…,"message":…}}. Xem các mã lỗi phổ biến.

HTTP listener gán vào 127.0.0.1, xác thực Host headers và không kích hoạt CORS trình duyệt. Không lộ nó qua proxy ngược công khai hoặc công bố các tệp khám phá của nó. Xoay token sẽ làm vô hiệu hóa các thông tin đăng nhập cũ; cập nhật tích hợp cục bộ của bạn sau đó.