إضافة حل CAPTCHA إلى وكيل الذكاء الاصطناعي باستخدام MCP

يتضمن التنزيل الرسمي لـ @solvethree/sdk الملف التنفيذي solvethree-mcp. تستخدم الإعدادات أدناه npx لتشغيله من عنوان URL للحزمة المرفق. لا توجد نقطة نهاية MCP مستضافة لإدخالها.

• وفّر npx في البيئة التي يعمل فيها مضيف MCP لديك.
• اضبط SOLVETHREE_API_KEY على مفتاح API لمساحة عملك في بيئة المضيف. لا تُدرجه في شيفرة المتصفح أو الموجّهات.
• اضبط SOLVETHREE_PROXY في تلك البيئة. تقرأ أداة reCAPTCHA وكيلها الوحيد من هذا المتغير، وليس من طلب الأداة.

لمضيف يقبل إعداد MCP بصيغة JSON، أضف إدخال الخادم التالي:

{
  "mcpServers": {
    "solvethree": {
      "command": "npx",
      "args": [
        "--yes",
        "--package=https://solvethree.com/downloads/solvethree-sdk-0.1.0.tgz",
        "solvethree-mcp"
      ]
    }
  }
}

بالنسبة إلى Codex، استخدم إعداد TOML التالي بدلًا من ذلك. يمرّر الإدخال env_vars المتغيرين من بيئة المضيف؛ ولا يضبط قيمتيهما.

[mcp_servers.solvethree]
command = "npx"
args = ["--yes", "--package=https://solvethree.com/downloads/solvethree-sdk-0.1.0.tgz", "solvethree-mcp"]
env_vars = ["SOLVETHREE_API_KEY", "SOLVETHREE_PROXY"]
startup_timeout_sec = 60
tool_timeout_sec = 100

شغّل المضيف أو أعِد تحميله مع إتاحة متغيرات البيئة تلك. تحقّق من أنه يتيح solvethree_capabilities وsolvethree_create_recaptcha وsolvethree_create_kasada وsolvethree_create_tmpt وsolvethree_get_task.

قبل إنشاء مهمة reCAPTCHA، أعِدّ ملف تعريف الموقع المستهدف وتأكد من أنه نشط لمساحة عملك. إرسال اسم مضيف وإجراء عبر MCP لا ينشئ ملف التعريف هذا.

استخدم solvethree_capabilities لفحص الإمكانات المتاحة. بالنسبة إلى reCAPTCHA v3 Enterprise، استدعِ solvethree_create_recaptcha بالطلب التالي:

{
  "site": "accounts.example.com",
  "action": "login",
  "requestId": "agent-login-001",
  "waitMs": 0
}

استبدل accounts.example.com بموقعك المستهدف وlogin بالإجراء الذي يحتاج إليه تطبيقك. اختر requestId لهذه المهمة المنطقية واحتفظ به مع الطلب. عند ضبط waitMs على صفر، استرجع النتيجة بشكل منفصل بدلًا من انتظار الاكتمال في هذا الاستدعاء.

تتطلب كل عملية إنشاء عبر MCP الحقل requestId، رغم أنه اختياري في واجهة API الأساسية للمهام. استخدم 1–64 حرفًا من أحرف ASCII أو أرقامًا أو شرطات سفلية أو واصلات.

1. 1.

   الاحتفاظ بمعرّف المهمة المُرجع

   إنشاء المهمة ليس النتيجة. احفظ معرّف المهمة ليتمكن الوكيل من استرجاع المهمة نفسها.

2. 2.

   استدعاء solvethree_get_task

   استخدم معرّف المهمة المُرجع من استدعاء الإنشاء. إذا كانت الحالة pending أو solving، فاسترجع المهمة مجددًا لاحقًا. لا تتضمن أي من الحالتين حلًا قابلًا للاستخدام.

3. 3.

   معالجة الحالة النهائية

   عند ready، مرّر الحل إلى تكامل المتصفح أو التطبيق لديك. وعند failed، افحص errorCode وerror وأوقف استقصاء تلك المهمة.

بالنسبة إلى reCAPTCHA، أرسل solution.token عبر متصفحك أو طلب تطبيقك. اضبط ترويستي User-Agent وsec-ch-ua من القيمتين المُرجعتين userAgent وsecChUa، وأعِد استخدام الوكيل المضبوط في SOLVETHREE_PROXY. ثبّت جلسة الوكيل تلك إذا كان مزوّدك يدوّر نقاط الخروج.

تُرجع Kasada ترويسات، ويُرجع Ticketmaster TMPT قيمة خام لملف تعريف ارتباط. طبّق المخرجات المناسبة للمهمة التي طلبتها؛ فهذه النتائج ليست قابلة للتبادل.

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

انتهاء مهلة الاتصال لا يثبت فشل إنشاء المهمة. إذا تلقيت معرّف مهمة، فاسترجعها باستخدامه. وإلا، فكرّر طلب الإنشاء نفسه باستخدام requestId نفسه ومدخلات المهمة دون تغيير لاسترجاع المهمة الموجودة. لا تُنشئ معرّفًا جديدًا لمجرد فقدان الاستجابة.

تؤدي إعادة استخدام معرّف طلب مع مدخلات مهمة مختلفة إلى تعارض. إذا فشلت المهمة نفسها، فاقرأ خطأها قبل تحديد ما يجب تغييره؛ فإعادة إرسال مدخلات غير صالحة دون تحقّق لن تصلحها. لمعرفة الفرق بين أخطاء الطلبات وإخفاقات المهام، راجع أخطاء CAPTCHA API.