شنو كيدير GEOInflow
GEOInflow هو منصّة تحليلات مستضافة ذاتياً لتحسين الظهور فالمحرّكات التوليدية، أو GEO. كيجمع نشاط المتصفّح، والإحالات من بحث الذكاء الاصطناعي، وسجلات الزحف ديال الخادم أو CDN، وجرد المحتوى داخل سياق مشترك ديال الموقع.
المنصّة كتعاون تجاوب على أسئلة عملية: شنو هما زواحف الذكاء الاصطناعي اللي كيزورو الموقع ديالك؟ شنو هي المسارات اللي كيطلبوها؟ واش الطلبات كتنّجح؟ شنو هي الصفحات المهمة اللي ما تسجلاتش عليها حتى أنشطة زحف؟ وشحال من زيارة وشحال من تحويلة كتوصل عبر إحالات بحث الذكاء الاصطناعي المدعومة؟
GEOInflow مناسب لمواقع الشركات، والناشرين الإعلاميين، ومواقع المحتوى، ووثائق المطوّرين، والفرق اللي كيدبّرو بزاف ديال المواقع. الكود المصدري ديال التطبيق منشور بموجب رخصة MIT. ملف README كيوصف إصدار المنتج v1.2 وإصدار البناء 1.2.0.
سجلات الزحف كتبرهن على الولوج اللي تلاحظ فعلاً. ولكن بوحدها ما كتثبتش الفهرسة، ولا تدريب النماذج، ولا الاستشهادات فالأجوبة، ولا ترتيب التوصيات، ولا اكتساب الزبناء.
القدرات الرئيسية
هوية زواحف الذكاء الاصطناعي والهدف ديالها
الكتالوغ المدمج كيغطي مزوّدين من بينهم OpenAI وAnthropic وPerplexity وGoogle وMicrosoft وByteDance وBaidu وKimi وTencent Hunyuan. وكيحتافظ حتى بالملاحظات ديال زواحف البحث التقليدية والبوتات الأخرى.
المنصّات والمنتجات وهويات الطلبات والأهداف وأنواع المنتجات ممثّلة بشكل منفصل. هاد الشي كيخلّي النظام يميّز بين مفاهيم بحال التدريب، وبحث الذكاء الاصطناعي، والولوج اللي كيطلّبو المستخدم، وورشات الذكاء الاصطناعي، والوكلاء الشخصيين، بلا ما يعتبرهم متنافيين.
حتى أدلّة الهوية كتتحافظ بشكل منفصل. يمكن مقارنة User-Agent المصرّح به مع نطاقات IP الرسمية ومع معطيات DNS المتاحة أو الأدلة الموثوقة من الحافة. ادّعاء User-Agent بوحدو ما كيتعتبرش تأكيداً، والسجلات التاريخية اللي ما فيهاش أدلة كافية كاتبقى معلّمة كمجهولة.
نشاط الزحف وتغطية المحتوى
تقدر تراجع ترتيب الصفحات المطلوبة، والطلبات المتكررة، والصفحات اللي تلاحظ الولوج ليها، وتوزيع المجلدات، والزواحف الرئيسية، والنشاط الحديث، وحداثة المحتوى. استيراد sitemap أو ملف CSV أو جرد JSON كيوفّر مجموعة معروفة ديال الصفحات اللي يمكن تقارنها مع سجلات الزحف الملاحظة.
هاد المقارنة كتكشف الصفحات اللي تلاحظ الولوج ليها، وكذلك النقاط العمياء المحتملة ديال الذكاء الاصطناعي. الفلاتر ديال الهوية والهدف ونوع المنتج كتتطبّق قبل التجميع وتقسيم الصفحات، وبهذا البطاقات والجداول والمقارنات والتصديرات كيستعملو نفس الشروط.
تشخيص الطلبات وسياسات الولوج
GEOInflow كيعرض استجابات HTTP، والطرق بحال GET وHEAD، وسلوك التخزين المؤقت، وزمن الاستجابة، وحجم الاستجابة، واستمرارية الجمع، ونتائج المخاطر كأدلة منفصلة. الفرق تقدر تزيد حالات المعالجة والملاحظات، وتأجّل التحقيقات، وترجع تكملها من بعد.
المنصّة تقدر تصدّر إعدادات robots وNginx للولوج. ضوابط Cloudflare المدعومة كتحتاج بيانات اعتماد منفصلة ديال Zone، ومعاينة، وتأكيد صريح، وتنفيذ فخلفية النظام، والتحقق من الحالة البعيدة الناتجة. الضوابط المتاحة كتختلف حسب البيئة المنشورة، وخطة المزوّد، والصلاحيات الممنوحة.
تحليلات الموقع والتحويلات
- مشاهدات الصفحات، والزوار، والزيارات، والإحالات، والموقع الجغرافي، والأجهزة، والمتصفحات، وأداء المحتوى
- الأحداث المخصّصة، والأهداف، والمسارات التحويلية، ومسارات الزوار، والإسناد، وتحليل المداخيل
- محرّكات البحث، وكلمات الإحالة، وتحليل UTM، والأداء، والخرائط الحرارية، والاحتفاظ، والجماهير
- أدوات الموقع، والفريق، ومساحة العمل، ولوحة المعلومات، والصلاحيات، والمشاركة العمومية
- تصديرات CSV وJSON وZIP للنطاق المحدد
- مساعدة اختيارية بالذكاء الاصطناعي مبنية على معطيات الموقع، وموقوفة افتراضياً
التتبّع عبر المتصفّح كيتعرّف على إحالات بحث الذكاء الاصطناعي المدعومة وكيجمعها مع الصفحات الهابطة، والأحداث، والأهداف، والتحويلات. طلبات الزحف، وجلسات الإحالة، والتحويلات كاتبقى قياسات منفصلة، والمقارنات بين المصادر كاتبقى عندها حدودها.
فهم تدفّق البيانات
GEOInflow كيتقبّل ثلاثة أنواع رئيسية ديال المدخلات:
- التتبّع عبر المتصفّح: كيجمع مشاهدات الصفحات، والأحداث، وأي بيانات موسّعة مفعّلة من المتصفّح.
- سجلات الخادم أو CDN: كيلتقط طلبات الزحف اللي ما كتنفّذش سكريبتات المتصفّح.
- جرد المحتوى: كيستورد سجلات sitemap أو CSV أو JSON باش يحدّد الصفحات اللي خاص تقييم تغطيتها.
واجهات التطبيق وواجهات الإدخال كتكتب البيانات فـ PostgreSQL. خدامات السجلات والتحليلات كتعالج السجلات، بينما Redis كيدعم التقارير المخزّنة مؤقتاً. التقارير والنتائج المنشورة كتشغّل من بعد تحليلات GEO والزوار والمحتوى، وكذلك المشاركة والتصديرات اللي كتتحكّم فيها الصلاحيات.
كل مصدر يقدر يتربط بشكل مستقل. إلا كان شي مصدر غايب، خاص التحليل المعني يبيّن هاد المحدودية، وما يعتبرش المدخلات الناقصة نتيجة سلبية بشكل صامت.
المتطلبات المسبقة للنشر السريع
قبل ما تبدا، ثبّت وشغّل Docker Engine أو Docker Desktop مع Docker Compose V2. تأكد باللي الجهاز يقدر يوصل لمصادر تحميل الصور والتبعيات المطلوبة أثناء البناء.
جيب الكود المصدري ديال GEOInflow، حلّ الطرفية، وسير لجذر المستودع. التثبيتات الإنتاجية كتحتاج زيادة على ذلك نطاقاً، وHTTPS، ووكيل عكسي موثوق.
نشر GEOInflow باستعمال Docker
شغّل سكريبت النشر
من جذر المشروع، نفّذ:
sh scripts/liekan-deploy.shالسكريبت كينشئ ملف .env خاص وأسرار عشوائية، وكيبني صورة التطبيق، وكيطبّق عمليات الترحيل، وكيشغّل المكوّنات التالية:
- تطبيق GEOInflow
- عامل السجلات
- عامل التحليلات
- PostgreSQL
- Redis
فتح التطبيق
العنوان المحلي الافتراضي هو:
http://127.0.0.1:3002فالتثبيت الجديد، دخل باستعمال بيانات الاعتماد الأولية:
- سمية المستخدم:
admin - كلمة السر:
liekan
بدّل كلمة السر الأولية مباشرة من بعد ما تدخل. الترقيات الجاية كتحافظ على الحسابات وكلمات السر اللي تخصصات.
حمّل المثال المرفق
باش تستكشف الواجهة قبل ما تربط موقع خدام، عمّر مجموعة البيانات المعالجة اللي مرفقة:
docker compose -f docker-compose.liekan.yml exec app node scripts/liekan-seed-demo.mjsالموقع المثال سميتو 猎看官网（示例数据）. فالأول استيراد، التوقيتات كيتبدلو باش يكون تفقد مجموعة البيانات ساهل. التشغيلات المتكررة كتحافظ على البيانات الموجودة وحالة الحذف.
ربط أول موقع ديالك
من بعد ما تأمّن حساب المسؤول، صايب موقع فـ GEOInflow وربط مصادر البيانات المناسبة للتنصيب ديالك. شوف دليل البداية السريعة ديال المشروع باش تعرف بالضبط كيفاش كيتجمعو البيانات.
الخطوة 1: زيد تتبع المتصفح
ركّب سكريبت تتبع المتصفح باش تجمع مشاهدات الصفحات، الأحداث، والقياسات الإضافية المفعّلة. التتبع بلا كوكيز مفعّل افتراضيا. التسجيل، خصائص الأحداث، والتكاملات التجارية كيعتمدو على نطاق البيانات اللي حدده المشغّل.
جمع مشاهدات الصفحات من المتصفح يقدر يستمر بلا دخول موثوق لعناوين IP. ولكن المقاييس الحساسة للهوية، بحال الزوار الفريدين، كتحتاج دليل موثوق على الدخول، لذلك خصك تضبط البروكسي العكسي مزيان فالإنتاج.
الخطوة 2: ربط سجلات الخادم أو CDN
سكريبتات المتصفح ما كتقدرش تشوف البوتات اللي كتطلب غير الوثائق من الخادم. زيد سجلات الخادم أو CDN باش تقيس وصول الزواحف، مسارات الطلبات، رموز الاستجابة، الطرق، التأخير، التخزين المؤقت، والأعطاب.
الجمع التلقائي من الخادم كيتطلب HTTPS عمومي، سر ديال الإدخال، وملفات تثبيت موقعة. إلا استعملتي تكامل Cloudflare، غتحتاج حتى OAuth، الصلاحيات المناسبة، ودعم المزوّد للقدرات المطلوبة.
الخطوة 3: استورد جرد المحتوى
استورد sitemap، ملف CSV، أو جرد JSON فيه الصفحات اللي كتتوقع الزواحف تكتشفها. GEOInflow يقدر يقارن هاد الجرد المعروف مع سجلات الخادم المرصودة باش يحسب تغطية الزحف ويحدد الصفحات اللي ما تسجل حتى نشاط عليها.
اعتبر الصفحة غير المغطاة نقطة انطلاق للتحقيق، وماشي دليل على الاستبعاد. راجع نقاط الدخول، الروابط الداخلية، توجيهات robots، استجابات HTTP، وواش جمع السجلات غطى الفترة المعنية.
سير العمل الأساسي للتحليل
عرف شنوما منصات الذكاء الاصطناعي اللي كيزورو الموقع
- اختار الموقع والفترة الزمنية.
- حل قسم تحليلات الزواحف.
- راجع هوية الزاحف، المزوّد، الغرض، حجم الطلبات، حالة التحقق، والتوجهات.
- استعمل فلاتر الهوية، الغرض، ونوع المنتج باش تضيق مجموعة البيانات.
- تفقد الأدلة اللي كتدعم كل هوية، وما تعتمدش غير على User-Agent ديالها.
هاد السيرورة كتعاون تميّز بين زواحف التدريب، طلبات البحث بالذكاء الاصطناعي، والولوج اللي بدا من طرف المستخدم، فالحالات اللي الكتالوج والأدلة المتاحة كيدعمو هاد التصنيف.
حدد المسارات اللي كيتزحفو بزاف والمسارات اللي ممكن تكون غير صالحة
- راجع ترتيب الصفحات المطلوبة والطلبات المتكررة.
- قارن النشاط حسب المجلد والزاحف.
- تفقد النشاط الأخير وحداثة المحتوى.
- قلب على روابط مشوهة، قديمة، أو كتتطلب بشكل مفاجئ بزاف.
- راجع حالة HTTP ديالها، سلوك التخزين المؤقت، التأخير، وحجم الاستجابة.
الطلبات المتكررة تقدر تكشف على محتوى مهم، سلوك غير فعّال ديال الزاحف، تحويلات، صفحات ناقصة، أو مشاكل هيكلية. فسّر كل نمط مع أدلة الاستجابة المرتبطة به.
قيس تغطية المحتوى
- استورد جرد المحتوى الحالي.
- اختار نفس الموقع، الفترة الزمنية، وفيلتر الزاحف.
- قارن صفحات الجرد مع المسارات المرصودة فالسجلات.
- راجع الصفحات اللي ما تسجل حتى وصول عليها.
- حقق فإمكانية الاكتشاف، السياسات، الاستجابات، واستمرارية المصدر.
البطاقات، الجداول، المقارنات، والتصديرات كيتقاسمو شروط الفلترة المختارة. ملاحظات المسارات المستنتجة والنتائج المقدرة كيبقاو محتافظين بالتسميات ديالهم، وهادشي كيساعد المستخدمين يميّزو بين الاستنتاجات المحسوبة والأدلة المباشرة.
حلل نتائج الإحالات من الذكاء الاصطناعي
- فعّل تتبع المتصفح للموقع.
- راجع جلسات الإحالة من الذكاء الاصطناعي اللي تم التعرف عليها وصفحات الوصول.
- حدد الأحداث، الأهداف، أو التحويلات اللي عندها علاقة.
- قارن حركة الإحالة مع النتائج اللاحقة.
- خلي طلبات الزواحف وجلسات الإحالة منفصلين ملي كتقدم النتائج.
طلب الزاحف ما كيثبتش أن الصفحة بانت فجواب ديال الذكاء الاصطناعي. وبالمثل، جلسة إحالة من الذكاء الاصطناعي ما كاتثبتش كيفاش النموذج اختار الصفحة أو استشهد بها. حافظ على هاد الفروقات فلوحات المعلومات والتقارير المصدّرة.
الفترات الزمنية، المناطق الزمنية، وسلوك التحديث
الفترات الزمنية الرئيسية هي اليوم، 7 أيام، و30 يوم. المنطقة الزمنية الافتراضية للتحليلات هي Asia/Shanghai. فالأول تسجيل دخول كامل، التطبيق كيتأكد من المنطقة الزمنية ديال البلد والمدينة. فالطلبات اللاحقة، كيستعمل المنطقة الزمنية المحفوظة فالحساب باش يحدد اليوم.
الزوار الآنيون كيغطي آخر 30 دقيقة. تحليل الاحتفاظ كيستعمل الشهور التقويمية. لوحات اليوم الرئيسية كتقرا النتائج المنشورة كل 30 ثانية وكتعرض آخر وقت فعلي للبيانات. التحديث كيتوقف ملي الصفحة كتكون مخبية أو بلا اتصال، بينما الآني والتحليلات الثقيلة عندهم جداول التحديث الخاصة بهم.
نصائح متقدمة للتشغيل
تفقد تسريع التحليلات
GEOInflow كيستعمل التجميع المسبق، حقائق الزيارات الدقيقة، النتائج الدائمة، وطبقات متعددة للتخزين باش ينقص من الحسابات المتكررة. الفترات الشائعة تقدر تكون مهيأة مسبقا، والنتائج المنشورة كتبقى متاحة بينما كتخدم التحديثات فالخلفية.
من بعد النشر، استعمل صفحة تسريع التحليلات باش تفحص المهام والتغطية. الحسابات الأولية، وضربات الكاش، والتحديثات فالخلفية عندها تكاليف مختلفة. الأداء الفعلي كيعتمد على حجم البيانات، وبناء المخزون، وأداء PostgreSQL، وحالة الكاش.
حافظ على صحة العمال
عمال السجلات والتحليلات ضروريين لمعالجة الإدخال ونشر النتائج. إلا حبسات التقارير على التحديث، تفقد حالة العمال، والطوابير، واستمرارية المصادر، وصحة قاعدة البيانات، وRedis قبل ما تفسر لوحة فارغة على أنها قلة فالنشاط.
إجراءات حماية السعة تقدر تحيد النوافذ القديمة، والمهام الفاشلة والخاملة تقدر توقف المحاولات التلقائية من جديد. المهام الدائمة فالخلفية كتخلي الحسابات الأولية تكمل بلا ما تبقى جلسة المتصفح محلولة.
حافظ على حدود المصدر والدليل
- ما تعتبرش ادعاء User-Agent هوية موثقة ديال الزاحف.
- ما تعتبرش غياب النشاط فالسجلات دليل على أن الزاحف عمره دخل للصفحة، إلا كانت التغطية ديال الجمع كاملة.
- ما تساويش بين دخول الزاحف والفهرسة، أو التدريب، أو الاستشهاد، أو الترتيب، أو الاكتساب.
- خلي التكاملات الناقصة، ومجموعات البيانات الفارغة، والقيم المجهولة، والتقديرات، والقدرات غير المدعومة حالات متميزة.
- قارن النتائج غير إلا كانت النطاقات الزمنية، وتغطية المصادر، والمرشحات، وإصدارات القواعد متوافقة.
استعمل ضوابط الولوج بحذر
عاين تغييرات robots أو Nginx أو Cloudflare المدعومة والمولدة قبل التطبيق. عمليات Cloudflare كتحتاج تأكيد صريح، ومن بعد خاص تقرا الحالة البعيدة من جديد. تحقق من خطة المزوّد والصلاحيات فالبيئة المنشورة فعلياً.
خطط للبنية التحتية ديال الإنتاج
استعمل نطاق، وHTTPS، ووكيل عكسي موثوق للولوج فالإنتاج. دير نسخ احتياطية لـ PostgreSQL وحمي .env الخاص، وأسرار الإدخال، وبيانات اعتماد الحسابات، والمفاتيح الخاصة، وأي قاعدة بيانات جغرافية موفرة بشكل خاص. راجع دليل النشر باش تلقى تفاصيل الوكيل العكسي، والنسخ الاحتياطي، والخدمات، والإعدادات، والترقية.
فعّل ميزات الذكاء الاصطناعي غير ملي تحتاجها
تحليلات الموقع الأساسية والتعرف على الزواحف ما كيحتاجوش مفتاح API ديال نموذج. تحليل الذكاء الاصطناعي معطل افتراضياً. ملي كتفعّلو، المستخدمين كيختارو اتصالات النماذج ومواد الموقع، لذلك راجع شنو هي البيانات اللي غادي تتصيفط لمزوّد النموذج المختار.
فسّر GEO Weight بحذر
GEO Weight قدرة تجريبية مبنية على الولوج المؤهل لمحتوى الذكاء الاصطناعي خلال آخر 30 يوم تقويمي كامل. استعمل الصيغة الموثقة، والأدلة، والنطاق المعني، والقيود، وما تعتبرهاش نقطة ترتيب شاملة.
إعداد التطوير
المساهمين كيحتاجو Node.js 22.23.4، وpnpm 12.3.4، وPostgreSQL، وقاعدة بيانات مستقلة للتطوير، وإعدادات خاصة للبيئة. التسلسل التالي كيهيّأ وكيشغل تطبيق الويب فالمنفذ 3302:
pnpm install --frozen-lockfile
pnpm build:db
pnpm db:migrate
pnpm liekan:migrate
pnpm liekan:queue-bootstrap
pnpm build:openapi
pnpm build:packages
pnpm build:tracker
pnpm build:recorder
pnpm liekan:build-worker
pnpm dev --port 3302شغّل عمال السجلات والتحليلات فطرفيات منفصلة، كيف ما موضح فـ CONTRIBUTING.md. عمال التطوير وتطبيق الويب خاصهم يستعملو نفس إعدادات البيئة الخاصة.
صفحات المنتج كاينة فـ src/components/liekan، وعقود البيانات فـ src/lib/liekan/contracts، ومحوّلات الاستعلامات والصلاحيات من المنبع فـ src/lib/liekan/upstream. زِد تغييرات المخطط من خلال ترحيلات المشروع التدريجية، وما تبدلش الترحيلات اللي تطبقات من قبل.
الخلاصة
GEOInflow كيوفر طريقة مستضافة ذاتياً باش تجمع أدلة الزواحف، ومخزونات المحتوى، وتحليلات الزوار، والإحالات من الذكاء الاصطناعي، والتحويلات. بْدا بنشر Docker، أمّن حساب المسؤول، ربط مصادر المتصفح والسجلات، واستورد مخزون موثوق. أكثر الاستنتاجات فائدة كتجي من المرشحات المتناسقة، والعمال السليمين، والتغطية الكاملة للمصادر، والفصل الواضح بين الولوج المرصود والادعاءات اللي كتحتاج أدلة إضافية.