أداة حل الكابتشا
لوكلاء الذكاء الاصطناعي
الوكيل الذي يصادف تحديًا يتوقف بصمت. اعرض الحل كأداة، فيصبح العائق مجرد استدعاء حتمي آخر.
الصق هذا في وكيل البرمجة لديك
Claude Code أو Cursor أو Codex أو Copilot أو Windsurf: تطلب التعليمة مفتاح API الخاص بك، وتضيف خادم MCP، وتربط دالة مساعدة للحل في مشروعك، وتتحقق من عملها من البداية إلى النهاية.
أعدّ CaptchaNo (https://captchano.com) في هذا المشروع حتى لا تعود الكابتشا تعيق أتمتة المتصفح لدينا. اقرأ دليل الإعداد الكامل أولًا واتبعه: https://captchano.com/agents/setup.md باختصار: 1. اطلب مني مفتاح CaptchaNo API (يبدأ بـ "cn-"؛ ويمكنني إنشاؤه من https://captchano.com/dashboard/keys). لا تكتبه مباشرة في الشيفرة ولا تطبعه ولا تسجله ولا تودعه في git أبدًا. خزّنه باسم CAPTCHANO_API_KEY في ملف .env الخاص بالمشروع والمستثنى من git أو في مخزن الأسرار. 2. إذا كنت تدعم MCP، فأضف خادم CaptchaNo MCP لنفسك: الأمر "npx -y captchano-mcp"، ومتغيرات البيئة CAPTCHANO_API_KEY وCAPTCHANO_MAX_SPEND_USD=1.00 (في Claude Code: claude mcp add captchano -e CAPTCHANO_API_KEY=<key> -e CAPTCHANO_MAX_SPEND_USD=1.00 -- npx -y captchano-mcp). 3. إذا كانت هذه الشيفرة تتحكم في متصفح أو عميل HTTP (Playwright أو Puppeteer أو Selenium أو Scrapy أو requests...)، فأضف دالة مساعدة صغيرة واحدة باسم solveCaptcha تستدعي POST https://api.captchano.com/v1/solve?wait=60 باستخدام مفتاح bearer، وأدرج الرمز token المُعاد بالطريقة الموضحة في الدليل. أعد استخدام عميل HTTP الموجود في المشروع وأسلوبه. 4. تحقّق: افحص الرصيد (أداة get_balance أو GET /v1/balance)، ثم نفّذ فحص الحل الواحد من البداية إلى النهاية الوارد في الدليل (يحل reCAPTCHA على https://captchano.com/tools/captcha-demo ويتأكد من أن Google تقبل الرمز token). المدعوم: reCAPTCHA v2/v3/Enterprise وCloudflare Turnstile وDataDome (يتطلب البروكسي الخاص بنا) وكابتشا الصور. لا تُحتسب عمليات الحل الفاشلة. لا تؤتمت إلا المواقع التي نملكها أو المسموح لنا بأتمتتها. أخبرني بما غيّرته عندما تنتهي.
الدليل الكامل الذي يتبعه الوكيل: captchano.com/agents/setup.md
الإعداد، والاستجابات محددة النوع، ووضوح تكلفة كل عملية حل.
الإعداد، والاستجابات محددة النوع، ووضوح تكلفة كل عملية حل.
الإعداد، والاستجابات محددة النوع، ووضوح تكلفة كل عملية حل.
الإعداد، والاستجابات محددة النوع، ووضوح تكلفة كل عملية حل.
الإعداد، والاستجابات محددة النوع، ووضوح تكلفة كل عملية حل.
الإعداد، والاستجابات محددة النوع، ووضوح تكلفة كل عملية حل.
لماذا يتعثر الوكلاء أمام الكابتشا
يفشل السكربت بشكل واضح عندما يصادف تحديًا. أما الوكيل فيفشل بصمت، وهذا أسوأ.
لا شيء في مجموعة أدوات الوكيل المعتادة يستطيع حل شبكة صور أو تحدٍّ يُقيَّم على مستوى الجلسة، فيبقى الوكيل عالقًا في الصفحة.
تختلق النماذج خطوة تالية تبدو معقولة وتبلّغ عن تقدم لم تحققه قط. والفشل هنا صامت.
الوكيل الذي يواصل إعادة تحميل صفحة عليها تحدٍّ يستهلك رموز token والوقت دون أن يقترب من هدفه.
زوّد الوكيل بأداة حل
- 01غلّف API كأداة
دالة واحدة تأخذ النوع وsitekey وعنوان URL وتستدعي /v1/solve?wait=60.
- 02أبقِ المفتاح خارج التعليمة
اقرأه من متغيرات البيئة داخل الأداة، حتى لا يراه النموذج أبدًا.
- 03أعِد نتيجة محددة النوع
الرمز token، ووكيل المستخدم (user agent) المستخدَم، والتكلفة، كي يتمكن الوكيل من الإرسال ومتابعة الإنفاق.
- 04ضع حدًا للحلقة
حدّد سقفًا لعدد عمليات الحل أو للإنفاق في كل تشغيل، حتى لا يدخل وكيل مرتبك في حلقة على صفحة واحدة.
ما الذي تعيده الأداة
تحمل كل استجابة الرمز token أو ملف تعريف الارتباط (cookie)، ووكيل المستخدم الذي أُنتج به، وتكلفة عملية الحل. يمكن للوكيل إعادة استخدام وكيل المستخدم نفسه عند الإرسال، ويمكن لجهة الإشراف إيقاف التشغيل عندما يتجاوز الإنفاق حدًا معينًا. أشكال الطلبات لكل أنواع التحديات موجودة في مرجع API.
لا حاجة إلى SDK
CaptchaNo هي REST API بسيطة، لذا فإن كل دليل من أدلة أطر العمل أعلاه مجرد بضعة أسطر من شيفرتك الخاصة، وليس حزمة عليك أن تثق بها. وهذا يعني أيضًا أن الأداة نفسها تعمل في أي إطار عمل لم نكتب له دليلًا بعد.
الأسئلة الشائعة حول الكابتشا ووكلاء الذكاء الاصطناعي
هل يستطيع وكيل الذكاء الاصطناعي حل الكابتشا بنفسه؟
قد يتمكن أحيانًا من النقر على مربع اختيار، لكنه لا يستطيع الإجابة عن تحديات الصور بشكل موثوق، كما أن المتصفحات المؤتمتة تُعرض عليها هذه التحديات بوتيرة أعلى. أداة الحل تحوّل التحدي إلى استدعاء حتمي واحد يستطيع الوكيل بناء قراراته على نتيجته.
ما أطر عمل الوكلاء المدعومة؟
أي إطار عمل يستطيع استدعاء HTTP API. لدينا أدلة لـ MCP وLangChain وBrowser Use وOpenAI Agents SDK وCrewAI وn8n، والنمط نفسه يعمل في غيرها.
هل يوجد خادم MCP لـ CaptchaNo؟
نعم. captchano-mcp خادم MCP مفتوح المصدر (MIT) تشغّله باستخدام npx -y captchano-mcp. يقرأ مفتاح API من متغيرات البيئة، وليس من النموذج أبدًا، ويدعم حدًا اختياريًا للإنفاق. وهو مُدرج في MCP Registry الرسمي.
كيف أمنع الوكيل من الإفراط في الإنفاق؟
تتضمن كل نتيجة تكلفتها. احتفظ بمجموع تراكمي داخل الأداة أو سياق التشغيل، وارفض أي عمليات حل إضافية بعد تجاوز الميزانية.
هل يُسمح بترك الوكلاء يحلون الكابتشا؟
يعتمد ذلك على الموقع والمهمة. الاستخدامات المقصودة هي: وكلاء يعملون على حساباتك الخاصة، أو يختبرون أنظمتك الخاصة، أو يجمعون بيانات يسمح بها الموقع. اقرأ شروط الموقع المستهدف أولًا.
أدلة مفيدة
هل أنت مستعد للبناء؟
ابدأ بفترة تجريبية مجانية لمدة 3 أيام، ثم ادفع مقابل كل عملية حل ناجحة مع نمو حركة المرور لديك. لا حاجة إلى بطاقة للفترة التجريبية.