SeekYou

استخبارات موحّدة للمضيفين عبر 15 مصدرًا — استعلم عن أي عنوان IP أو نطاق أو ASN للحصول على فوري حول الوضع الأمني وتفاصيل البنية التحتية وربط التهديدات. يعمل بالكامل على الطبقة المجانية من Cloudflare.

الموقع المباشر: swiy.co/seekyou``` $ curl "https://seekyou.seekyou.workers.dev/api/lookup?q=1.1.1.1"

{ "query": { "raw": "1.1.1.1", "type": "ip", "normalised": "1.1.1.1" }, "core": { "internetdb": { "status": "ok", "data": { "ports": [80,443], "vulns": [] } }, "geo": { "status": "cached", "data": { "country": "US", "org": "AS13335 Cloudflare" } }, "bgp": { "status": "ok", "data": { "name": "CLOUDFLARENET", "rir": "ARIN" } }, ... }, "meta": { "durationMs": 312, "cacheHits": 4, "sourcesQueried": 15, "sourcesFailed": 0 } }

## لقطات الشاشة

<div align="center">

### الصفحة الرئيسية
<img src="https://assets.kitploit.com/production/public/readmes/7467/e00ec4ba8b3e5460ae1e03360cf6540e58d92acc5522c8693445512b591fed29.png" alt="صفحة نتائج SeekYou" width="800" />


### صفحة النتائج
<img src="https://assets.kitploit.com/production/public/readmes/7467/09b165feca9927ad4cd50c3ebd28c72e09a0355d72b9ca14d795bf1d04448c92.png" alt="الصفحة الرئيسية لـ SeekYou" width="800" />

### عرض تجريبي
<a href="https://www.youtube.com/watch?v=b86tAUUqd34">
  <img src="https://assets.kitploit.com/production/public/readmes/7467/8762e8b464816b9a69d929514441f8c7ee9f9ee9719f95b9c5e33ac1672575f8.jpg" alt="عرض SeekYou التجريبي" width="800" />
</a>

</div>

---

## جدول المحتويات

- [SeekYou](#seekyou)
  - [لقطات الشاشة](#screenshots)
    - [الصفحة الرئيسية](#landing-page)
    - [صفحة النتائج](#results-page)
    - [عرض تجريبي](#demo)
  - [جدول المحتويات](#table-of-contents)
  - [ماذا يفعل SeekYou](#what-seekyou-does)
  - [حالات الاستخدام](#use-cases)
  - [سياسة الاستخدام القانوني](#lawful-use-policy)
  - [أدوات ذات صلة](#related-tools)
  - [نظرة عامة على البنية](#architecture-overview)
  - [نموذج التنفيذ](#execution-model)
  - [مصادر البيانات](#data-sources)
  - [هيكل المشروع](#project-structure)
  - [قرارات التصميم الرئيسية](#key-design-decisions)
    - [الحافة أولًا، بدون Node.js](#edge-first-no-nodejs)
    - [التنفيذ المتوازي متعدد الطبقات](#layered-parallel-execution)
    - [التدهور التدريجي الأنيق](#graceful-degradation)
    - [تخزين D1 + KV منفصل](#split-d1--kv-storage)
    - [تحسين الطبقة المجانية](#free-tier-optimization)
    - [كتابات D1 بدون انتظار (Fire-and-forget)](#fire-and-forget-d1-writes)
  - [استراتيجية التخزين المؤقت](#caching-strategy)
  - [تحديد المعدل](#rate-limiting)
  - [قواطع الدائرة](#circuit-breakers)
  - [تدوير المفاتيح — GrayHatWarfare](#key-rotation--grayhatwarfare)
  - [استمرارية D1](#d1-persistence)
    - [المخطط (`schema.sql`)](#schema-schemasql)
    - [تطبيق المخطط](#apply-schema)
    - [الدوال المساعدة](#helper-functions)
  - [عامل Cron](#cron-worker)
    - [الفرق المحدد الأنواع (`lib/diff.ts`)](#typed-diff-libdiffts)
    - [حمولة webhook](#webhook-payload)
  - [إعداد التطوير](#development-setup)
    - [المتطلبات الأساسية](#prerequisites)
    - [التطوير المحلي](#local-development)
    - [إنشاء موارد Cloudflare (لأول مرة)](#create-cloudflare-resources-first-time)
  - [النشر](#deployment)
    - [البناء والنشر](#build-and-deploy)
    - [إعداد Wrangler (`wrangler.toml`)](#wrangler-configuration-wranglertoml)
  - [الأسرار ومتغيرات البيئة](#secrets-and-environment-variables)
    - [الأسرار المطلوبة](#required-secrets)
    - [`.env.example` (للتطوير المحلي فقط)](#envexample-local-dev-only)
  - [الترخيص](#license)
  - [المؤلف](#author)
  - [شكر وتقدير](#acknowledgments)

---

## ماذا يفعل SeekYou

SeekYou هي **أداة استخبارات المضيفين** — ألصق عنوان IP أو اسم نطاق أو ASN واحصل على تقرير موحّد يغطي:

| الفئة | ما تحصل عليه |
|---|---|
| الشبكة | المنافذ المفتوحة، CPEs، بادئات BGP، الوصلات العلوية (upstreams)، النظراء (peers)، RIR |
| الهوية | تسجيل RDAP، جهات الاتصال، المسجّل (registrar)، خوادم الأسماء (nameservers) |
| الموقع الجغرافي | الدولة، المدينة، مزود خدمة الإنترنت ISP، مؤشرات proxy / استضافة / جوال |
| الشهادات | سجل crt.sh، قيم SANs، سلسلة المُصدِر |
| DNS | سجلات DNS السلبية، DNS عكسي/مباشر من Robtex |
| التهديدات | URLhaus، ThreatFox، MalwareBazaar، Feodo، SSLBL |
| CVEs | إثراء من NVD + CIRCL لكل معرّف CVE تُبلغ عنه InternetDB |
| الاستطلاع | دلاء GrayHatWarfare المكشوفة، لقطات Wayback CDX |

يتم الاستعلام عن كل مصدر بالتوازي. أي مصدر يفشل يتحوّل إلى شارة «غير متاح» — ولا يؤدي أبدًا إلى كسر الصفحة.

---

## حالات الاستخدام

**عمليات الأمان** — ملف تعريف سريع لعناوين IP المشبوهة من السجلات، وربط مؤشرات الاختراق IOCs، وتحديد الخدمات وCVEs المكشوفة، وتتبّع النطاقات الخبيثة.

**عمليات الشبكة** — فحص توجيه BGP، وبيانات تخصيص RDAP/WHOIS، وسجلات DNS التاريخية، وتغيّرات شهادات SSL.

**اختبار الاختراق** — تعداد المنافذ/الخدمات/CPEs، واكتشاف الدلاء المكشوفة، والصفحات المؤرشفة، والنطاقات الفرعية، وعلاقات ASN.

**استخبارات التهديدات** — فحص البنية التحتية لـ C2 مقابل خمس خلاصات تهديدات في استعلام واحد.

**الامتثال والمخاطر** — تحديد ملامح البنية التحتية للمورّدين، واكتشاف التخزين السحابي المكشوف، وتحديد تكنولوجيا المعلومات غير المصرح بها (shadow IT).

---

## سياسة الاستخدام القانوني

تم تصميم SeekYou من أجل **البحث الأمني القانوني، وعمليات الشبكة، واستخبارات التهديدات**. باستخدامك لهذه الأداة، فإنك توافق على ما يلي:

**الاستخدامات المسموحة:**
- عمليات الأمان والاستجابة للحوادث على الشبكات التي تملكها أو مخوّل بمراقبتها
- بحث استخبارات التهديدات وربط مؤشرات الاختراق IOC
- استكشاف أخطاء الشبكة وتدقيق البنية التحتية داخل مؤسستك
- اختبار الاختراق بتفويض كتابي صريح من المؤسسة المستهدفة
- البحث الأكاديمي والتعليم في مجال الأمن السيبراني
- تدقيقات الامتثال وتقييمات مخاطر المورّدين بالتفويض المناسب

**الاستخدامات المحظورة:**
- الوصول غير المصرح به، أو الاستطلاع، أو الهجمات ضد أنظمة لا تملكها أو ليس لديك إذن صريح لاختبارها
- التحرش، أو الملاحقة، أو انتهاكات الخصوصية ضد الأفراد أو المنظمات
- تسهيل الأنشطة غير القانونية بما في ذلك الاحتيال، أو سرقة الهوية، أو الجرائم الإلكترونية
- الالتفاف على ضوابط الأمان أو قيود الوصول دون تفويض
- انتهاك القوانين المعمول بها بما في ذلك قانون CFAA (الولايات المتحدة)، وقانون إساءة استخدام الحاسوب (المملكة المتحدة)، واللائحة العامة لحماية البيانات GDPR (الاتحاد الأوروبي)، أو التشريعات المكافئة في نطاق سلطتك القضائية

**مسؤولياتك:**
- تأكد من حصولك على التفويض المناسب قبل الاستعلام عن بنية تحتية لا تملكها
- احترم حدود المعدل ولا تسيء استخدام الخدمة أو مصادر البيانات العلوية
- امتثل لجميع القوانين واللوائح المعمول بها في نطاق سلطتك القضائية
- استخدم البيانات بمسؤولية ولا تسخّر النتائج كسلاح دون إفصاح منسّق
- افهم أن الاستعلام عن مضيف لا يمنحك إذنًا بالوصول إليه أو استغلاله

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

إذا اكتشفت ثغرة عبر SeekYou، فاتبع ممارسات الإفصاح المسؤول وأبلغ الطرف المتأثر قبل الإفصاح العلني.

---

## أدوات ذات صلة

SeekYou جزء من مجموعة أدوات أمنية تركّز على الخصوصية. استكشف المجموعة الكاملة: