NorthCinder کیا کرتا ہے
NorthCinder ایک اوپن سورس Model Context Protocol سرور ہے جو ایک AI شاپنگ ایجنٹ کو خریدار کی متعین کردہ ضروریات کے مطابق مصنوعات کا موازنہ کرنے میں مدد دیتا ہے۔ یہ ترجیحی ترتیب کے ساتھ مختصر فہرست تیار کرتا ہے، وضاحت کرتا ہے کہ ہر پیشکش کو اس کی پوزیشن کیوں ملی، مسترد کیے گئے اختیارات کی نشاندہی کرتا ہے، اور رپورٹ کرتا ہے کہ کن اسٹورز کو تلاش کیا گیا یا نہیں کیا گیا۔
NorthCinder آپ کے کمپیوٹر پر ایسی AI ایپلیکیشن کے ساتھ چلتا ہے جو MCP کو سپورٹ کرتی ہو۔ ریپوزٹری کا مالک کوئی ہوسٹڈ NorthCinder سروس، اکاؤنٹ سسٹم، کنٹرول پلین، یا ٹیلی میٹری سروس نہیں چلاتا۔ آپ کلائنٹ اور ایگریگیشن انجن چلاتے ہیں، اسٹور کنکشنز منتخب کرتے ہیں، اور مقامی کنفیگریشن اور آڈٹ ڈیٹا اپنے پاس رکھتے ہیں۔
ایک بنیادی ڈیزائن اصول یہ ہے کہ خریدار کے معیار ترجیحی ترتیب طے کرتے ہیں۔ فروخت کنندگان کی ادائیگیاں اور افیلی ایٹ معلومات کسی پیشکش کی پوزیشن بہتر نہیں بناتیں۔ اسپانسر شدہ نتائج کا لیبل برقرار رہتا ہے اور وہ آرگینک نتائج کے نیچے دکھائی دیتے ہیں۔
اہم خصوصیات
- خریدار کی ضروریات پر مبنی درجہ بندی: پیشکشیں آپ کی شاپنگ بریف میں موجود تقاضوں کے مطابق ترتیب دی جاتی ہیں۔
- مشین کے لیے قابلِ مطالعہ وضاحتیں: ہر سفارش میں اسکور اور منظم وجوہات شامل ہوتی ہیں۔
- واضح مستردیاں: لازمی معیار پر پورا نہ اترنے والی پیشکشیں اس تقاضے کے ساتھ رپورٹ کی جاتی ہیں جسے وہ پورا نہیں کر سکیں۔
- اسٹور کوریج رپورٹ: غیر دستیاب، مسدود، اور غیر کنفیگر شدہ اسٹورز کو خاموشی سے خارج کرنے کے بجائے نمایاں رکھا جاتا ہے۔
- مرچنٹ اعتماد کا ثبوت: ہر مرچنٹ کے لیے واضح معاون ثبوت یا دیانت دارانہ نامعلوم حالت درج ہوتی ہے۔
- مستقل لیبلز: اسپانسرشپ اور ماخذ کے لیبل ہر پیشکش کے ساتھ منسلک رہتے ہیں۔
- مقامی تصدیق: کلائنٹ سروس کی جانب سے ظاہر کیے گئے ان پٹس پر دوبارہ متعین درجہ بندی چلاتا ہے۔
- محدود چیک آؤٹ: خودکار چیک آؤٹ کے لیے درست پیشکش، مقدار، اور خرچ کی حد سے منسلک دستخط شدہ، ایک بار استعمال ہونے والا منظوری مینڈیٹ درکار ہوتا ہے۔
- مقامی آڈٹنگ: سفارشات، منظوریوں، اور چیک آؤٹ کی کوششیں مقامی آڈٹ ریکارڈ میں لکھی جاتی ہیں۔
مقامی دوبارہ درجہ بندی ظاہر کیے گئے ان پٹس سے تیار کردہ ترتیب کی تصدیق کرتی ہے۔ یہ ثابت نہیں کرتی کہ بالائی سطح کا کیٹلاگ مکمل تھا یا اسٹور کی فراہم کردہ ہر معلومات درست تھی۔
ضروریات
معیاری انسٹالیشن کے لیے آپ کو Node.js 20 یا اس کے بعد کا ورژن اور MCP کو سپورٹ کرنے والی AI ایپلیکیشن درکار ہے۔ انفرادی اسٹور انٹیگریشنز کے لیے اضافی پلیٹ فارم رسائی، اسناد، یا کنفیگریشن درکار ہو سکتی ہے۔
NorthCinder انسٹال اور ابتدائی طور پر کنفیگر کریں
مرحلہ 1: ابتدائی پروگرام چلائیں
ٹرمینل کھولیں اور یہ کمانڈ چلائیں:
npx northcinder initابتدائی پروگرام مقامی سیٹ اپ میں آپ کی رہنمائی کرے گا اور آپ کی AI ایپلیکیشن کے لیے ضروری MCP کنفیگریشن دکھائے گا۔
مرحلہ 2: MCP کنفیگریشن شامل کریں
ابتدائی پروگرام کی دکھائی گئی کنفیگریشن اپنی AI ایپ کے MCP کنفیگریشن حصے میں کاپی کریں۔ درست مقام اور کنکشن کا طریقہ ایپلیکیشن پر منحصر ہے، اس لیے اس کی MCP دستاویزات کی پیروی کریں۔
مرحلہ 3: AI ایپ کو کنیکٹ یا دوبارہ شروع کریں
اگر ضروری ہو تو کنفیگریشن نافذ کریں اور ایپلیکیشن کو دوبارہ کنیکٹ یا شروع کریں۔ اس کے بعد NorthCinder ایجنٹ کے لیے مقامی MCP سرور کے طور پر دستیاب ہونا چاہیے۔
اپنی پہلی شاپنگ بریف جمع کریں
NorthCinder ایسی مخصوص بریف کے ساتھ بہترین کام کرتا ہے جس میں لازمی خصوصیات، بجٹ، موازنے کے عوامل، اور وضاحت کی درخواست شامل ہو۔ مثال کے طور پر:
$130 سے کم قیمت میں سیاہ اونی دوڑنے کے جوتے تلاش کریں۔ قیمت، ڈیلیوری، فِٹ، اور مرچنٹ کے اعتماد کا موازنہ کریں۔ مجھے بتائیں کہ فاتح پہلے نمبر پر کیوں آیا اور کن اختیارات کو مسترد کیا گیا۔
یہ بریف رنگ، مواد، مصنوعات کی قسم، اور زیادہ سے زیادہ قیمت جیسے لازمی معیار متعین کرتی ہے۔ یہ ایجنٹ کو یہ بھی بتاتی ہے کہ کن عوامل کا موازنہ کرنا ہے اور جیتنے کی وجہ اور مسترد شدہ متبادل دونوں ظاہر کرنے کو کہتی ہے۔
جواب کا جائزہ لیں
صرف پہلے نتیجے کا جائزہ نہ لیں۔ NorthCinder کے جواب میں یہ شامل ہو سکتا ہے:
- وہ پیشکشیں جو لازمی معیار پر پوری اترتی ہیں۔
- ہر سفارش کا اسکور اور مشین کے لیے قابلِ مطالعہ وجوہات۔
- مسترد شدہ پیشکشیں اور وہ مخصوص تقاضا جسے ہر پیشکش پورا نہیں کر سکی۔
- مرچنٹ کے اعتماد کا ثبوت یا واضح اشارہ کہ ثبوت دستیاب نہیں۔
- اسٹور بہ اسٹور کوریج رپورٹ۔
- ہر پیشکش کے ساتھ منسلک ماخذ اور اسپانسرشپ کے لیبلز۔
کوریج رپورٹ خاص طور پر اہم ہے۔ اگر کوئی اسٹور غیر دستیاب یا مسدود تھا تو واپس کی گئی مختصر فہرست کو پوری مارکیٹ کی مکمل تلاش نہ سمجھیں۔
تلاش اور منظوری کے ورک فلو کو سمجھیں
آپ کی AI ایپ MCP کے ذریعے NorthCinder کلائنٹ سے رابطہ کرتی ہے۔ کلائنٹ خریدار کے زیرِ انتظام سرچ سروس سے رابطہ کرتا ہے، جو کنفیگر شدہ اسٹور اڈاپٹرز استعمال کرتی ہے۔ نتائج مقامی دوبارہ درجہ بندی، وضاحت، اور آڈٹنگ کے لیے کلائنٹ کو واپس آتے ہیں۔
تلاش اور قیمت کی نگرانی خریداری کی اجازت نہیں دیتی۔ خودکار چیک آؤٹ سے پہلے NorthCinder مخصوص خریداری کے لیے خریدار کی منظوری طلب کرتا ہے۔ نتیجہ خیز مینڈیٹ دستخط شدہ، ایک بار استعمال ہونے والا، اور بالکل درست پیشکش، مقدار، اور خرچ کی حد سے منسلک ہوتا ہے۔ کراس پروسیس nonce ledger مینڈیٹ کے دوبارہ استعمال سے تحفظ فراہم کرتا ہے۔
دستیاب انٹیگریشن کے مطابق، منظور شدہ خریداری چیک آؤٹ ریل یا کارٹ ہینڈ آف کے ذریعے مکمل ہو سکتی ہے۔ اصل کارڈ کی تفصیلات مسترد کر دی جاتی ہیں؛ دستیاب ہونے پر خودکار ادائیگی کے ذرائع مبہم delegated payment tokens استعمال کرتے ہیں۔
اسٹور کوریج کنفیگر کریں
اسٹور تک رسائی پلیٹ فارم کے لحاظ سے مختلف ہوتی ہے۔ حقیقی ورک فلو میں کسی اڈاپٹر پر انحصار کرنے سے پہلے ہر اڈاپٹر کی دستاویزات پڑھیں۔
- Shopify: اضافی Shopify سیٹ اپ کے بعد کیٹلاگ کی تلاش دستیاب ہوتی ہے۔ فی اسٹور پرانا کنکشن اب قابلِ استعمال نہیں رہا۔
- WooCommerce: تلاش ان اسٹورز کے ساتھ کام کرتی ہے جو عوامی WooCommerce Store API فراہم کرتے ہیں۔
- eBay: مقامی تلاش کے لیے منظور شدہ eBay Buy API رسائی درکار ہے۔
- Etsy: مقامی تلاش کے لیے منظور شدہ Etsy ایپلیکیشن رسائی درکار ہے۔
- Amazon: صرف پڑھنے کے لیے موازنہ آپ کے زیرِ کنٹرول براؤزر پروفائل کے ذریعے کیا جا سکتا ہے۔ یہ چیلنجز پر رک جاتا ہے اور چیک آؤٹ نہیں کرتا۔
جب مقامی رسائی دستیاب نہ ہو، تو ایجنٹ اپنے زیرِ کنٹرول براؤزر ٹولز کے ذریعے اجازت یافتہ پروڈکٹ صفحات کا موازنہ کر سکتا ہے۔ NorthCinder ان مشاہدات سے معمول پر لائے گئے پروڈکٹ حقائق قبول کرتا ہے۔ یہ کوکیز، خام HTML، اسکرین شاٹس، صفحے کی ہدایات، پاس ورڈز، یک بار استعمال ہونے والے کوڈز، یا آپ کے AI-provider کی کلید قبول نہیں کرتا۔
ایجنٹ کے مشاہدہ کردہ آفرز خودکار چیک آؤٹ یا غیر زیرِ نگرانی نگرانی کے لیے اس وقت تک استعمال نہیں کیے جا سکتے جب تک کوئی مقامی اڈاپٹر یا مرچنٹ پروٹوکول ان کی تصدیق نہ کر دے۔
ماخذ سے 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 کا براؤزر پر مبنی موازنہ صرف پڑھنے کے لیے ہے، چیلنجز پر رک جاتا ہے، اور چیک آؤٹ نہیں کرتا۔
اسناد اور ادائیگی کا ڈیٹا محفوظ رکھیں
اپنی AI-provider کی کلید AI ایپلیکیشن میں رکھیں، اور اسٹور کی اسناد اپنے اور متعلقہ اسٹور کے درمیان محفوظ رکھیں۔ پاس ورڈز، یک بار استعمال ہونے والے کوڈز، کوکیز، یا خام کارڈ کی تفصیلات NorthCinder کو نہ دیں۔ مکمل حدود کے لیے ریپوزٹری کی رازداری اور سافٹ ویئر کی ملکیت کی دستاویزات اور سکیورٹی پالیسی کا جائزہ لیں۔
پروجیکٹ کے معاہدوں کا معائنہ کریں
گہری تکنیکی توثیق کے لیے ریپوزٹری کی درجہ بندی کی وضاحت، غیر جانب داری کے آڈٹ، اڈاپٹر معاہدے، اعتماد کی وضاحت، چیک آؤٹ پیکیج، اور کلائنٹ کے ماخذ کا جائزہ لیں۔ یہ مواد دستاویز کرتا ہے کہ درجہ بندی کی غیر جانب داری، اسپانسرشپ کی جگہ، کوریج رپورٹنگ، اعتماد کے شواہد، خریداری کے لازمی تقاضے، اور مقامی آڈٹنگ کیسے نافذ کیے گئے ہیں۔
پروجیکٹ کی موجودہ حالت
ورژن 0.1.2 ابتدائی عوامی ریلیز ہے۔ فکسچر اور ہارنس کوریج اس بات کا ثبوت نہیں دیتی کہ فریقِ ثالث کی اسناد فی الحال درست ہیں، ہر اسٹور پروڈکشن میں قابلِ رسائی ہے، یا حقیقی خریداری مکمل ہو چکی ہے۔ کسی انضمام پر انحصار سے پہلے متعلقہ اڈاپٹر کی دستاویزات کی تصدیق کریں۔
یہ پیکیج ابھی تک سرکاری MCP Registry میں درج نہیں ہے، اور ریپوزٹری میں شامل مارکیٹنگ سائٹ کو کسی مستند پروڈکشن اصل پر شائع نہیں کیا گیا۔
نتیجہ
NorthCinder AI کی مدد سے خریداری کے لیے ایک مقامی اور قابلِ معائنہ بنیاد فراہم کرتا ہے۔ یہ خریدار کی مقرر کردہ درجہ بندی، واضح مسترد وجوہات، نمایاں اسٹور کوریج، مرچنٹ کے اعتماد کے شواہد، مقامی آڈٹنگ، اور خریداری سے متعلق منظوری کو یکجا کرتا ہے۔ ابتدائی عمل سے شروع کریں، تیار کردہ MCP کنفیگریشن مربوط کریں، ایک واضح بریف جمع کریں، اور کسی بھی خریداری کی منظوری سے پہلے درجہ بندی کی وجہ اور کوریج کے خلا دونوں کا معائنہ کریں۔