شنو كيدير NorthCinder
NorthCinder هو سيرفر مفتوح المصدر ديال Model Context Protocol كيساعد وكيل تسوّق بالذكاء الاصطناعي يقارن المنتجات مع المواصفات اللي كيحددها الشاري. كينتج لائحة مختصرة مرتبة، وكيشرح علاش كل عرض خدا المرتبة ديالو، وكيحدد الاختيارات اللي ترفضات، وكيبيّن شنوما الحوانت اللي تقلب فيها وشنوما اللي ما تقلبش فيها.
NorthCinder كيخدم فالحاسوب ديالك حدّ تطبيق ديال الذكاء الاصطناعي كيدعم MCP. مالك المستودع ما كيشغّلش خدمة NorthCinder مستضافة، ولا نظام حسابات، ولا لوحة تحكم مركزية، ولا خدمة ديال القياس عن بُعد. نتا اللي كتشغّل العميل ومحرك التجميع، وكتختار الربط مع الحوانت، وكتحتافظ بالإعدادات المحلية وبيانات التدقيق.
قاعدة أساسية فالتصميم هي أن معايير الشاري هي اللي كتحدد الترتيب. الأداءات ديال البائعين ومعلومات التسويق بالعمولة ما كتحسّنش المرتبة ديال أي عرض. النتائج المدعومة بالإشهار كتبقى معلّمة وكتجي من بعد النتائج العضوية.
المزايا الرئيسية
- ترتيب حسب اختيار الشاري: العروض كترتّب حسب المتطلبات اللي فالمواصفات ديال التسوّق.
- تفسيرات قابلة للقراءة آلياً: كل توصية فيها نقطة وأسباب منظمة.
- الاختيارات المرفوضة باينة: العروض اللي ما كتستوفيش المعايير الإلزامية كيتبلّغ عليها مع الشرط اللي ما حققاتوش.
- الإبلاغ على تغطية الحوانت: الحوانت اللي ما متوفراش، أو محجوبة، أو ما متهيّأاش كتبقى باينة بلا ما تتحيد فصمت.
- أدلة الثقة فالتاجر: كل تاجر عندو دليل داعم واضح، أو حالة صريحة كتبيّن أن المعطيات غير معروفة.
- علامات ثابتة: علامات الرعاية والمصدر ككتبقى مرتبطة بكل عرض.
- التحقق المحلي: العميل كيعيد تشغيل الترتيب الحتمي باستعمال المعطيات اللي صرّحت بها الخدمة.
- إتمام شراء متحكَّم فيه: إتمام الشراء آلياً كيتطلب تفويض موافقة موقّع، صالح لاستعمال واحد، ومربوط بعرض محدد بالضبط، وكمية محددة، وسقف للإنفاق.
- التدقيق المحلي: التوصيات والموافقات ومحاولات إتمام الشراء كتكتب فمسار تدقيق محلي.
إعادة الترتيب محلياً كتتحقق من الترتيب الناتج على أساس المعطيات المصرّح بها. ولكن ما كتثبتش أن الكتالوج الأصلي كان كامل، ولا أن كل معلومة جاية من الحانوت كانت صحيحة.
المتطلبات الأساسية
بالنسبة للتثبيت العادي، خاصك Node.js 20 أو أحدث وتطبيق ديال الذكاء الاصطناعي كيدعم MCP. بعض عمليات الربط مع الحوانت تقدر تحتاج صلاحيات إضافية فالمنصة، أو بيانات الدخول، أو إعدادات خاصة.
ثبّت ووجد NorthCinder
الخطوة 1: شغّل أداة التهيئة
حلّ الطرفية وشغّل:
npx northcinder initأداة التهيئة كترشدك فالإعداد المحلي وكتطبع إعدادات MCP اللي كيحتاجها تطبيق الذكاء الاصطناعي ديالك.
الخطوة 2: زِد إعدادات MCP
نسخ الإعدادات اللي طبعاتها أداة التهيئة ولسقها فالمكان المخصص لإعدادات MCP داخل تطبيق الذكاء الاصطناعي ديالك. المكان والطريقة بالضبط كيعتمدو على التطبيق، لذلك تبع التوثيق ديالو الخاص بـMCP.
الخطوة 3: ربط أو عاود شغّل تطبيق الذكاء الاصطناعي
طبّق الإعدادات وعاود الربط أو شغّل التطبيق من جديد إلا كان هاد الشي مطلوب. من بعد، خاص NorthCinder يولي متوفر للوكيل كسيرفر MCP محلي.
قدّم أول مواصفات ديال التسوّق
NorthCinder كيخدم مزيان مع مواصفات دقيقة فيها الخصائص الإلزامية، والميزانية، والعوامل اللي خاصها المقارنة، وطلب ديال الشرح. مثلاً:
قلّب ليا على صباط ديال الجري باللون الكحل ومن الصوف، بأقل من $130. قارن الثمن، والتوصيل، والملاءمة، والثقة فالتاجر. قول ليا علاش الفائز جا فالمرتبة الأولى وشنوما الاختيارات اللي ترفضات.
هاد المواصفات كتحدد المعايير الإلزامية بحال اللون، والمادة، ونوع المنتج، والثمن الأقصى. وكتقول للوكيل شنوما العوامل اللي يقارن، وكتطلب منو يبيّن علاش الفائز تربح وشنوما البدائل المرفوضة.
فحص الجواب
راجع أكثر من النتيجة الأولى. جواب NorthCinder يقدر يتضمن:
- العروض اللي كتستوفي المعايير الإلزامية.
- النقطة والأسباب القابلة للقراءة آلياً لكل توصية.
- العروض المرفوضة والشرط المحدد اللي ما حققوش كل واحد منها.
- أدلة الثقة فالتاجر، أو إشارة واضحة إلى أن الدليل ناقص.
- تقرير على التغطية حانوت بحانوت.
- علامات المصدر والرعاية المرتبطة بكل عرض.
تقرير التغطية مهم بزاف. إلا كان شي حانوت ما متوفرش أو محجوب، ما خاصش يتفسّر العرض المختصر الراجع على أنه بحث كامل فالسوق كامل.
فهم مسار البحث والموافقة
تطبيق الذكاء الاصطناعي ديالك كيتواصل مع عميل NorthCinder عبر MCP. العميل كيتواصل مع خدمة البحث اللي كيشغّلها الشاري، واللي كتستعمل موائمات الحوانت المهيّأة. النتائج كترجع للعميل باش يعاود الترتيب محلياً، ويشرح، ويدير التدقيق.
البحث وتتبع الأثمان ما كيعطيوش الإذن بالشراء. قبل إتمام الشراء آلياً، NorthCinder كيتطلب موافقة الشاري على عملية الشراء المحددة. التفويض الناتج كيكون موقّع، للاستعمال مرة وحدة، ومربوط بالعرض والكمية وسقف الإنفاق المحددين بالضبط. دفتر nonces عابر للعمليات كيحمي التفويض من إعادة الاستعمال.
حسب الربط المتوفر، الشراء الموافق عليه يقدر يدوز عبر قناة إتمام الشراء أو تحويل السلة. معطيات البطاقة الخام كترفض؛ وقنوات الأداء الآلية كتستعمل رموز أداء مفوّضة وغير مكشوفة ملي كتكون متوفرة.
إعداد تغطية الحوانت
الولوج للحوانت كيختلف حسب المنصة. قرا التوثيق ديال كل موائم قبل ما تعتمد عليه فمسار حقيقي.
- Shopify: البحث فالكاطالوغ كيتوفر من بعد إعداد إضافي ديال Shopify. الربط القديم لكل متجر ما بقاش هو المعتمد دابا.
- WooCommerce: البحث كيخدم مع المتاجر اللي كتكشف على WooCommerce Store API العمومي.
- eBay: البحث الأصلي كيتطلب الولوج الموافق عليه لـ eBay Buy API.
- Etsy: البحث الأصلي كيتطلب الولوج الموافق عليه لتطبيق Etsy.
- Amazon: المقارنة للقراءة فقط تقدر تستعمل بروفايل متصفح كتحكم فيه نتا. كتوقف عند التحديات وما كتديرش إتمام الشراء.
إلى ما كانش الولوج الأصلي متوفر، يقدر وكيل يقارن صفحات المنتجات المسموح بها باستعمال أدوات المتصفح اللي كيتحكم فيها من قبل. NorthCinder كيقبل معطيات موحّدة على المنتجات انطلاقاً من هاد الملاحظات. ما كيقبلش الكوكيز، ولا HTML الخام، ولا لقطات الشاشة، ولا تعليمات الصفحات، ولا كلمات السر، ولا الرموز اللي كتستعمل مرة وحدة، ولا المفتاح ديال مزوّد الذكاء الاصطناعي ديالك.
العروض اللي لاحظها الوكيل ما يمكنش تستعمل للشراء الآلي ولا للمراقبة بلا حضور حتى يؤكدها محوّل أصلي أو بروتوكول التاجر.
بني NorthCinder من المصدر
المستودع عبارة عن مساحة عمل pnpm. حزم المنتجات كتحتاج Node.js 20 أو أحدث. مساحة عمل الموقع الخاص كتحتاج Node.js 22.12 أو أحدث.
الخطوة 1: ثبّت الاعتماديات
corepack pnpm install --frozen-lockfileالخطوة 2: بنِ مساحة العمل
corepack pnpm buildالخطوة 3: شغّل المُهيّئ المحلي
node northcinder/bin/northcinder.js initالمستودع فيه حتى فحوصات البناء بلا إنترنت، والتحقق من الأنواع، والاختبارات، والاعتماديات، والأسرار، والتغليف، والواجهة العمومية. راجع CONTRIBUTING.md باش تلقى أوامر التحقق الكاملة قبل الإصدار.
نصائح للاستعمال المتقدم
كتب متطلبات قابلة للاختبار
فرّق بين المتطلبات الإلزامية والتفضيلات. مثلاً، حدّد سقفاً صارماً للميزانية وخصائص ضرورية فالمنتج، ومن بعد زِد عوامل مقارنة أكثر مرونة بحال سرعة التوصيل، والملاءمة، والثقة فالتاجر. هاد الشي كيخلّي أسباب الرفض وتفسيرات الترتيب أسهل فالمراجعة.
راجع التغطية قبل ما تثق فالفائز
شوف شنو من محوّلات خدم، وشنو توقف، وشنو ما تهيّأش. NorthCinder كيبقي هاد الثغرات باينة عن قصد. العرض اللي جا الأول هو الفائز بين المدخلات المعلنة واللي تقيّمات بنجاح، وماشي بالضرورة بين جميع العروض المتوفرة فالإنترنت.
فرّق بين التحقق والاكتمال
العميل يقدر يعاود الترتيب بشكل حتمي باش يتحقق واش معايير المشتري المعلنة هي اللي نتجات عليها النتيجة المتوصّل بها. هاد الشي ما كيتحققش من اكتمال الكاطالوغ وما كيضمنش أن المعطيات اللي كيقدمها المتجر صحيحة. اعتبر الأدلة الناقصة وحالات الثقة المجهولة قيوداً مهمة.
خلي ملاحظات المتصفح داخل الحدود ديالها
المقارنة بمساعدة المتصفح تقدر تعاون ملي ما يكونش محوّل أصلي ديال المتجر متوفر، ولكن العروض الملحوظة كتحتاج تأكيداً أصلياً أو تأكيداً من بروتوكول التاجر قبل المراقبة بلا حضور أو الشراء الآلي. المقارنة ديال Amazon عبر المتصفح للقراءة فقط، كتوقف عند التحديات، وما كتكمّلش الشراء.
حمي بيانات الدخول والأداء
خلي المفتاح ديال مزوّد الذكاء الاصطناعي فالتطبيق ديال الذكاء الاصطناعي، وخلي بيانات الدخول بينك وبين المتجر المعني. ما تدوزش كلمات السر، ولا الرموز اللي كتستعمل مرة وحدة، ولا الكوكيز، ولا تفاصيل البطاقة البنكية الخام لـ NorthCinder. راجع وثائق الخصوصية وملكية البرمجيات ديال المستودع وسياسة الأمان باش تعرف الحدود كاملة.
تفقد عقود المشروع
إلى بغيتي تحقق تقنياً بشكل أعمق، راجع مواصفة الترتيب، وتدقيق الحياد، وعقد المحوّل، ومواصفة الثقة، وحزمة الشراء، ومصدر العميل فالمستودع. هاد المواد كتوثّق كيفاش كيتطبق حياد الترتيب، وترتيب الرعاية، والإبلاغ على التغطية، وأدلة الثقة، وتفويضات الشراء، والتدقيق المحلي.
الحالة الحالية للمشروع
الإصدار 0.1.2 هو أول إصدار عمومي. تغطية التركيبات الاختبارية وأدوات الاختبار ما كتثبتش أن بيانات الدخول ديال الأطراف الثالثة صالحة دابا، ولا أن كل متجر يمكن الولوج ليه فالإنتاج، ولا أن عملية شراء حقيقية تكملات. تحقق من وثائق المحوّل المعني قبل ما تعتمد على أي تكامل.
الحزمة مازال ما تدرجاتش فالسجل الرسمي ديال MCP، والموقع التسويقي اللي موجود فالمستودع ما تنشرش فعنوان إنتاج قانوني ومعتمد.
الخلاصة
NorthCinder كيوفر أساساً محلياً وقابلاً للفحص للتسوق بمساعدة الذكاء الاصطناعي. كيجمع بين الترتيب اللي كيحددو المشتري، وأسباب الرفض الواضحة، وتغطية المتاجر الباينة، وأدلة الثقة فالتاجر، والتدقيق المحلي، والموافقة الخاصة بكل عملية شراء. بدا بالمُهيّئ، وربط إعدادات MCP اللي تولدات، وقدّم طلباً دقيقاً، وراجع مبررات الترتيب وثغرات التغطية قبل ما توافق على أي شراء.