MCP टूल्स और लोकल HTTP API

1. check_connection → list_profiles
2. open_profile को सही profile_id के साथ कॉल करें और लौटाया गया browser_session_id संभालकर रखें।
3. browser_pages से सही page_id चुनें।
4. browser_snapshot से एलिमेंट के नए रेफ़रेंस और snapshot_id प्राप्त करें।
5. हर कार्रवाई में एक-दूसरे से मेल खाने वाले सेशन, पेज, स्नैपशॉट और एलिमेंट रेफ़रेंस इस्तेमाल करें। पेज बदलने पर नया स्नैपशॉट लें।
6. काम पूरा होने पर release_browser कॉल करें। close_profile का इस्तेमाल केवल प्रोफ़ाइल बंद करने के लिए कहे जाने पर करें।

एक समय में केवल एक क्लाइंट किसी प्रोफ़ाइल को नियंत्रित कर सकता है। आईडी से उसके अर्थ का अनुमान नहीं लगाया जा सकता और ब्राउज़र रीस्टार्ट होने के बाद उसे दोबारा इस्तेमाल नहीं किया जा सकता। जब किसी व्यक्ति को साइन इन करना हो या काम जाँचना हो, तो visible मोड चुनें; headless मोड उपयुक्त बैकग्राउंड कार्यों के लिए है।

प्रोफ़ाइल और पृष्ठ

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

नेविगेशन और इंटरैक्शन

• 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

डेटा और फ़ाइलें

• 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

ये टूल के नाम हैं, पूर्ण अनुरोध स्कीमा नहीं। कनेक्टेड MCP सर्वर वर्तमान पैरामीटर नाम और आवश्यक फ़ील्ड AI क्लाइंट को बताता है; तर्कों के बारे में अनुमान लगाने के बजाय उस स्कीमा का उपयोग करें। कुकी, स्टोरेज, अपलोड, और जावास्क्रिप्ट टूल संवेदनशील डेटा तक पहुँच सकते हैं।

Local API केवल तभी चालू करें जब लोकल इंटीग्रेशन को HTTP की ज़रूरत हो। मौजूदा लूपबैक एंडपॉइंट और एक्सेस टोकन API & MCP से कॉपी करें; पोर्ट डायनेमिक रूप से असाइन किया जाता है। MCP HTTP अक्षम होने पर भी उपलब्ध रहता है।

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

टोकन आवश्यक है। वैकल्पिक क्लाइंट ID की सिफारिश की जाती है और इसमें 1–64 ASCII अक्षर, अंक, अंडरस्कोर, या हाइफ़न होने चाहिए। उदाहरण केवल प्लेसहोल्डर्स का उपयोग करते हैं। कभी भी अपना वास्तविक टोकन प्रकाशित न करें।

GET /v1/profiles प्रोफाइल सूचीबद्ध करता है; POST /v1/profiles/open एक को खोलता है। सफल प्रतिक्रियाएं उपयोग करती हैं {"ok":true,"data":…}; असफलताएं उपयोग करती हैं {"ok":false,"error":{"code":…,"message":…}}। देखें सामान्य त्रुटि कोड.

HTTP लिसनर 127.0.0.1 से बाइंड होता है, होस्ट हेडर को मान्य करता है, और ब्राउज़र CORS सक्षम नहीं करता। इसे सार्वजनिक रिवर्स प्रॉक्सी के माध्यम से उजागर न करें या इसके डिस्कवरी फ़ाइल प्रकाशित न करें। टोकन बदलने से पुरानी एक्सेस जानकारी अमान्य कर देता है; इसके बाद अपने स्थानीय इंटीग्रेशन को अपडेट करें।