BIRDY-EDWARDS 2.0

تسلل وكشف

أداة استخبارات فيسبوك آلية مدعومة بالذكاء الاصطناعي لتحليل الأهداف، وتحليل الشبكات، وإعداد تقارير التهديدات. تعمل بالكامل على الجهاز عبر Ollama. منصة SOCMINT لفيسبوك مدعومة بالذكاء الاصطناعي — محلية 100%، بدون أي اعتماد على السحابة. للنسخة الخفيفة راجع هذا المستودع اضغط هنا

التثبيت · استكشاف الأخطاء وإصلاحها · إخلاء المسؤولية · المساهمة

التوثيق

أدلة الاستخدام الكاملة لوضعي التحقيق متاحة على الموقع الإلكتروني للمشروع:

• اضغط هنا

كيف يعمل

ما الجديد في الإصدار 2.0

• 🗽 المرونة — يمكنك الآن إيقاف التحقيق في أي مرحلة وإنشاء تقرير PDF
• 🎬 ذكاء الريلز — الذكاء الاصطناعي يستخرج ملخص السياق، والموضوع، والكيانات المسماة، والوسوم من كل تسمية توضيحية لريل
• 🔗 مصفوفة تنسيق المعلقين المشتركين — خريطة حرارية لمن يعلق بجانب من. انقر على أي خلية لرؤية المنشورات المشتركة
• 👤 كشف الوجوه الهجين HOG + CNN — اختيار النموذج تلقائيًا حسب حجم الصورة مع آلية احتياطية CNN→HOG. يعمل كشف الوجوه الآن على لقطات شاشة منشورات النصوص أيضًا
• 📬 إشعارات تيليجرام — إرسال تقرير PDF تلقائيًا إلى محادثة تيليجرام التي قمت بتكوينها عند الاكتمال
• 📄 حزمة PDF كاملة — إضافة أقسام ذكاء الصور، وذكاء الريلز، ومعرض الوجوه، والخط الزمني للمنشورات، وأزواج المعلقين المشتركين. تُعرض البنغالية والهندية والعربية والأردية بشكل صحيح
• ⚙️ قائمة انتظار التحقيقات — حتى 5 تحقيقات في قائمة الانتظار تُنفذ تلقائيًا بالتسلسل
• 🔄 صفحة تقدم فورية — عدادات إحصائية حية تُفتح مع وصول البيانات أثناء خط الأنابيب
• 📅 تعديل التاريخ والوقت — أثناء التجميع قد نجمع التاريخ فقط دون الطابع الزمني الدقيق، لذا كمحقق يمكنك الآن تعديله إلى طابع زمني دقيق.

الميزات

• 🔍 جمع الملف الشخصي — جمع آلي للبيانات من المنشورات والصور والريلز وبيانات "حول" والتعليقات وروابط وأسماء ملفات المعلقين مع استراتيجية استخراج التاريخ من 9 طرق
• 🗂️ تحقيق دفعة واحدة — إرسال حتى 10 روابط منشورات مختلطة وتشغيل خط أنابيب الذكاء الاصطناعي الكامل عليها جميعًا
• 🧠 ذكاء التفاعلات — تحليل الذكاء الاصطناعي للمشاعر والموقف والعاطفة واللغة لكل تفاعل في أكثر من 140 لغة بما فيها البنغالية والهندية والعربية والأردية والكوكي
• 📊 تقييم الفاعلين — درجة مركبة موزونة مع تصنيف من 5 مستويات. يتم جمع بيانات أفضل 14 ملفًا شخصيًا ثانويًا في الفحوصات المتوسطة والعميقة
• 🌍 كشف الدولة — LLM يحدد بلد المنشأ من إشارات الملف الشخصي مع شارة نسبة الثقة % وكشف عند الطلب لكل معلق
• 🔬 ذكاء الصور — رؤية LLM لكل صورة للمشهد والحشود والرموز والأسلحة وOCR وتقدير الموقع
• 🎬 ذكاء الريلز ومنشورات النصوص — الذكاء الاصطناعي يستخرج الكيانات والموضوعات وأنواع السرد ومؤشرات التهديد من التسميات التوضيحية والمنشورات
• 👤 ذكاء الوجوه — كشف هجين HOG + CNN، ترميز 128D، تجميع الهويات، تصور شجرة الوجوه D3
• 🕸️ رسوم الشبكات — رسم بياني تفاعلي D3 force، مصفوفة حرارية للمعلقين المشتركين مع منشورات مشتركة عند النقر، حواف مجموعات الألقاب
• 📄 تقارير PDF — تقرير استخباراتي كامل مع ذكاء الصور وذكاء الريلز ومعرض الوجوه والخط الزمني للمنشورات وتحليل المعلقين المشتركين وعرض النصوص متعددة اللغات
• 📬 تسليم تيليجرام — إرسال تقرير PDF تلقائيًا إلى المحادثة المكونة عند اكتمال التحقيق
• 🤖 ذكاء اصطناعي محلي — مدعوم بـ Ollama، نماذج gemma4:e2b / e4b / 12b وغيرها، يعمل على GPU أو CPU
• 🐳 جاهز لـ Docker — نشر بأمر واحد على لينكس وويندوز

⚠️ إخلاء المسؤولية

تم تطوير BIRDY-EDWARDS حصريًا لأغراض الاستخبارات المصرح بها، وإنفاذ القانون، والبحث الأكاديمي فقط.

نطاق الوصول إلى البيانات:

• تعمل هذه الأداة حصريًا باستخدام جلسة فيسبوك صالحة تمت مصادقتها بواسطة المشغل
• تصل فقط إلى بيانات الملف الشخصي والمنشورات والصور والريلز والتعليقات المرئية للعامة
• لا تصل إلى الرسائل الخاصة، أو الملفات المقفلة، أو المحتوى المقيد، أو أي بيانات غير مرئية لمستخدم مسجل الدخول
• لا تستخدم الروبوتات أو الحسابات المزيفة أو إنشاء حسابات آلي — يقدم المشغل جلسة المصادقة الخاصة به

المسؤولية القانونية:

• يجب استخدام هذه الأداة فقط على الملفات الشخصية والمحتوى حيث لديك تفويضًا قانونيًا صريحًا لجمع البيانات وتحليلها
• الاستخدام دون تفويض قد ينتهك شروط خدمة فيسبوك، وقوانين الخصوصية المعمول بها (GDPR، IT Act، DPDP Act)، واللوائح المحلية
• لا يتحمل المطور أي مسؤولية عن سوء الاستخدام، أو جمع البيانات غير المصرح به، أو أي ضرر ناتج عن الاستخدام غير السليم
• جميع التحقيقات هي المسؤولية الوحيدة للمشغل

باستخدامك BIRDY-EDWARDS، فأنت تؤكد أن استخدامك قانوني ومصرح به ومتوافق مع جميع القوانين المعمول بها في نطاق سلطتك القضائية.

متطلبات النظام

التثبيت

المتطلبات الأساسية

الخطوة 1 — تثبيت Docker

• لينكس: https://docs.docker.com/engine/install/ubuntu/
• ويندوز: https://docs.docker.com/desktop/install/windows-install/

الخطوة 2 — تثبيت Ollama

• لينكس:

curl -fsSL https://ollama.com/install.sh | sh

• ويندوز: قم بتنزيل المثبت من https://ollama.com/download

الخطوة 3 — تشغيل Ollama مرتبطًا بجميع الواجهات

• لينكس:

OLLAMA_HOST=0.0.0.0:11434 ollama serve

لجعل هذا دائمًا:

sudo systemctl edit ollama

أضف:

[Service]
Environment="OLLAMA_HOST=0.0.0.0:11434"

sudo systemctl daemon-reload && sudo systemctl restart ollama

• ويندوز: يستمع Ollama على جميع الواجهات افتراضيًا — لا حاجة لتكوين إضافي. إذا لم يكن كذلك،

$env:OLLAMA_HOST="0.0.0.0"
ollama serve

البدء السريع

الخطوة 1 — استنساخ المستودع

git clone https://github.com/jeet-ganguly/birdy-edwards.git
cd birdy-edwards

الخطوة 2 — إنشاء الملفات والمجلدات المطلوبة

• لينكس:

mkdir -p app/reports app/face_data app/post_screenshots app/status
touch app/fb_cookies.pkl app/socmint.db app/socmint_manual.db app/.ollama_model app/queue.db

• ويندوز (PowerShell):

New-Item -ItemType Directory app/reports, app/face_data, app/post_screenshots, app/status
New-Item -ItemType File app/fb_cookies.pkl, app/socmint.db, app/socmint_manual.db, app/.ollama_model

الخطوة 3 — بناء صورة Docker

⚠️ البناء الأول يستغرق 15–25 دقيقة — يتم تجميع dlib من المصدر. البنيات اللاحقة سريعة (الطبقات مخزنة مؤقتًا).

docker compose build

الخطوة 4 — تشغيل الحاوية

docker compose up -d

docker compose logs -f

الخطوة 5 — فتح واجهة الويب

http://localhost:5000

الخطوة 6 — استيراد ملفات تعريف الارتباط للجلسة

http://localhost:5000/tools/import-cookies

سحب نموذج ذكاء اصطناعي

اسحب نموذجًا على جهازك المضيف:

ollama pull gemma4:e2b

أو استخدم لوحة نماذج الذكاء الاصطناعي في واجهة الويب — حدد نموذجًا وانقر تطبيق وسحب.

إذا كنت تستخدم جهازًا افتراضيًا، اختر نموذجًا وفقًا للذاكرة المخصصة للجهاز الافتراضي.

استيراد ملفات تعريف الارتباط للجلسة

يتطلب BIRDY-EDWARDS جلسة فيسبوك صالحة. استخدم إضافة المتصفح Cookie-Editor — تعمل على جميع المنصات، بدون الحاجة إلى Selenium.

🔒 الأمن التشغيلي: يُنصح بشدة باستخدام حساب دمية مخصص للتحقيقات بدلاً من حسابك الشخصي على فيسبوك. هذا يحمي هويتك ويمنع تعليم حسابك الأساسي أو تقييده.

1. ثبّت Cookie-Editor → Chrome · Firefox
2. سجّل الدخول إلى حساب التحقيق المخصص الخاص بك على فيسبوك
3. انقر على Cookie-Editor أثناء وجودك على facebook.com
4. انقر تصدير ← تصدير كـ JSON
5. انتقل إلى http://localhost:5000/tools/import-cookies والصق

تكوين إشعارات تيليجرام

احصل على تقرير PDF الخاص بك مُسلَّمًا تلقائيًا بعد كل تحقيق.

1. أنشئ بوت تيليجرام عبر @BotFather وانسخ رمز البوت
2. احصل على معرف المحادثة الخاص بك — أرسل رسالة إلى بوتك ثم قم بزيارة https://api.telegram.org/bot<TOKEN>/getUpdates
3. انتقل إلى لوحة تيليجرام في واجهة الويب
4. الصق رمز البوت ومعرف المحادثة وانقر حفظ
5. انقر اختبار للتحقق من الاتصال

من هذه النقطة، يرسل كل تحقيق مكتمل تلقائيًا إشعارًا مع تقرير PDF مرفقًا.

كيف يمكنك المساعدة

إذا وجدت BIRDY-EDWARDS مفيدًا أو مثيرًا للاهتمام، إليك بعض الطرق لدعم المشروع:

• ⭐ قم بتمييز المستودع بنجمة — يساعد الآخرين على اكتشاف الأداة
• 🐛 أبلغ عن الأخطاء — افتح Issue إذا كان هناك شيء لا يعمل
• 🔧 ساهم — راجع قسم المساهمة للبدء
• 📢 شاركه — انشره في مجتمعات OSINT والمنتديات وX أو مع زملاء قد يجدونه مفيدًا
• 💬 قدم ملاحظات — الاقتراحات لميزات جديدة أو تحسينات مرحب بها دائمًا

كل مساهمة، كبيرة كانت أم صغيرة، تساعد في بناء أدوات أفضل لمجتمع OSINT واستخبارات التهديدات.

استكشاف الأخطاء وإصلاحها

Ollama غير قابل للوصول من Docker

docker exec -it birdy-edwards curl http://host.docker.internal:11434/api/tags

إذا فشل، أعد تشغيل Ollama مع OLLAMA_HOST=0.0.0.0:11434 ollama serve

خطأ في قاعدة البيانات: لا يوجد جدول من هذا القبيل أو خطأ آخر متعلق بقاعدة البيانات
ابدأ تحقيقًا جديدًا — يتم إنشاء المخطط تلقائيًا عند أول استخدام. إذا أوقفت العملية أثناء التحليل، احذف ذلك التحقيق وابدأ تحقيقًا جديدًا.

انتهت صلاحية ملفات تعريف الارتباط
انتقل إلى http://localhost:5000/tools/import-cookies وأعد استيراد ملفات تعريف ارتباط جديدة.

المنفذ 5000 قيد الاستخدام بالفعل
غيّر في docker-compose.yml: "5001:5000" ثم الوصول عبر http://localhost:5001

نفاد الذاكرة أثناء البناء
زد ذاكرة Docker Desktop إلى 8 جيجابايت+ عبر الإعدادات ← الموارد ← الذاكرة

الخريطة لا تُحمَّل
تتطلب بلاطات Leaflet + ArcGIS اتصالًا بالإنترنت على الجهاز المضيف. إذا كنت تعمل في بيئة معزولة تمامًا عن الشبكة، ستظهر حاوية الخريطة فارغة — جميع الميزات الأخرى تعمل بشكل طبيعي.

تيليجرام لا يرسل
تأكد من تشغيل بوتك بإرسال رسالة /start إليه. تحقق من صحة معرف المحادثة باستخدام رابط getUpdates. تأكد من أن المنفذ 443 غير محظور على شبكتك.

المساهمة

المساهمات مرحب بها. يرجى اتباع هذه الإرشادات للحفاظ على نظافة المشروع واتساقه.

الإبلاغ عن الأخطاء

• افتح Issue يصف الخطأ وخطوات إعادة الإنتاج وبيئتك (نظام التشغيل، الذاكرة، إصدار Docker)
• أرفق السجلات ذات الصلة من docker compose logs

طلبات الميزات

• افتح Issue مع وصف واضح للميزة وحالة استخدامها
• ناقش قبل فتح Pull Request للتغييرات الكبيرة

تقديم Pull Request

• انسخ المستودع (Fork)
• أنشئ فرع ميزة: git checkout -b feature/your-feature-name
• التزم بتغييراتك: git commit -m "Add: short description"
• ادفع إلى فرعك: git push origin feature/your-feature-name
• افتح Pull Request ضد main

إرشادات الكود

• اتبع نمط الكود الحالي — Python 3.12، اصطلاحات Flask
• اختبر تغييراتك محليًا عبر Docker قبل التقديم
• لا تلتزم بـ fb_cookies.pkl أو قواعد البيانات أو أي بيانات مجمعة
• حافظ على تغييرات أداة التجميع في حدها الأدنى — يتغير DOM في فيسبوك بشكل متكرر

ما نرحب به

• إصلاحات الأخطاء وتحسينات الاستقرار
• دعم نماذج Ollama جديدة
• تحسينات واجهة المستخدم
• تحسينات التوثيق
• دعم لغات إضافية لـ OCR وتحليل التعليقات

ما لا نقبله

• ميزات تتجاوز ضوابط أمان المنصة
• تغييرات تُدخل اعتماديات سحابية
• كود يخزن أو ينقل بيانات التحقيق خارجيًا

شكر وتقدير

• مستوحى من Sherlock
• مستوحى من مجتمع أبحاث OSINT واستخبارات التهديدات
• SeleniumBase — أتمتة Chrome غير المكتشفة
• Ollama — محرك استدلال LLM المحلي
• face_recognition — مكتبة كشف الوجوه وترميزها
• Leaflet — مكتبة الخرائط التفاعلية
• ArcGIS — بلاطات الخرائط بحدود دستورية صحيحة
• pyvis — تصور الرسوم البيانية للشبكات التفاعلية
• reportlab — إنشاء PDF
• pytesseract — غلاف محرك OCR
• D3.js — تصور البيانات والرسوم البيانية التفاعلية