أدوات MCP وواجهة برمجة تطبيقات HTTP محلية

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؛ استخدم هذا المخطط بدلًا من التخمين. يمكن لأدوات الكوكيز والتخزين والتحميل وJavaScript الوصول إلى البيانات الحساسة.

تمكين واجهة برمجة التطبيقات المحلية فقط إذا كان التكامل المحلي يحتاج إلى HTTP. انسخ نقطة النهاية الحالية للتكرار المحلي ورمز الوصول من API و MCP؛ يتم تعيين المنفذ ديناميكيًا. يظل MCP متاحًا مع تعطيل HTTP.

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

الرمز مطلوب. يُوصى باستخدام معرف العميل الاختياري ويجب أن يكون من 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 للمتصفح. لا تعرضه عبر وكيل عكسي عام أو تنشر ملفات اكتشافه. تدوير الرموز يُبطل بيانات الاعتماد القديمة؛ حدّث التكامل المحلي بعد ذلك.