Coeus CI

ذكاء تنافسي يرى كل شيء.

سُميَ باسم Coeus (سي-أَس)، عملاق العيون المئة من عمالقة اليونان ذو العقل الفضولي — واسمه يعني حرفيًا "الاستفسار". CI ترمز إلى الذكاء التنافسي (Competitive Intelligence).

أداة OSINT للذكاء التجاري تبني ملفات تعريف للشركات من مصادر بيانات عامة مجانية. أدخل نطاقًا — واحصل على تقرير مُسجَّل يغطي الاستقرار، النمو، النضج التقني، الصحة المالية، الوضع الأمني، والشفافية.

بداية سريعة

# Clone and install
git clone https://github.com/Opfour/coeus-ci.git
cd coeus-ci
./setup.sh          # creates venv, installs everything

# Activate the environment
source venv/bin/activate

# Run a scan
coeus apple.com

# Compare companies
coeus apple.com microsoft.com

# Export HTML report
coeus apple.com --html

# Launch web dashboard
coeus --web

الاستخدام

coeus [OPTIONS] [TARGETS]...

Options:
  --json                 إخراج بصيغة JSON
  --html                 حفظ تقرير HTML في ./reports/
  -m, --modules TEXT     قائمة وحدات مفصولة بفواصل (مثال: whois,dns,edgar)
  -t, --timeout INTEGER  مهلة الوحدة بالثواني (الافتراضي: 30)
  --web                  تشغيل لوحة التحكم التفاعلية
  --port INTEGER         منفذ لوحة التحكم (الافتراضي: 8147)
  --help                 عرض هذه الرسالة والخروج

أمثلة

# Single target
coeus acme.com

# JSON output (pipe to jq, save to file, etc.)
coeus acme.com --json

# Run only specific modules
coeus acme.com --modules whois,dns,ssl

# Side-by-side comparison
coeus apple.com microsoft.com

# HTML report saved to ./reports/
coeus apple.com --html

# Web dashboard on default port
coeus --web

# Web dashboard on custom port
coeus --web --port 9090

الإعدادات

يتم تعريف الإعدادات الافتراضية في مكان واحد لتعديلها بسهولة:

coeus/__init__.py

DEFAULT_WEB_PORT = 8147          # --port: منفذ لوحة التحكم
DEFAULT_TIMEOUT = 30             # --timeout: مهلة الوحدة (ثوانٍ)
DEFAULT_HOST = "127.0.0.1"      # عنوان الربط للوحة التحكم

قم بتغيير هذه القيم لتعيين افتراضيات جديدة لبيئتك. العلامات CLI (--port, --timeout) تتجاوز هذه القيم لكل تشغيل على حدة.

مصادر البيانات (v0.1)

جميع الوحدات مجانية ولا تتطلب مفتاح API.

التسجيل

يتم تسجيل كل هدف عبر ستة أبعاد (0-10):

صيغ الإخراج

• الطرفية — بطاقة تقييم بتنسيق غني بأشرطة ملونة ونتائج وتفاصيل الوحدات
• JSON (--json) — تفريغ كامل لنموذج Pydantic للأنابيب أو التكامل
• HTML (--html) — تقرير مستقل ذو سمة داكنة محفوظ في ./reports/
• لوحة التحكم (--web) — واجهة متصفح تفاعلية مع تقدم المسح المباشر

البنية المعمارية

coeus-ci/
├── coeus/
│   ├── __init__.py          # الإصدار + الإعدادات القابلة للتخصيص (المنفذ، المهلة، المضيف)
│   ├── __main__.py          # entry python -m coeus
│   ├── cli.py               # واجهة Click مع وضع المقارنة
│   ├── core.py              # المنسق غير المتزامن ذو الموجتين
│   ├── models.py            # نماذج بيانات Pydantic
│   ├── scorer.py            # محرك التسجيل الموزون
│   ├── report.py            # منسقات الطرفية، JSON، HTML
│   ├── matching.py          # مطابقة أسماء الشركات الضبابية
│   ├── web.py               # خادم لوحة التحكم aiohttp
│   └── modules/
│       ├── base.py          # الفئة الأساسية ABC للوحدات
│       ├── whois_mod.py     # بحث WHOIS
│       ├── dns_mod.py       # تحليل DNS
│       ├── headers.py       # تحليل رأس HTTP
│       ├── ssl_mod.py       # فحص شهادة TLS
│       ├── tech.py          # كشف التقنيات
│       ├── edgar.py         # إيداعات SEC EDGAR
│       ├── nonprofit.py     # 501(c)(3) / ProPublica
│       └── dba.py           # DBA / OpenCorporates
├── templates/
│   ├── dashboard.html       # SPA لوحة التحكم
│   └── report.html          # قالب تقرير HTML (Jinja2)
├── setup.sh                 # سكريبت الإعداد لمرة واحدة
├── pyproject.toml           # تغليف Python
├── LICENSE                  # AGPL-3.0
└── README.md

كيف يعمل

1. الموجة 1 — يتم تشغيل WHOIS و SSL أولاً لتحديد اسم الشركة
2. الموجة 2 — يتم تشغيل جميع الوحدات الأخرى بالتوازي باستخدام اسم الشركة من الموجة 1
3. التسجيل — تساهم كل وحدة بنتائج موزونة في الأبعاد الستة
4. التقرير — يتم تجميع النتائج في تقرير واحد مسجّل

الأسئلة الشائعة

كيف أغير منفذ لوحة التحكم الافتراضي؟

قم بتحرير coeus/__init__.py وتغيير DEFAULT_WEB_PORT، أو استخدم العلم --port:

coeus --web --port 9090

كيف أغير المهلة الافتراضية؟

قم بتحرير coeus/__init__.py وتغيير DEFAULT_TIMEOUT، أو استخدم العلم --timeout:

coeus apple.com --timeout 60

هل أحتاج إلى أي مفاتيح API؟

لا. جميع وحدات v0.1 تستخدم مصادر بيانات عامة مجانية ولا تتطلب مفاتيح API.

لماذا يظهر EDGAR 0.0 لبعض الشركات؟

وحدة EDGAR تجد البيانات فقط للشركات العامة المسجلة لدى SEC. الشركات الخاصة والمنظمات غير الربحية والكيانات الأجنبية لن يكون لها بيانات EDGAR — هذا متوقع وليس خطأ.

لماذا تتطابق وحدة المنظمات غير الربحية أحيانًا مع المنظمة الخاطئة؟

أسماء الشركات الشائعة (مثل "Apple") قد تتطابق مع منظمات غير ربحية صغيرة ذات أسماء مشابهة. المطابقة الضبابية تقلل من النتائج الإيجابية الزائفة لكن الأسماء العامة جدًا غامضة بطبيعتها. يسمح لك العلم --modules بتخطي الوحدات غير ذات الصلة.

هل يمكنني تشغيل وحدات محددة فقط؟

نعم:

coeus apple.com --modules whois,dns,ssl

كيف أضيف وحدة جديدة؟

1. أنشئ ملفًا جديدًا في coeus/modules/ يمدد BaseModule
2. نفذ طريقة execute(target, context)
3. سجّلها في coeus/modules/__init__.py

خارطة الطريق

v0.1 — الأساس (حاليًا)

• خط أنابيب استخباراتي من 8 وحدات (whois, dns, headers, ssl, tech, edgar, nonprofit, dba)
• محرك تسجيل بستة أبعاد
• إخراج طرفية، JSON، HTML
• لوحة تحكم ويب مع تقدم المسح المباشر
• وضع المقارنة لأهداف متعددة
• مطابقة أسماء الشركات الضبابية

v0.2 — التوسع

• طبقة تخزين مؤقت (لا تعيد الجلب خلال 24 ساعة)
• وضع الدفعة (coeus --file targets.txt)
• منطق تحديد المعدل وإعادة المحاولة
• تكامل مفتاح API لمصادر البيانات المميزة
• وحدات Hunter.io، BuiltWith، Crunchbase، GitHub، Shodan

v0.3 — التحسين

• تصدير تقرير PDF
• تتبع تاريخي (مقارنة المسوحات عبر الزمن)
• نظام إضافات لوحدات المجتمع
• تكامل CI/CD (رموز خروج بناءً على حدود النتائج)

الترخيص

AGPL-3.0 — انظر LICENSE للتفاصيل.