عن المشروع

invisible_playwright_mcp هو خادم Python MCP ذاتي الاستضافة يتيح لمساعد الذكاء الاصطناعي التحكم في متصفح حقيقي. وهو مبني على محرك Firefox متخفٍ مضاد للكشف، بحيث يستطيع الوكيل تصفح صفحات كانت سترفض العملاء الآليين. طريقتان لاستخدامه: 1. عبر MCP من مساعد. ثبّت uv، ثم أضف الإضافة إلى Claude Code أو Codex أو Gemini CLI عبر أوامر السوق/الإضافات الموثقة. الحزمة نفسها هي خادم MCP عند تشغيلها دون أمر فرعي. 2. واجهة ويب مستقلة. شغّل `uvx invisible-playwright-mcp ui --openrouter-key ...` وافتح http://127.0.0.1:8765. تظهر المحادثة على اليسار، وعرض مباشر للمتصفح على اليمين. تتطلب مفتاح OpenRouter وتستخدم افتراضياً النموذج z-ai/glm-5.3-flash. يقود الوكيل الصفحات كما يفعل الإنسان: تحريك المؤشر والضغط على المفاتيح بدلاً من استدعاء واجهات برمجية فقط. المثال في README هو مهمة بحث عن رحلات طيران حيث يجب على الوكيل النقر على أيام التقويم واحداً تلو الآخر وقراءة الأسعار دون تخمين. تشمل خيارات الإعداد: - --openrouter-key أو OPENROUTER_API_KEY - --model أو INVISIBLE_MCP_MODEL - --proxy (http أو socks5، مع ضرورة تحديد المضيف والمنفذ؛ المنطقة الزمنية واللغة ونقطة الخروج تتبع الوكيل) - --binary لبناء محرك موجود، ويجب أن يطابق الإصدار المثبت - --seed لهوية متصفح قابلة لإعادة الإنتاج - --profile-dir لحفظ تسجيلات الدخول وملفات تعريف الارتباط - --headed لإظهار نافذة المتصفح - --host و --port (الافتراضي 127.0.0.1:8765؛ تغيير المضيف يعرض واجهة غير مصادق عليها) يمكن لملف .env في الدليل الحالي أن يحتوي على OPENROUTER_API_KEY و STEALTHFOX_BINARY. الأولوية: العلم، ثم متغير البيئة، ثم .env، ثم الافتراضي؛ يُقرأ الدليل الحالي فقط، ولا تُطبع القيم عند بدء التشغيل. مشاريع ذات صلة في العائلة نفسها: invisible_playwright (المحرك كمكتبة Python بواجهة برمجية بأسلوب Playwright) و invisible_core (البذرة لإنشاء البصمة والتفضيلات والوكيل والموقع الجغرافي). ملاحظات الخصوصية من README: يعمل الوكيل محلياً دون خادم يديره المؤلف. ترى المواقع التي تزورها متصفح Firefox عادياً؛ يتلقى مزود النموذج المحادثة ومحتوى الصفحة؛ يُتصل بـ GitHub لتنزيل المحرك، وقاعدة بيانات GeoIP عند تعيين وكيل، وعداد إطلاق من سطر واحد. تبقى الجلسات والملفات الشخصية ولقطات الشاشة محلية تحت INVISIBLE_MCP_HOME أو دليل بيانات التطبيقات في النظام. المشروع مرخص بموجب MIT، مع بقاء الإصدارات السابقة لـ 2 سبتمبر 2026 بموجب AGPL-3.0. يطلب README أيضاً من المستخدمين احترام شروط المواقع وحدود المعدل.