Mağaza MCP کے ساتھ App Store Connect اور Google Play کا نظم کریں

Mağaza MCP کیا ہے؟

Mağaza MCP ایک اوپن سورس Model Context Protocol سرور ہے جو AI معاونین کو ایک ہی تنصیب سے App Store Connect اور Google Play دونوں تک رسائی دیتا ہے۔ یہ ان ڈویلپرز اور ایپ آپریٹرز کے لیے بنایا گیا ہے جنہیں الگ الگ انضمامات کے درمیان تبدیل ہوئے بغیر iOS اور Android اسٹور کے ڈیٹا کا معائنہ، موازنہ اور انتظام کرنا ہوتا ہے۔

سرور آپ کی مشین پر مقامی طور پر چلتا ہے اور Apple اور Google سے براہِ راست مواصلت کرتا ہے۔ کوئی درمیانی سروس موجود نہیں۔ Apple کے ٹولز appstore__ سابقہ استعمال کرتے ہیں، Google Play کے ٹولز play__، جبکہ دونوں اسٹورز یا عمومی API ٹولز magaza__ استعمال کرتے ہیں۔

اس کی نمایاں خصوصیت ایک ہی کارروائی میں دونوں اسٹورز سے متعلق سوالات کے جوابات دینے کی صلاحیت ہے۔ مثال کے طور پر، آپ کا معاون App Store اور Google Play پر ایک ہی سبسکرپشن کی ترک قیمت کا موازنہ کر سکتا ہے، متعلقہ iOS اور Android ایپلیکیشنز کو جوڑ سکتا ہے، یا دونوں اسٹورز میں خریداری کی ترتیب کے مسئلے کی جانچ کر سکتا ہے۔

اہم خصوصیات

• دو اسٹورز کے لیے ایک MCP سرور: App Store Connect، Google Play، یا دونوں سے منسلک ہوں۔
• دونوں اسٹورز کے ورک فلو: سبسکرپشنز کا موازنہ کریں، ایپلیکیشن کا مشترکہ جائزہ تیار کریں، اور دونوں پلیٹ فارمز پر ایپ کے اندر خریداری کی ترتیب کی تشخیص کریں۔
• 27 مرکوز ٹولز: دو اسٹورز کی تنصیب عام اسٹور کارروائیوں اور عمومی API رسائی کے لیے 27 ٹولز فراہم کرتی ہے۔
• مکمل API کوریج: App Store Connect API v4.5، Android Publisher API v3، اور Play Developer Reporting API v1beta1 سے 1,440 کارروائیوں کو تلاش اور طلب کریں۔
• کم سیاقی بوجھ: مکمل API کیٹلاگ تک سرچ اور ڈسپیچ ٹولز کے ذریعے رسائی حاصل کی جاتی ہے، بجائے اس کے کہ تمام 1,440 کارروائیوں کو الگ MCP ٹولز کے طور پر ظاہر کیا جائے۔
• مقامی اسناد کا ذخیرہ: جہاں ممکن ہو، اسناد macOS Keychain میں محفوظ رہتی ہیں؛ جن سسٹمز پر Keychain استعمال نہیں کیا جا سکتا وہاں محدود اجازتوں والی فائل متبادل کے طور پر استعمال ہوتی ہے۔
• تحریری کارروائیوں کے لیے تصدیق: ڈیٹا تبدیل کرنے والی کارروائیوں کے لیے واضح onayla=true تصدیق درکار ہوتی ہے۔
• صرف مطالعہ موڈ: تحریری ٹولز کو ماڈل کی ٹول فہرست سے مکمل طور پر ہٹایا جا سکتا ہے۔
• کوئی ٹیلی میٹری نہیں: یہ منصوبہ تجزیاتی معلومات، خرابی کی رپورٹس یا استعمال کا ڈیٹا نہیں بھیجتا۔

ضروریات

پیکیج چلانے سے پہلے Node.js 18 یا اس کے بعد کا ورژن انسٹال کریں۔ آپ کو ہر اس اسٹور کے لیے موزوں اسناد بھی درکار ہوں گی جس سے آپ منسلک ہونا چاہتے ہیں۔

App Store Connect کی ضروریات

App Store Connect API کلید بنائیں اور سیٹ اپ کے دوران اس کا Key ID، Issuer ID، اور .p8 فائل دستیاب رکھیں۔ زیادہ تر کارروائیوں کے لیے App Manager کردار کافی ہے۔ صارف اور رسائی کے انتظام کے اختتامی نقاط، نیز کچھ تجزیاتی رپورٹس، زیادہ اختیارات کا تقاضا کر سکتی ہیں۔

کلید App Store Connect API کلید ہونی چاہیے۔ StoreKit اور پش نوٹیفکیشن کیز کو متبادل کے طور پر استعمال نہیں کیا جا سکتا۔

Google Play کی ضروریات

1. Play Console → Users and permissions کے ذریعے سروس اکاؤنٹ کو مدعو کریں، پھر متعلقہ ایپلیکیشنز تک رسائی دیں۔
2. متعلقہ Google Cloud پروجیکٹ میں Android Publisher API اور Play Developer Reporting API دونوں فعال کریں۔

Reporting API صرف کریش میٹرکس کے لیے نہیں بلکہ ایپلیکیشن کی دریافت کے لیے بھی ضروری ہے۔ Android Publisher API کسی اکاؤنٹ کے لیے دستیاب تمام ایپلیکیشنز کی فہرست بنانے کا اختتامی نقطہ فراہم نہیں کرتا۔

معاہدے، ٹیکس کی تفصیلات اور بینکاری کی معلومات ان APIs کے ذریعے پڑھی نہیں جا سکتیں۔ Apple یہ معلومات App Store Connect API کیز کے ذریعے ظاہر نہیں کرتا۔

Mağaza MCP انسٹال کریں

ایک کمانڈ سے انٹرایکٹو انسٹالر شروع کریں:

npx magaza-mcp kur

وزرڈ آپ کو درج ذیل مراحل سے گزارتا ہے:

1. App Store Connect، Google Play، یا دونوں اسٹورز منتخب کریں۔
2. App Store Connect Key ID اور Issuer ID درج کریں، پھر .p8 فائل کا راستہ فراہم کریں۔
3. Google Play سروس اکاؤنٹ کی JSON فائل کا راستہ فراہم کریں۔
4. وہ دریافت شدہ AI کلائنٹس منتخب کریں جہاں MCP کی تشکیل انسٹال کی جانی ہے۔
5. منتخب کریں کہ سرور صرف مطالعہ موڈ میں کام کرے یا نہیں۔

انسٹالر اسناد محفوظ کرنے سے پہلے حقیقی API درخواستوں کے ذریعے Apple اور Google کی اسناد کی توثیق کرتا ہے۔ اسناد AI کلائنٹ کی تشکیل کی فائل میں نہیں لکھی جاتیں۔ تشکیل میں صرف یہ معلومات شامل ہوتی ہیں کہ MAGAZALAR کے ذریعے کون سے اسٹورز فعال ہیں۔

macOS پر اسناد Keychain میں محفوظ کی جاتی ہیں۔ اگر Keychain دستیاب نہ ہو تو منصوبہ 0600 اجازتوں والی فائل پر منتقل ہو جاتا ہے۔

معاون MCP کلائنٹس

انسٹالر Claude Code، Claude Desktop، Antigravity، Cursor، Windsurf، اور Codex کو سپورٹ کرتا ہے۔ یہ صرف magaza-mcp اندراج کو اپ ڈیٹ کرتا ہے، غیر متعلقہ تشکیل محفوظ رکھتا ہے، لکھنے سے پہلے .magaza-mcp-yedek بیک اپ بناتا ہے، اور ایٹامک رائٹنگ کرتا ہے۔

سیٹ اپ کے بعد کھلی ہوئی کلائنٹ ایپلیکیشنز دوبارہ شروع کریں تاکہ وہ نیا MCP سرور لوڈ کر سکیں۔

تنصیب کی توثیق کریں

نتیجے کی تصدیق کے لیے اسٹیٹس اور ٹول فہرست کی کمانڈز استعمال کریں:

npx magaza-mcp durum
npx magaza-mcp durum --json
npx magaza-mcp araclar
npx magaza-mcp surum
npx magaza-mcp yardim

durum بتاتا ہے کہ کون سے اسٹورز منسلک ہیں، جبکہ araclar انسٹال شدہ ٹولز کی فہرست دکھاتا ہے۔ ✎ سے نشان زد ٹولز اسٹور کے ڈیٹا میں ترمیم کر سکتے ہیں۔

بنیادی استعمال

Mağaza MCP کو آپ کے MCP سے مطابقت رکھنے والے معاون میں قدرتی زبان کی درخواستوں کے ذریعے استعمال کرنے کے لیے بنایا گیا ہے۔ کلائنٹ دوبارہ شروع ہونے کے بعد، ایک سادہ فہرست کی درخواست سے آغاز کریں:

دونوں اسٹورز میں میری ایپلیکیشنز کی فہرست بنائیں اور دکھائیں کہ ہر ایپلیکیشن اس وقت کہاں شائع ہے۔

جب دونوں اسٹورز منسلک ہوں، تو magaza__genel_bakis ایپلیکیشنز کی فہرستوں کو یکجا کرتا ہے، مماثل iOS اور Android مصنوعات کو جوڑتا ہے، اور صرف ایک اسٹور میں موجود ایپلیکیشنز کو الگ کرتا ہے۔

سبسکرپشن کی قیمتوں کا موازنہ کریں

اسسٹنٹ سے کسی مخصوص ملک کے لیے سبسکرپشن کا موازنہ کرنے کو کہیں:

ترکی میں App Store اور Google Play پر Note Keeper کی ماہانہ سبسکرپشن کی قیمت کتنی ہے؟ کیا دونوں میں فرق ہے؟

magaza__abonelik_karsilastir ٹول پروڈکٹ آئیڈینٹی فائرز، بلنگ کے ادوار اور ملک کے لحاظ سے قیمتوں کا موازنہ کرتا ہے۔ یہ ملک کے کوڈ کو ہر اسٹور کے مطلوبہ فارمیٹ میں بھی تبدیل کرتا ہے۔

خریداری کے مسائل کی تشخیص کریں

ایسے صارف کے لیے جس نے ادائیگی کی ہو لیکن پریمیم رسائی حاصل نہ کی ہو، اس طرح کی درخواست استعمال کریں:

ایک صارف کہتا ہے کہ اس نے ادائیگی کی، لیکن پریمیم رسائی فعال نہیں ہوئی۔ دونوں اسٹورز میں خریداری کی ترتیب چیک کریں اور ممکنہ وجوہات کا خلاصہ دیں۔

magaza__iap_teshis ٹول چیک کرتا ہے کہ مصنوعات شائع ہو چکی ہیں یا نہیں، متعلقہ ملک میں قیمت موجود ہے یا نہیں، اور آیا نئے سبسکرائبرز کے لیے Google Play کا بیس پلان دستیاب ہے۔ اگر آپ Play خریداری کا ٹوکن فراہم کریں، تو ٹول تشخیص کے حصے کے طور پر اس ٹوکن کی توثیق بھی کر سکتا ہے۔

App Store Connect کا معائنہ کریں

App Store سے متعلق ٹولز ایپلیکیشنز، ریلیزز، TestFlight بلڈز، جائزے، سبسکرپشن گروپس، سبسکرپشن کی قیمتیں، اِن ایپ خریداریوں، TestFlight گروپس اور سیلز رپورٹس کی فہرستیں فراہم کر سکتے ہیں۔ مثال کے طور پر:

• App Store کا کون سا ورژن فی الحال ریویو میں پھنسا ہوا ہے؟
• کیا میں نے کل جو TestFlight بلڈ اپ لوڈ کیا تھا، اس کی پروسیسنگ مکمل ہو گئی ہے؟
• گزشتہ ہفتے کے ایک ستارہ اور دو ستارہ جائزوں کا خلاصہ دیں۔
• اس ایپلیکیشن کی روزانہ سیلز رپورٹ ڈاؤن لوڈ کریں۔

اسٹور کا میٹا ڈیٹا اور جائزوں کے جوابات بھی تبدیل کیے جا سکتے ہیں، لیکن ان کارروائیوں کے لیے واضح تصدیق درکار ہوتی ہے۔

Google Play کا معائنہ کریں

Google Play کے ٹولز ایپلیکیشنز، ریلیز ٹریکس، جائزوں، سبسکرپشنز، بیس پلان کی قیمتوں، یک وقتی مصنوعات، خریداری کی توثیق، منسوخ شدہ خریداریوں اور Android vitals کے کریش ریٹس کا احاطہ کرتے ہیں۔ مثال کے طور پر:

• پروڈکشن ٹریک پر کون سا ورژن ہے، اور کتنے فیصد صارفین اسے حاصل کرتے ہیں؟
• کیا گزشتہ 14 دنوں کے دوران کریش ریٹ میں اضافہ ہوا ہے؟
• کیا یہ خریداری کا ٹوکن درست ہے، اور کیا سبسکرپشن اب بھی فعال ہے؟
• دستیاب مدت کے دوران ریفنڈ یا منسوخ کی گئی خریداریوں کو دکھائیں۔

Google متعلقہ API کے ذریعے تقریباً صرف حالیہ ایک ہفتے کے جائزے فراہم کرتا ہے۔ منسوخ شدہ خریداریوں کا ڈیٹا گزشتہ 30 دنوں تک محدود ہے۔

لکھنے والی کارروائیاں محفوظ طریقے سے انجام دیں

appstore__yorum_yanitla، appstore__metin_guncelle اور play__yorum_yanitla جیسے ٹولز اسٹور کا ڈیٹا تبدیل کر سکتے ہیں۔ یہ پہلی درخواست پر فوراً عمل نہیں کرتے۔ اس کے بجائے، سرور مجوزہ کارروائی اور متوقع ریکویسٹ باڈی واپس کرتا ہے۔

مجوزے کا جائزہ لینے کے بعد اسے منظور کریں اور اسسٹنٹ سے یہ شامل کر کے کارروائی دوبارہ کرنے کو کہیں:

onayla=true

یہ تصدیقی مرحلہ صرف MCP کلائنٹ کے انٹرفیس پر انحصار کرنے کے بجائے سرور کے ذریعے نافذ کیا جاتا ہے۔

صرف پڑھنے کا موڈ فعال کریں

آڈٹ، رپورٹنگ یا محتاط تجربات کے لیے سرور کو صرف پڑھنے کے موڈ میں شروع کریں:

npx magaza-mcp --salt-okunur

آپ یہ بھی سیٹ کر سکتے ہیں:

SALT_OKUNUR=1

دونوں اسٹورز کے منسلک ہونے پر، صرف پڑھنے کا موڈ دستیاب ٹولز کی فہرست کو 27 سے کم کر کے 24 کر دیتا ہے۔ لکھنے سے متعلق ٹولز غائب ہو جاتے ہیں، اس لیے ماڈل انہیں دیکھ یا کال نہیں کر سکتا۔ عمومی magaza__cagir ڈسپیچر دستیاب رہتا ہے کیونکہ پڑھنے کی کارروائیوں کے لیے بھی اس کی ضرورت ہوتی ہے، لیکن صرف پڑھنے کے موڈ میں یہ لکھنے کی کارروائیوں کو مسترد کر دیتا ہے۔

مکمل API کیٹلاگ استعمال کریں

مرکوز ٹولز عام ورک فلو کا احاطہ کرتے ہیں، لیکن Mağaza MCP 1,440 API کارروائیوں تک رسائی بھی فراہم کرتا ہے۔ ہر کارروائی کو ماڈل کے کانٹیکسٹ میں شامل کرنے کے بجائے، یہ تین عمومی ٹولز فراہم کرتا ہے:

• magaza__endpoint_ara منسلک اسٹورز کے API کیٹلاگز میں تلاش کرتا ہے اور مماثل آپریشن کے نام، HTTP طریقے، راستے اور پیرامیٹرز واپس کرتا ہے۔
• magaza__sema کسی آپریشن کی ریکویسٹ باڈی کا اسکیما دکھاتا ہے، جو POST یا PATCH ریکویسٹ سے پہلے خاص طور پر مفید ہے۔
• magaza__cagir منتخب آپریشن کو کال کرتا ہے اور راستے کے پیرامیٹرز خودکار طور پر پُر کرتا ہے۔

ایک مفید جدید پرامپٹ یہ ہے:

منسلک اسٹور API میں ایسا اینڈ پوائنٹ تلاش کریں جو اس ریسورس کا انتظام کرتا ہو۔ کوئی بھی لکھنے کی کارروائی کرنے سے پہلے مجھے ریکویسٹ اسکیما دکھائیں۔

یہ کیٹلاگز Apple کی سرکاری App Store Connect OpenAPI specification اور Google کے Android Publisher اور Play Developer Reporting discovery documents سے تیار کیے جاتے ہیں۔ فرسودہ Apple آپریشنز اس وقت بھی تلاش کیے جا سکتے ہیں جب وہ کسی صلاحیت تک پہنچنے کا واحد راستہ ہوں، لیکن ان کے خلاصے [ESKİMİŞ] سے شروع ہوتے ہیں اور تلاش کے نتائج میں ان کی درجہ بندی کم ہوتی ہے۔

ٹول کی تنہائی کو سمجھیں

سرور متعدد ڈیزائن اصولوں کے ذریعے اسٹورز کو باہم ملانے سے گریز کرتا ہے:

• ہر اسٹور سے متعلق ٹول کا واضح سابقہ ہوتا ہے۔
• appstore__ سابقے والا ٹول کبھی Google Play کو کال نہیں کرتا، اور play__ ٹول کبھی Apple کو کال نہیں کرتا۔
• غیر منتخب اسٹور کے ٹولز میموری میں لوڈ نہیں کیے جاتے اور نہ ہی ماڈل کو دکھائے جاتے ہیں۔
• دونوں اسٹورز فعال ہونے پر ہی کراس اسٹور ٹولز موجود ہوتے ہیں۔
• ڈسپیچ ٹولز کے ذریعے قبول کیا جانے والا magaza آرگیومنٹ انسٹالیشن کے دوران تشکیل دیے گئے اسٹورز تک محدود ہوتا ہے۔

دونوں اسٹورز والی انسٹالیشن 27 ٹولز لوڈ کرتی ہے۔ صرف App Store والی انسٹالیشنز 14، جبکہ صرف Play والی انسٹالیشنز 13 ٹولز لوڈ کرتی ہیں۔ اس طرح MCP کا کانٹیکسٹ تشکیل شدہ ماحول کے مطابق رہتا ہے۔

جدید سکیورٹی تجاویز

• اسنادِ دخول چیٹ میں پیسٹ نہ کریں: خود npx magaza-mcp kur چلائیں اور مقامی وِزارڈ کے ذریعے اسناد کے راستے درج کریں۔
• تجزیے کے لیے صرف پڑھنے کا موڈ استعمال کریں: جب آپ کو صرف ریلیز، جائزے، قیمتوں، خریداری یا صحت سے متعلق معلومات درکار ہوں تو اسے فعال کریں۔
• ہر مجوزہ تحریری کارروائی کا جائزہ لیں: onayla=true کی منظوری دینے سے پہلے ایپلیکیشن، وسیلہ، لوکیل اور درخواست کے متن کی تصدیق کریں۔
• کم سے کم اجازتیں دیں: Apple پر App Manager استعمال کریں، الاّ یہ کہ کسی مطلوبہ اینڈ پوائنٹ کو واضح طور پر زیادہ رسائی درکار ہو، اور Google سروس اکاؤنٹ کو متعلقہ ایپلیکیشنز تک محدود رکھیں۔
• سسٹم کا وقت درست رکھیں: Apple JWTs کی مدت 20 منٹ ہوتی ہے، اس لیے گھڑی میں نمایاں فرق توثیق کی ناکامی کا سبب بن سکتا ہے۔

سرور پاتھ پیرامیٹرز کی توثیق اور انکوڈنگ کرتا ہے، . اور .. جیسی پاتھ ٹریورسل کوششوں کو مسترد کرتا ہے، اور مطلق URLs کے میزبانوں کی توثیق کرتا ہے۔ نیٹ ورک ٹریفک صرف Apple API، Android Publisher API، Play Developer Reporting API، اور Google کے OAuth ٹوکن اینڈ پوائنٹ تک محدود ہے۔

مسائل کا حل

Apple کی جانب سے 401 موصول ہوتا ہے

یقینی بنائیں کہ Key ID، Issuer ID اور .p8 فائل ایک ہی App Store Connect API key سے متعلق ہیں۔ مشین کی گھڑی چیک کریں، کیونکہ غلط وقت والا JWT مسترد کیا جا سکتا ہے۔ یہ بھی تصدیق کریں کہ فائل StoreKit یا push notification key نہیں ہے۔

Apple کی جانب سے 403 موصول ہوتا ہے

ممکن ہے API key کے پاس اس کارروائی کے لیے مطلوبہ کردار نہ ہو۔ App Manager زیادہ تر ورک فلو کے لیے کافی ہے، لیکن صارف کے انتظام اور بعض رپورٹس کے لیے اضافی مراعات درکار ہوتی ہیں۔ کردار سے قطع نظر Contract، tax اور banking ڈیٹا API کے ذریعے حاصل نہیں کیا جا سکتا۔

Google Play کی جانب سے 403 موصول ہوتا ہے

تصدیق کریں کہ سروس اکاؤنٹ کو Play Console میں مدعو کیا گیا ہے اور اسے ہدف ایپلیکیشن تک رسائی حاصل ہے۔ اجازتوں کی تبدیلیاں نافذ ہونے میں کئی منٹ لگ سکتے ہیں۔ یہ بھی یقینی بنائیں کہ Cloud پروجیکٹ میں Android Publisher API اور Play Developer Reporting API فعال ہیں۔

اگر ناکامی کا تعلق پرانے inappproducts اینڈ پوائنٹ سے ہے تو ممکن ہے ایپلیکیشن Google کا نیا پروڈکٹ ماڈل استعمال کرتی ہو۔ play__urunler ٹول پہلے oneTimeProducts آزما کر اور ضرورت پڑنے پر پرانے ماڈل پر واپس جا کر اسے سنبھالتا ہے۔

ٹریک کی معلومات آہستہ ظاہر ہوتی ہیں

Google Play ریلیز ٹریک کی معلومات ایک edit session کے ذریعے فراہم کرتا ہے۔ پڑھنے والے ٹولز سیشن بناتے ہیں، ڈیٹا پڑھتے ہیں اور اسے commit کیے بغیر چھوڑ دیتے ہیں، اس لیے اسٹور میں کوئی تبدیلی نہیں ہوتی۔ اس عمل کے لیے اضافی HTTP درخواستیں درکار ہوتی ہیں، اسی لیے اس میں زیادہ وقت لگ سکتا ہے۔

ترقیاتی سیٹ اپ

پروجیکٹ پر کام کرنے کے لیے repository کلون کریں اور اس کی dependencies انسٹال کریں:

git clone https://github.com/tunaarikaya/magaza-mcp.git
cd magaza-mcp
npm install
npm run build
npm run kontrol
npm run dev

npm run build TypeScript سورس کو compile کرتا ہے، npm run kontrol فائلیں بنائے بغیر type checking چلاتا ہے، اور npm run dev watch-mode compilation شروع کرتا ہے۔

spec/ کے تحت موجود تین specification فائلوں سے API catalogs دوبارہ بنانے کے لیے چلائیں:

node scripts/uret-katalog.mjs

تیار کردہ operation catalogs src/katalog/ کے تحت لکھی جاتی ہیں؛ operation list کو دستی طور پر برقرار رکھنے کا ارادہ نہیں ہے۔

نتیجہ

Mağaza MCP ایک ہی MCP-compatible assistant سے App Store Connect اور Google Play چلانے کا عملی طریقہ فراہم کرتا ہے۔ اس کے cross-store ٹولز قیمتوں کے موازنے، ایپلیکیشن فہرستوں اور خریداری کی تشخیص کو آسان بناتے ہیں، جبکہ مکمل searchable API catalog کم استعمال ہونے والی کارروائیوں کا بھی احاطہ کرتا ہے۔ مقامی اسناد کا انتظام، تصدیقی مراحل، صرف پڑھنے کا موڈ اور telemetry کی عدم موجودگی اسے ایسے ورک فلو کے لیے موزوں بناتے ہیں جہاں اسٹور تک رسائی کو قابو میں رکھنا ضروری ہو۔