أتمتة المتصفح OpenClaw

## نظرة عامة

أتمتة مهام المتصفح المتكررة على مواقع الويب المصرح بها — التنقل بين الصفحات، استخراج البيانات المنظمة، ملء النماذج، التقاط لقطات الشاشة كأدلة، وتشغيل اختبارات الانحدار البصري. مبني على ثلاث مهارات مثبتة: **browser-use** للتحكم التفاعلي في المتصفح، **firecrawl** لكشط الويب واستخراج المحتوى، و**webapp-testing** لاختبار واجهة المستخدم المعتمد على Playwright.

## البداية السريعة

1. تثبيت الإضافة:
   ```bash
   npx skillstore add @openclaw-browser-automation
   ```
2. استخدام **browser-use** للتنقل والتفاعل مع الصفحة:
   ```
   browser-use open https://dashboard.example.com
   browser-use state
   browser-use click 5
   browser-use screenshot
   ```
3. استخدام **firecrawl** لاستخراج محتوى الصفحة كـ markdown منظم:
   ```
   firecrawl scrape https://example.com/data
   ```
4. استخدام **webapp-testing** لتشغيل اختبار Playwright البصري:
   ```
   python scripts/with_server.py --url http://localhost:3000 -- pytest test_ui.py
   ```

## مثال سير العمل الكامل

**تسجيل الدخول → استخراج بيانات الجدول → أدلة لقطات الشاشة → التصدير**

1. افتح لوحة التحكم المستهدفة باستخدام **browser-use**
2. املأ نموذج تسجيل الدخول وأرسل بيانات الاعتماد
3. انتقل إلى صفحة جدول البيانات
4. استخدم **firecrawl** لكشط الجدول إلى JSON/CSV نظيف
5. التقط لقطة شاشة باستخدام **browser-use** لسجل التدقيق
6. تحقق من المخرجات باستخدام تأكيدات **webapp-testing**

## المهارات الرئيسية

- **browser-use** — التنقل في الروابط، النقر على العناصر، ملء النماذج، كتابة النص، التقاط لقطات الشاشة، استخراج البيانات من الصفحات المعروضة. يحافظ على جلسات متصفح مستمرة عبر الأوامر.
- **firecrawl** — كشط أي رابط URL إلى markdown نظيف محسن لسياق LLM. يتعامل مع عرض JavaScript، يتجاوز الحواجز الشائعة، يدعم الزحف ورسم خرائط الموقع.
- **webapp-testing** — مجموعة أدوات مبنية على Playwright للتحقق من وظائف الواجهة الأمامية، تصحيح سلوك واجهة المستخدم، التقاط لقطات شاشة المتصفح، وعرض سجلات وحدة التحكم.

## السلامة والقيود

- **المواقع المصرح بها فقط** — أتمتة مواقع الويب التي لديك إذن صريح للوصول إليها فقط
- **الاحتياط لـ Captcha/2FA** — عند ظهور تحديات CAPTCHA أو 2FA أو مكافحة الروبوتات، يتوقف سير العمل للتدخل البشري. لا تحاول تجاوز الإجراءات الأمنية.
- **تغييرات هيكل الصفحة** — إذا تعطلت المحددات بسبب تحديثات الموقع، أعد تشغيل `browser-use state` لتحديث فهارس العناصر
- **تحديد المعدل** — احترم حدود معدل الموقع المستهدف؛ أضف فترات تأخير بين الطلبات عند الكشط

## نصائح

- اجمع مع **openclaw-automation-healthcheck** للوحات المراقبة الآلية
- استخدم `browser-use screenshot` في الخطوات الرئيسية لإنشاء سجلات تدقيق بصرية
- للاستخراج واسع النطاق، فضل **firecrawl** على browser-use لأنه يتعامل مع عرض JavaScript من جانب الخادم