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