الوصف   |   التثبيت   |   الموقع   |   الوحدات   |   المشكلات   |   الدعم

iKy

الوصف

iKy هي أداة OSINT تجمع المعلومات من عنوان بريد إلكتروني أو محددات أخرى وتعرض النتائج في واجهة مرئية.

التثبيت

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

• Docker
• Docker Compose (مضمن مع Docker Desktop)
• (اختياري) مشغل المهام just

بداية سريعة

git clone https://gitlab.com/kennbroorg/iKy.git
cd iKy
just build
just up

افتح متصفحك على http://localhost:4300

لإيقاف جميع الخدمات:

just down

just up يبدأ backend و iky-frontend و redis. لا يتم تشغيل أي خدمات أخرى بشكل افتراضي.

بدون Docker (محلي)

إذا لم تتمكن من تشغيل Docker، يمكن تشغيل iKy محلياً: Caddy يخدم الواجهة الأمامية المجمعة مسبقاً و Redis + Celery + Uvicorn تعمل كعمليات محلية. يتطلب redis-server و Python 3.12 و curl و tar على المضيف (يتم تنزيل Caddy تلقائياً).

just setup          # إنشاء البيئة الافتراضية
just up-native      # تثبيت التبعيات، تنزيل Caddy + الواجهة الأمامية، بدء كل شيء

افتح متصفحك على http://localhost:4300. أوقف التشغيل بـ Ctrl-C أو just down-native.

يتم سحب الواجهة الأمامية من أحدث إصدار على GitHub — لا حاجة لبناء Node. لا يتم تشغيل tor في الوضع المحلي؛ فقط وحدة darkweb تحتاجه.

الهيكلة

الوحدات

يقوم iKy بتوجيه 26 وحدة من خلال backend/module_registry.py:

مفاتيح API

بمجرد تحميل التطبيق في المتصفح، أدخل مفاتيح API الخاصة بك في لوحة الإعدادات. فيما يلي الجدول الكامل للحقول من backend/factories/apikeys_default.json:

واجهات API المميزة بـ 🍪 تستخدم كوكيز جلسة المتصفح؛ والباقي يستخدم رموز الخدمة.

كوكيز الجلسة

تتطلب بعض الوحدات (LinkedIn, Twitter, TikTok) كوكيز جلسة من متصفحك. يتم تخزين الكوكيز في backend/cookies/ (مركبة في الحاوية كـ /app/cookies) وتبقى عبر عمليات إعادة التشغيل. هناك طريقتان لتحميلها، كلاهما عبر just.

الكوكيز هي رموز جلسة شخصية: لا تشاركها أو تدرجها في المستودع (ملف backend/cookies/ مستثنى في git).

الخيار أ: استيراد تصدير من المتصفح

قم بتصدير كوكيز الموقع باستخدام إضافة مثل Cookie-Editor إلى ملف JSON واستيراده:

just cookies-import linkedin ~/Downloads/linkedin_cookies.json

الخيار ب: استخراجها تلقائياً من المتصفح

يستخرج الكوكيز مباشرة من متصفحك المحلي. أغلق المتصفح قبل التشغيل (المتصفح المفتوح يقفل قاعدة بيانات الكوكيز الخاصة به):

# جرب جميع المتصفحات المثبتة (firefox, chrome, brave, edge)
just cookies-grab linkedin linkedin.com

# أو متصفح محدد
just cookies-grab linkedin linkedin.com brave

يبلغ الأمر، متصفحاً بمتصفح، بما استطاع قراءته وما لم يستطع، ويكتب الملف فقط إذا وجد الكوكيز التي تحتاجها الوحدة. على سبيل المثال، LinkedIn تتطلب li_at و JSESSIONID.

تنتهي صلاحية الكوكيز بشكل دوري (كوكيز LinkedIn تستمر من شهر إلى 3 أشهر). عندما تتوقف وحدة عن المصادقة، قم بتشغيل الأمر مرة أخرى.

التطوير

يستخدم سير العمل للتطوير بيئة افتراضية للفحص/خطافات pre-commit و Docker (أو التدفق المحلي just up-native) لبناء وتشغيل التطبيق.

إعداد بيئة التطوير

قم بتثبيت just، ثم:

just setup
source .venv/bin/activate

ينشئ هذا بيئة افتراضية Python مع pre-commit و ruff، ويقوم بتثبيت خطافات git.

الوصفات الشائعة

تحديث iKy

اسحب أحدث التغييرات وأعد بناء صور Docker:

git pull
just rebuild

للحفاظ على مفاتيح API الخاصة بك عبر التحديثات، استخدم خيارات التصدير/الاستيراد في قائمة مفاتيح API بالواجهة الرسومية.

ويكيبيديا

• ويكي iKy

فيديو تجريبي

Vimeo

دعم المشروع

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

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

أي شخص يساهم أو ساهم في المشروع، بما في ذلك أنا، ليس مسؤولاً عن استخدام الأداة (لا الاستخدام القانوني ولا الاستخدام غير القانوني، ولا "الاستخدام الآخر").

ضع في اعتبارك أن هذه البرمجيات كُتبت في البداية كمزحة، ثم لأغراض تعليمية (لتعليم أنفسنا)، والآن الهدف هو التعاون مع المجتمع من خلال صنع برمجيات حرة عالية الجودة، وبينما الجودة ليست ممتازة (أحياناً ليست جيدة حتى) فإننا نسعى لتحقيق التميز.

ضع في اعتبارك أن جميع المعلومات التي يتم جمعها مجانية ومتاحة عبر الإنترنت، الأداة تحاول فقط اكتشافها وجمعها وعرضها. في كثير من الأحيان لا تستطيع الأداة حتى تحقيق هدفها في الاكتشاف والجمع. يرجى تحميل واجهات API اللازمة قبل أن تتذكر والدتي. إذا لم تظهر الأداة حتى مع واجهات API الأشياء "الجميلة" التي تتوقع رؤيتها، جرب بريداً إلكترونياً آخر قبل أن تتذكر والدتي. إذا كنت لا تزال لا ترى الأشياء "الجميلة" التي تتوقع رؤيتها، يمكنك إنشاء مشكلة، أو الاتصال بنا عبر البريد الإلكتروني أو عبر أي من شبكات التواصل الاجتماعي، لكن ضع في اعتبارك أن والدتي ليست المبدعة ولا تساهم في المشروع.

نحن لا نرد أموالك إذا كنت غير راضٍ. أتمنى أن تستمتع باستخدام الأداة بقدر ما نستمتع بصنعها. الجهد كان ولا يزال هائلاً (الوقت، المعرفة، البرمجة، الاختبارات، المراجعات، إلخ) لكننا سنفعلها مرة أخرى. لا تستخدم الأداة إذا لم تستطع قراءة التعليمات و/أو هذا الإخلاء بوضوح.

بالمناسبة، بالنسبة لأولئك الذين يصرون على تذكر والدتي، لقد توفيت منذ سنوات عديدة لكنني أحبها كما لو كانت هنا.