Dhibiti App Store Connect na Google Play ukitumia Mağaza MCP

Mağaza MCP ni Nini?

Mağaza MCP ni seva ya wazi ya Model Context Protocol inayowapa wasaidizi wa AI ufikiaji wa App Store Connect na Google Play kupitia usakinishaji mmoja. Imeundwa kwa ajili ya wasanidi programu na waendeshaji wa programu wanaohitaji kukagua, kulinganisha na kudhibiti data ya maduka ya iOS na Android bila kubadilisha kati ya miunganisho tofauti.

Seva huendeshwa ndani ya kompyuta yako na huwasiliana moja kwa moja na Apple na Google. Hakuna huduma ya kati. Zana za Apple hutumia kiambishi appstore__, zana za Google Play hutumia play__, na zana za API za maduka yote mawili au za jumla hutumia magaza__.

Kipengele chake cha kipekee ni uwezo wa kujibu maswali yanayohusu maduka yote mawili kwa operesheni moja. Kwa mfano, msaidizi wako anaweza kulinganisha bei ya Uturuki ya usajili uleule kwenye App Store na Google Play, kuoanisha programu zinazolingana za iOS na Android, au kuchunguza tatizo la usanidi wa ununuzi katika programu kwenye maduka yote mawili.

Vipengele Muhimu

• Seva moja ya MCP kwa maduka mawili: Unganisha App Store Connect, Google Play, au maduka yote mawili.
• Mtiririko wa kazi wa maduka yote mawili: Linganisha usajili, toa muhtasari wa pamoja wa programu, na tambua matatizo ya usanidi wa ununuzi wa ndani ya programu kwenye mifumo yote miwili.
• Zana 27 mahususi: Usakinishaji wa maduka mawili hutoa zana 27 kwa shughuli za kawaida za maduka na ufikiaji wa API za jumla.
• Tafuta na uite operesheni 1,440 kutoka App Store Connect API v4.5, Android Publisher API v3, na Play Developer Reporting API v1beta1.
• Matumizi madogo ya muktadha: Katalogi kamili ya API hupatikana kupitia zana za utafutaji na usambazaji badala ya kuonyesha operesheni zote 1,440 kama zana tofauti za MCP.
• Uhifadhi wa ndani wa vitambulisho: Vitambulisho huhifadhiwa kwenye macOS Keychain inapopatikana, na hutumia faili yenye ruhusa zilizowekewa vizuizi kama njia mbadala kwenye mifumo ambayo Keychain haiwezi kutumika.
• Uthibitishaji wa mabadiliko: Operesheni zinazobadilisha data huhitaji uthibitisho wa wazi wa onayla=true.
• Hali ya kusoma pekee: Zana za kuandika zinaweza kuondolewa kabisa kwenye orodha ya zana za modeli.
• Hakuna ufuatiliaji: Mradi hautumi takwimu za matumizi, ripoti za hitilafu, wala data ya matumizi.

Mahitaji ya Awali

Sakinisha Node.js 18 au toleo jipya zaidi kabla ya kuendesha kifurushi. Pia unahitaji vitambulisho vinavyofaa kwa kila duka unalotaka kuunganisha.

Mahitaji ya App Store Connect

Unda ufunguo wa API wa App Store Connect na uwe na Kitambulisho cha Ufunguo, Kitambulisho cha Mtoaji, pamoja na faili ya .p8 wakati wa usanidi. Jukumu la App Manager linatosha kwa operesheni nyingi. Vituo vya kudhibiti watumiaji na ufikiaji, pamoja na baadhi ya ripoti za uchanganuzi, vinaweza kuhitaji ruhusa za juu zaidi.

Ufunguo lazima uwe ufunguo wa API wa App Store Connect. Vifunguo vya StoreKit na arifa za kusukuma haviwezi kutumika badala yake.

Mahitaji ya Google Play

1. Mwalike akaunti ya huduma kupitia Play Console → Users and permissions, kisha upe ufikiaji wa programu husika.
2. Washa Android Publisher API na Play Developer Reporting API katika mradi unaohusishwa wa Google Cloud.

Reporting API inahitajika si kwa vipimo vya hitilafu pekee, bali pia kwa ugunduzi wa programu. Android Publisher API haina kituo cha mwisho cha kuorodhesha programu zote zinazopatikana kwa akaunti.

Mikataba, maelezo ya kodi na taarifa za benki haziwezi kusomwa kupitia API hizi. Apple haionyeshi taarifa hizo kupitia funguo za API za App Store Connect.

Sakinisha Mağaza MCP

Anzisha kisakinishi shirikishi kwa amri moja:

npx magaza-mcp kur

Mchawi hukuongoza kupitia hatua zifuatazo:

1. Chagua App Store Connect, Google Play, au maduka yote mawili.
2. Weka Kitambulisho cha Ufunguo na Kitambulisho cha Mtoaji cha App Store Connect, kisha toa njia ya faili ya .p8.
3. Toa njia ya faili ya JSON ya akaunti ya huduma ya Google Play.
4. Chagua wateja wa AI waliotambuliwa ambapo usanidi wa MCP unapaswa kusakinishwa.
5. Chagua ikiwa seva inapaswa kufanya kazi katika hali ya kusoma pekee.

Kisakinishi huthibitisha vitambulisho vya Apple na Google kwa maombi halisi ya API kabla ya kuvihifadhi. Vitambulisho haviandikwi kwenye faili ya usanidi ya mteja wa AI. Usanidi huwa na taarifa kama vile maduka yaliyowashwa kupitia MAGAZALAR.

Kwenye macOS, vitambulisho huhifadhiwa kwenye Keychain. Ikiwa Keychain haipatikani, mradi hutumia faili yenye ruhusa za 0600.

Wateja wa MCP Wanaoungwa Mkono

Kisakinishi kinaunga mkono Claude Code, Claude Desktop, Antigravity, Cursor, Windsurf na Codex. Husasisha tu ingizo la magaza-mcp, huhifadhi usanidi usiohusiana, huunda nakala rudufu ya .magaza-mcp-yedek kabla ya kuandika, na hufanya uandishi wa atomiki.

Washa upya programu zozote za mteja zilizo wazi baada ya usanidi ili ziweze kupakia seva mpya ya MCP.

Thibitisha Usakinishaji

Tumia amri za hali na orodha ya zana kuthibitisha matokeo:

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

durum huripoti maduka yaliyounganishwa, huku araclar ikiweka orodha ya zana zilizosakinishwa. Zana zilizo na alama ✎ zinaweza kurekebisha data ya duka.

Matumizi ya Msingi

Mağaza MCP imekusudiwa kutumiwa kupitia maombi ya lugha asilia katika msaidizi wako anayeoana na MCP. Baada ya mteja kuwashwa upya, anza kwa ombi rahisi la orodha:

Orodhesha programu zangu katika maduka yote mawili na uonyeshe kila moja inachapishwa wapi kwa sasa.

Maduka yote mawili yanapounganishwa, magaza__genel_bakis huunganisha orodha za programu, huoanisha bidhaa zinazolingana za iOS na Android, na kutenganisha programu zinazopatikana katika duka moja pekee.

Linganisha Bei za Usajili

Muulize msaidizi alinganishe usajili kwa nchi fulani:

Usajili wa kila mwezi wa Note Keeper unagharimu kiasi gani katika App Store na Google Play nchini Uturuki? Je, kuna tofauti?

Zana ya magaza__abonelik_karsilastir hulinganisha vitambulisho vya bidhaa, vipindi vya malipo na bei mahususi za nchi. Pia hubadilisha msimbo wa nchi kuwa muundo unaotarajiwa na kila duka.

Tambua Matatizo ya Ununuzi

Kwa mteja aliyelipa lakini hakupata ufikiaji wa vipengele vya kulipia, tumia ombi kama hili:

Mteja anasema amelipa lakini ufikiaji wa vipengele vya kulipia haukuwashwa. Kagua usanidi wa ununuzi katika maduka yote mawili na ufupishe sababu zinazowezekana.

Zana ya magaza__iap_teshis hukagua ikiwa bidhaa zimechapishwa, ikiwa bei ipo katika nchi husika, na ikiwa mpango msingi wa Google Play unapatikana kwa waliojisajili wapya. Ukitoa tokeni ya ununuzi ya Play, zana inaweza kuthibitisha tokeni hiyo kama sehemu ya uchunguzi.

Kagua App Store Connect

Zana mahususi za App Store zinaweza kuorodhesha programu, matoleo, miundo ya TestFlight, maoni, vikundi vya usajili, bei za usajili, ununuzi wa ndani ya programu, vikundi vya TestFlight na ripoti za mauzo. Mifano ya maombi ni pamoja na:

• Ni toleo gani la App Store ambalo kwa sasa limekwama katika ukaguzi?
• Je, muundo wa TestFlight niliopakia jana umemaliza kuchakatwa?
• Fupisha maoni ya nyota moja na nyota mbili ya wiki iliyopita.
• Pakua ripoti ya kila siku ya mauzo ya programu hii.

Metadata ya duka na majibu ya maoni yanaweza pia kubadilishwa, lakini shughuli hizo zinahitaji uthibitisho wa wazi.

Kagua Google Play

Zana za Google Play zinahusu programu, nyimbo za uchapishaji, maoni, usajili, bei za mipango msingi, bidhaa za mara moja, uthibitishaji wa ununuzi, ununuzi uliobatilishwa na viwango vya kuanguka vya Android vitals. Mifano ya maombi ni pamoja na:

• Ni toleo gani liko kwenye wimbo wa uzalishaji, na ni asilimia gani ya watumiaji wanaolipokea?
• Je, kiwango cha kuanguka kimeongezeka katika siku 14 zilizopita?
• Je, tokeni hii ya ununuzi ni halali, na je, usajili bado unaendelea?
• Onyesha ununuzi uliorejeshewa fedha au kubatilishwa kutoka kipindi kinachopatikana.

Google huonyesha takribani maoni ya wiki ya hivi karibuni pekee kupitia API husika. Data ya ununuzi uliobatilishwa ina kikomo cha siku 30 zilizopita.

Tekeleza Shughuli za Kuandika kwa Usalama

Zana kama appstore__yorum_yanitla, appstore__metin_guncelle na play__yorum_yanitla zinaweza kubadilisha data ya duka. Hazitekelezwi mara moja kwenye ombi la kwanza. Badala yake, seva hurejesha hatua inayopendekezwa na mwili wa ombi unaotarajiwa.

Baada ya kukagua pendekezo, liidhinishe na umwombe msaidizi arudie operesheni kwa:

onayla=true

Lango hili la uthibitisho linatekelezwa na seva badala ya kutegemea tu kiolesura cha mteja wa MCP.

Washa Hali ya Kusoma Pekee

Kwa ukaguzi, utoaji wa ripoti au majaribio ya tahadhari, anzisha seva katika hali ya kusoma pekee:

npx magaza-mcp --salt-okunur

Pia unaweza kuweka:

SALT_OKUNUR=1

Maduka yote mawili yanapounganishwa, hali ya kusoma pekee hupunguza orodha iliyo wazi kutoka zana 27 hadi 24. Zana mahususi za kuandika hutoweka ili modeli isiweze kuziona au kuziita. Kisambaza ujumbe cha jumla magaza__cagir hubaki kinapatikana kwa sababu kinahitajika pia kwa shughuli za kusoma, lakini hukataa shughuli za kuandika katika hali ya kusoma pekee.

Tumia Katalogi Kamili ya API

Zana maalum hushughulikia mtiririko wa kawaida wa kazi, lakini Mağaza MCP pia hutoa ufikiaji wa shughuli 1,440 za API. Badala ya kuweka kila shughuli katika muktadha wa modeli, hutoa zana tatu za jumla:

• magaza__endpoint_ara hutafuta katika katalogi za API za maduka yaliyounganishwa na kurejesha majina ya shughuli zinazolingana, mbinu za HTTP, njia na vigezo.
• magaza__sema huonyesha schema ya mwili wa ombi kwa shughuli, jambo linalofaa hasa kabla ya maombi ya POST au PATCH.
• magaza__cagir huita shughuli iliyochaguliwa na kujaza vigezo vya njia kiotomatiki.

Ombi la kina linalofaa ni:

Tafuta katika API ya duka lililounganishwa endpoint inayosimamia rasilimali hii. Nionyeshe schema ya ombi kabla ya kujaribu kuandika chochote.

Katalogi hizi hutengenezwa kutoka kwa vipimo rasmi vya Apple vya App Store Connect OpenAPI na hati za ugunduzi za Android Publisher na Play Developer Reporting za Google. Shughuli za Apple zilizopitwa na wakati hubaki zikatafutika zinapokuwa bado njia pekee ya kutumia uwezo fulani, lakini muhtasari wake huanza na [ESKİMİŞ] na hupewa nafasi ya chini katika matokeo ya utafutaji.

Elewa Utenganishaji wa Zana

Seva huepuka kuchanganya maduka kupitia kanuni kadhaa za muundo:

• Kila zana mahususi ya duka ina kiambishi awali wazi.
• Zana yenye kiambishi awali appstore__ haiiti Google Play kamwe, na zana ya play__ haiiti Apple kamwe.
• Zana za duka ambalo halijachaguliwa hazipakwi kwenye kumbukumbu wala kuonyeshwa kwa modeli.
• Zana za maduka yote mawili huwepo tu maduka yote mawili yanapowashwa.
• Hoja ya magaza inayokubaliwa na zana za usambazaji imewekewa kikomo kwa maduka yaliyosanidiwa wakati wa usakinishaji.

Usakinishaji wa maduka mawili hupakia zana 27. Usakinishaji wa App Store pekee hupakia 14, huku wa Play pekee ukipakia 13. Hii huweka muktadha wa MCP kulingana na mazingira yaliyosanidiwa.

Vidokezo vya Juu vya Usalama

• Usibandike vitambulisho vya kuingia kwenye gumzo: Endesha npx magaza-mcp kur wewe mwenyewe na uweke njia za vitambulisho kupitia mchawi wa ndani.
• Tumia hali ya kusoma tu kwa uchanganuzi: Iwashe unapohitaji tu taarifa za matoleo, ukaguzi, bei, ununuzi au afya ya mfumo.
• Kagua kila uandishi unaopendekezwa: Thibitisha programu, rasilimali, eneo na mwili wa ombi kabla ya kuidhinisha onayla=true.
• Toa ruhusa za kiwango cha chini: Tumia App Manager kwenye Apple isipokuwa mwisho maalum unaohitajika uhitaji ufikiaji zaidi, na punguza akaunti ya huduma ya Google kwa programu husika.
• Weka muda wa mfumo kuwa sahihi: JWT za Apple zina muda wa uhai wa dakika 20, hivyo tofauti kubwa ya saa inaweza kusababisha kushindwa kwa uthibitishaji.

Seva huthibitisha na kusimba vigezo vya njia, hukataa majaribio ya kuvuka saraka kama vile . na .., na huthibitisha wapangishaji wa URL kamili. Mawasiliano ya mtandao yanawekewa kikomo kwenye API ya Apple, Android Publisher API, Play Developer Reporting API na kituo cha mwisho cha tokeni za OAuth cha Google.

Utatuzi wa Matatizo

Apple Inarudisha 401

Thibitisha kuwa Key ID, Issuer ID na faili la .p8 ni vya ufunguo huo huo wa App Store Connect API. Kagua saa ya mashine kwa sababu JWT yenye muda usio sahihi inaweza kukataliwa. Pia thibitisha kuwa faili hilo si ufunguo wa StoreKit au wa arifa zinazotumwa.

Apple Inarudisha 403

Ufunguo wa API huenda hauna jukumu linalohitajika kwa operesheni hiyo. App Manager inatosheleza mitiririko mingi ya kazi, lakini usimamizi wa watumiaji na baadhi ya ripoti huhitaji ruhusa za ziada. Data ya mikataba, kodi na benki haiwezi kupatikana kupitia API bila kujali jukumu.

Google Play Inarudisha 403

Thibitisha kuwa akaunti ya huduma ilialikwa kwenye Play Console na ina ufikiaji wa programu lengwa. Mabadiliko ya ruhusa yanaweza kuchukua dakika kadhaa kuenea. Pia thibitisha kuwa Android Publisher API na Play Developer Reporting API zimewezeshwa katika mradi wa Cloud.

Ikiwa hitilafu inahusu mwisho wa zamani wa inappproducts, programu huenda ikatumia modeli mpya ya bidhaa ya Google. Zana ya play__urunler hushughulikia hili kwa kujaribu oneTimeProducts kwanza na kurejea kwenye modeli ya zamani inapohitajika.

Taarifa za Wimbo Huonekana Polepole

Google Play hutoa taarifa za wimbo wa toleo kupitia kipindi cha uhariri. Zana za kusoma huunda kipindi, husoma data na kukiacha bila kuhifadhi mabadiliko, hivyo hakuna mabadiliko ya duka yanayotokea. Mchakato huu huhitaji maombi ya ziada ya HTTP na kwa hiyo unaweza kuchukua muda mrefu zaidi.

Usanidi wa Maendeleo

Ili kufanyia kazi mradi wenyewe, nakili hazina na usakinishe utegemezi wake:

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 hukusanya msimbo wa chanzo wa TypeScript, npm run kontrol huendesha ukaguzi wa aina bila kutoa faili, na npm run dev huanzisha ukusanyaji wa hali ya ufuatiliaji.

Ili kuzalisha upya katalogi za API kutoka kwenye faili tatu za vipimo zilizo chini ya spec/, endesha:

node scripts/uret-katalog.mjs

Katalogi za operesheni zinazozalishwa huandikwa chini ya src/katalog/; orodha ya operesheni haikusudiwi kudumishwa mwenyewe.

Hitimisho

Mağaza MCP hutoa njia ya kiutendaji ya kuendesha App Store Connect na Google Play kutoka kwa msaidizi mmoja anayeoana na MCP. Zana zake za maduka yote hurahisisha ulinganishaji wa bei, orodha za programu na uchunguzi wa ununuzi, huku katalogi kamili ya API inayoweza kutafutwa ikishughulikia operesheni zisizo za kawaida. Ushughulikiaji wa vitambulisho ndani ya kifaa, vizuizi vya uthibitishaji, hali ya kusoma tu na kutokuwepo kwa ufuatiliaji wa matumizi huifanya ifae kwa mitiririko ya kazi ambapo ufikiaji wa duka lazima ubaki ukidhibitiwa.