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

فعّل 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

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