استخدام نتيجة CAPTCHA من MCP في وكيل متصفح

1. 1.

   أعدّ خادم MCP المحلي

   اتبع تعليمات إعداد MCP لتشغيل solvethree-mcp عبر npx. إنه خادم stdio محلي، وليس نقطة نهاية مستضافة. وفّر SOLVETHREE_API_KEY وSOLVETHREE_PROXY عبر بيئة المضيف؛ ولا تضع بيانات الاعتماد في موجّه الوكيل.

2. 2.

   تحقّق من الأدوات المتاحة وملف تعريف الموقع

   استدعِ solvethree_capabilities لفحص الإمكانات المتاحة. بالنسبة إلى reCAPTCHA Enterprise، يجب أن يكون لدى مساحة العمل مسبقًا ملف تعريف نشط لاسم المضيف وإجراء الالتقاط ونوع reCAPTCHA المقصودين. تمرير site وaction إلى أداة إنشاء لا ينشئ ملف التعريف هذا. استخدم ملفات تعريف المواقع إذا كان الإعداد لا يزال مطلوبًا.

3. 3.

   تأكّد من أن المتصفح يستطيع إرسال الطلب المطابق

   يجب أن يدعم المتصفح الوكيل المثبّت نفسه والقيمتين المُعادتين userAgent وsecChUa. ويجب أن يحتفظ أيضًا بملفات تعريف الارتباط الخاصة بالتطبيق وحقول CSRF ومتطلبات الجلسة. إذا كانت أداة المتصفح لا تتيح ضبط هذه العناصر، فتوقف قبل الدفع مقابل حل بدلًا من استخدام جلسة متصفح غير مرتبطة بديلًا عنها.

بالنسبة إلى أداة reCAPTCHA في MCP، يأتي الوكيل الوحيد من SOLVETHREE_PROXY، لا من وسيطات الأداة. أبقِ هذا الوكيل مثبّتًا لإرسال الطلب من المتصفح. يتلقى المضيف بيانات حل خاصة، لذا لا تُدرج الرموز وبيانات اعتماد الوكيل في تقارير الوكيل الاعتيادية.

استخدم هذه التعليمة بعد إعداد خادم MCP والمتصفح. وفّر اسم المضيف المستهدف وإجراء التنفيذ من طلب التطبيق. تستخدم solvethree_create_recaptcha افتراضيًا Enterprise v3؛ ووسيطاتها المطلوبة هي site وaction وrequestId.

Use the already-configured solvethree MCP server for one reCAPTCHA Enterprise task.
The target hostname must have an active workspace profile before creation.
1. Keep one requestId for this logical task. Ask before starting another paid task.
2. Call solvethree_create_recaptcha with site, action and that requestId.
   The server reads its target proxy from SOLVETHREE_PROXY.
3. Save the returned id. Call solvethree_get_task for that id while pending/solving,
   stopping at ready, failed or the agreed deadline. Never poll by creating again.
4. If ready, submit solution.token using the application’s actual token parameter.
   Use the returned userAgent/secChUa and the same pinned proxy in the browser.
   Keep the application’s cookies, CSRF fields and session requirements.
5. Read the application response. Report task ID and outcome, not secret solution data.
If the browser tool cannot configure that proxy and identity, stop and explain the
missing capability instead of claiming it submitted an equivalent request.

معرّف المهمة المحفوظ id مخصص لـ solvethree_get_task؛ وليس القيمة التي تُرسل إلى الموقع. تعني pending وsolving مواصلة الانتظار ضمن المهلة المتفق عليها. وحدها ready تحتوي على حل قابل للاستخدام. عند failed، اقرأ errorCode وerror وتوقف عن الاستعلام الدوري عن تلك المهمة.

لا توجد خطوة تعبئة تلقائية تصلح لجميع الحالات. حدّد طلب التطبيق الذي يستخدم النتيجة، ثم استخدم حقل الحل المطابق. لكل نتيجة أدناه، استخدم هوية المتصفح المُعادة والوكيل الناجح مع الجهة المستهدفة المقصودة.

بعد الإرسال، افحص استجابة التطبيق. تعني المهمة بالحالة ready أنه تم توليد حل، لا أن الجهة المستهدفة قبلته. إذا رفضته الجهة المستهدفة، فافحص الطلب الصادر أولًا: تأكّد من إرسال الرمز أو ملف تعريف الارتباط أو الترويسات الفعلية، إلى جانب الوكيل والهوية وجلسة التطبيق المطابقة. أبلغ عن معرّف المهمة ونتيجة التطبيق دون كشف الحل.

أنشئ requestId واحدًا لكل مهمة منطقية واحتفظ به مع المدخلات الأصلية. يجب أن يتكون من 1–64 حرفًا من أحرف ASCII أو الأرقام أو الشرطات السفلية أو الواصلات. إذا انتهت مهلة الإنشاء قبل أن تتلقى id، فكرّر طلب الإنشاء نفسه باستخدام requestId نفسه والمدخلات دون تغيير لاستعادة المهمة الموجودة. إذا كان لديك بالفعل id المهمة، فاستخدم solvethree_get_task.

لا تغيّر المدخلات عند إعادة استخدام ذلك المعرّف: فهذا يؤدي إلى تعارض. لا تُنشئ معرّفًا جديدًا لمجرد فقدان استجابة أو انتهاء مهلة الاستعلام الدوري. لا يثبت أيٌّ من الأمرين أن المهمة الأصلية فشلت.

ينشئ كل استدعاء إنشاء في MCP مهمة واحدة على الأكثر، لكن ذلك لا يفرض حدًا للإنفاق على الوكيل. اشترط الحصول على موافقة قبل بدء مهمة منطقية أخرى. عند حدوث فشل نهائي، افحص errorCode وerror قبل تقرير ما إذا كان هناك ما يبرر طلبًا مصححًا؛ إذ تُردّ رسوم محاولات الحل الفاشلة. خطأ الطلب مشكلة منفصلة عن مهمة حالتها failed.