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

1. check_connection → list_profiles
2. Gọi open_profile với đúng profile_id và lưu lại browser_session_id được trả về.
3. Dùng browser_pages để chọn đúng page_id.
4. Dùng browser_snapshot để lấy tham chiếu phần tử mới và snapshot_id.
5. Dùng các tham chiếu phiên, trang, bản chụp trạng thái và phần tử khớp nhau khi thao tác. Lấy bản chụp mới sau khi trang thay đổi.
6. Gọi release_browser khi xong việc. Chỉ dùng close_profile khi được yêu cầu đóng hồ sơ.

Mỗi hồ sơ chỉ do một ứng dụng khách điều khiển tại một thời điểm. Không suy diễn ý nghĩa từ ID và không dùng lại ID sau khi khởi động lại trình duyệt. Chọn chế độ visible khi người dùng cần đăng nhập hoặc kiểm tra công việc; chế độ headless dành cho 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 ứng dụng khách 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 đó.