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 صرف اس وقت جب پروفائل بند کرنے کو کہا جائے۔

ایک پروفائل میں ایک وقت میں ایک ہی خصوصی کنٹرول کرنے والا کلائنٹ ہوتا ہے۔ IDs غیر شفاف ہیں اور براؤزر ری اسٹارٹ کے بعد دوبارہ استعمال نہیں کیے جا سکتے۔ منتخب کریں 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 کلائنٹ کو بتاتا ہے؛ اندازہ لگانے کے بجائے اسی اسکیمہ کا استعمال کریں۔ کوکی، اسٹوریج، اپ لوڈ، اور جاوا اسکرپٹ ٹولز حساس معلومات تک رسائی حاصل کر سکتے ہیں۔

فعال کریں مقامی 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 سے منسلک ہوتا ہے، Host ہیڈر کی تصدیق کرتا ہے، اور براؤزر CORS کو فعال نہیں کرتا۔ اسے عوامی ریورس پراکسی کے ذریعے ظاہر نہ کریں یا اس کی دریافت فائلوں کو شائع نہ کریں۔ ٹوکن کا ریٹیشن پرانے اسناد کو غیر فعال کر دیتا ہے؛ بعد میں اپنے مقامی انضمام کو اپ ڈیٹ کریں۔