ما هو متصفح CamoFox؟

متصفح CamoFox هو خادم أتمتة متصفح بلا واجهة (headless) تم بناؤه خصيصًا لوكيلات الذكاء الاصطناعي (AI agents). وهو يعمل بالاعتماد على Camoufox — وهو نسخة معدلة من Firefox تقوم بتزوير بصمة المستخدم على مستوى محرك المتصفح المكتوب بلغة C++، بدلاً من رقع JavaScript الهشة.

هذا يمكّن وكيلات الذكاء الاصطناعي من زيارة مواقع الويب الحقيقية التي عادةً ما تحجب أدوات الأتمتة مثل Playwright أو Puppeteer، بما في تلك المحمية بواسطة Cloudflare وGoogle وأنظمة كشف الروبوتات المتقدمة الأخرى.

إنه نفس محرك التصفح المستخدم خلف مساعد Jo AI ويتكامل بسلاسة مع OpenClaw وأطر عمل الوكيلات الأخرى.

الميزات الرئيسية

مقاومة الكشف على مستوى C++: يزوير خصائص المتصفح (navigator properties)، وWebGL، وAudioContext، وهندسة الشاشة، وWebRTC، والمزيد على مستوى محرك المتصفح لتحقيق أقصى درجات عدم القابلية للكشف.
لقطات فعالة في استهلاك الرموز (Tokens): يعيد لقطات من شجرة إمكانية الوصول (accessibility tree) (أصغر بنسبة ~90% من HTML الخام) + لقطات شاشة اختيارية بصيغة base64.
مراجع عناصر مستقرة: يستخدم مراجع موثوقة مثل e1, e2, ... للنقر، والكتابة، والتفاعل.
عزل الجلسات: عزل لكل userId و sessionKey مع انتهاء صلاحية تلقائي وإعادة تدوير للتبويبات.
محاذاة الوكيل والموقع الجغرافي (Proxy & GeoIP Alignment): يوجّه حركة المرور عبر وكلاء سكنية (residential proxies) تتطابق مع الإعدادات المحلية، والمنطقة الزمنية، والموقع الجغرافي.
استيراد ملفات تعريف الارتباط (Cookies): يدعم حقن ملفات تعريف الارتباط بصيغة Netscape للجلسات المصادق عليها (مثل LinkedIn، وAmazon، وغيرها).
وحدات ماكرو بحثية مدمجة: @google_search, @youtube_search, @amazon_search, @reddit_subreddit, والمزيد.
استخراج النصوص من YouTube: مسار سريع عبر yt-dlp أو استخدام المتصفح كخيار احتياطي.
استهلاك منخفض للموارد: ~40 ميجابايت من الذاكرة في وضع الخمول؛ إطلاق متأخر (lazy launch) وإغلاق في حالة الخمول. يعمل على Raspberry Pi أو خوادم VPS رخيصة.
واجهة برمجة تطبيقات (API) منظمة: نقاط نهاية REST مع تسجيل JSON وتتبع معرف الطلب.

الهيكلية

متصفح مدعوم من Camoufox
سياق متصفح معزول (BrowserContext) لكل مستخدم
مجموعات تبويبات منظمة حسب sessionKey
إغلاق تلقائي في حالة الخمول وإعادة تشغيل عند الطلب

التثبيت والبدء السريع

منفرد (Standalone)

git clone https://github.com/jo-inc/camofox-browser
cd camofox-browser
npm install
npm start

يعمل الخادم على http://localhost:9377. يتم تنزيل Camoufox (~300 ميجابايت) تلقائيًا عند التشغيل الأول.

Docker

make up

يدعم Fly.io وRailway والبنيات متعددة الأبنية (multi-arch builds).

التكامل مع OpenClaw

openclaw plugins install @askjo/camofox-browser

أمثلة الاستخدام

إنشاء علامة تبويب جديدة

curl -X POST http://localhost:9377/tabs \
  -H "Content-Type: application/json" \
  -d '{"userId": "agent1", "sessionKey": "task1", "url": "https://example.com"}'

الحصول على لقطة للناحية التقنية للنفاذية + صورة للشاشة

curl "http://localhost:9377/tabs/{TAB_ID}/snapshot?userId=agent1&includeScreenshot=true"

النقر على عنصر حسب المرجع

curl -X POST http://localhost:9377/tabs/{TAB_ID}/click \
  -d '{"userId": "agent1", "ref": "e1"}'

البحث باستخدام ماكرو

curl -X POST http://localhost:9377/tabs/{TAB_ID}/navigate \
  -d '{"userId": "agent1", "macro": "@google_search", "query": "best wireless headphones"}'

حالات الاستخدام

وكلاء الذكاء الاصطناعي الذين يحتاجون إلى تصفح ويب موثوق (بحث، تسوق، وسائط اجتماعية، إلخ)
تجاوز حماية مكافحة الروبوتات على مواقع محمية بواسطة Cloudflare أو Google
التصفح المصادق عليه باستخدام ملفات تعريف الارتباط المستوردة
تفاعل ويب فعال من حيث الرموز المميزة (Tokens) في سير عمل وكلاء طويلة المدى
التكامل مع OpenClaw، Claude Desktop (عبر MCP)، LangChain، ووكلاء مخصصين

الموارد

-, GitHub: https://github.com/jo-inc/camofox-browser -, Camoufox: https://camoufox.com -, OpenClaw Integration: https://openclaw.ai -, Documentation: https://jo-inc-camofox-browser.mintlify.app

CamoFox Browser مرخصة تحت MIT، قيد الصيانة النشطة (أحدث إصدار أبريل 2026)، وتُستخدم على نطاق واسع لأتمتة تصفح الويب لوكلاء الذكاء الاصطناعي في بيئة الإنتاج.