Alat MCP dan API HTTP lokal

1. check_connection → list_profiles
2. Panggil open_profile dengan profile_id yang tepat, lalu simpan browser_session_id yang dikembalikan.
3. Gunakan browser_pages untuk memilih page_id yang tepat.
4. Gunakan browser_snapshot untuk memperoleh referensi elemen terbaru dan snapshot_id.
5. Gunakan referensi sesi, halaman, snapshot, dan elemen yang saling sesuai saat menjalankan tindakan. Ambil snapshot baru setelah halaman berubah.
6. Panggil release_browser setelah selesai. Gunakan close_profile hanya jika diminta menutup profil.

Satu profil hanya dapat dikendalikan oleh satu klien pada satu waktu. ID bersifat opak: maknanya tidak dapat disimpulkan dari nilainya dan ID tidak dapat dipakai kembali setelah browser dimulai ulang. Pilih mode visible jika seseorang perlu masuk atau memeriksa pekerjaan; mode headless digunakan untuk tugas latar belakang yang kompatibel.

Profil & halaman

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

Navigasi & interaksi

• 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

Data & file

• 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

Ini adalah nama alat, bukan skema permintaan lengkap. Server MCP yang terhubung memberitahukan nama parameter saat ini dan bidang yang diperlukan ke klien AI; gunakan skema itu daripada menebak argumen. Alat Cookie, penyimpanan, unggahan, dan JavaScript dapat mengakses data sensitif.

Aktifkan Local API hanya jika integrasi lokal membutuhkan HTTP. Salin endpoint loopback saat ini dan token akses dari API & MCP; port ditetapkan secara dinamis. MCP tetap tersedia dengan HTTP dinonaktifkan.

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

Token diperlukan. ID klien opsional direkomendasikan dan harus berupa 1–64 huruf ASCII, angka, garis bawah, atau tanda hubung. Contoh hanya menggunakan placeholder. Jangan pernah mempublikasikan token asli Anda.

GET /v1/profiles menampilkan daftar profil; POST /v1/profiles/open membuka salah satunya. Respons sukses menggunakan {"ok":true,"data":…}; kegagalan menggunakan {"ok":false,"error":{"code":…,"message":…}}. Lihat kode kesalahan umum.

Listener HTTP terikat ke 127.0.0.1, memvalidasi header Host, dan tidak mengaktifkan CORS browser. Jangan mengeksposnya melalui reverse proxy publik atau menerbitkan file penemuannya. Rotasi token membuat kredensial lama tidak berlaku; perbarui integrasi lokal Anda setelahnya.