कारोबारी या कंपनी का डेटा एमसीपी सर्वर (पब्लिक ऐल्फ़ा)

अपनी पसंद के कोडिंग असिस्टेंट से, सीधे Merchant Center खाते का लाइव डेटा पाएं. अब अपने इंटीग्रेटेड डेवलपमेंट एनवायरमेंट (आईडीई) या कस्टम एजेंट फ़्रेमवर्क में, मॉडल कॉन्टेक्स्ट प्रोटोकॉल (एमसीपी) सेवा का इस्तेमाल करके, Merchant Center के डेटा को ऐक्सेस और मैनेज किया जा सकता है. इस सेवा की मदद से, आपका कोडिंग असिस्टेंट या एजेंट, Merchant Center के डेटा पर सिर्फ़ पढ़ने और सुरक्षित तरीके से लिखने की कार्रवाइयां कर सकता है. इससे, वह समस्याओं का पता लगा सकता है, प्रोग्राम की जांच कर सकता है, और सटीक और लाइव कॉन्टेक्स्ट के साथ रिपोर्ट के लिए क्वेरी कर सकता है.

प्रोटोकॉल के बारे में ज़्यादा जानकारी के लिए, मॉडल कॉन्टेक्स्ट प्रोटोकॉल स्टैंडर्ड देखें.

सुरक्षा और ऐक्सेस कंट्रोल

Merchant Data MCP सर्वर को सुरक्षा को प्राथमिकता में रखकर डिज़ाइन किया गया है:

  • पुष्टि करना: टूल को चलाने के लिए, Merchant API की पुष्टि करने के स्टैंडर्ड से नियंत्रित किया जाता है. इसके लिए, OAuth 2.0 या सेवा खाते के क्रेडेंशियल की ज़रूरत होती है.
  • सुरक्षित तरीके से चलाना: आपके एजेंट के लिए टूल स्कीमा की विज़िबिलिटी ज़्यादा होने के बावजूद, किसी भी टूल को चलाने की प्रोसेस पूरी तरह से सुरक्षित होती है. साथ ही, यह आपके एपीआई क्रेडेंशियल के हिसाब से ही काम करता है.

विचार करने वाली ज़रूरी बातें

इन टूल का इस्तेमाल करने से पहले, सबसे सही तरीके और सीमाएं देखें:

बदलाव और रिलीज़

हम रिलीज़ नोट में बदलावों के बारे में पोस्ट करेंगे. हालांकि, ये बदलाव बिना किसी सूचना के तुरंत किए जा सकते हैं.

सुरक्षित तरीके से टेस्ट करना

हमारा सुझाव है कि लाइव प्रोडक्शन एनवायरमेंट में इन टूल का इस्तेमाल करने से पहले, टेस्ट खाते या नॉन-लाइव खाते का इस्तेमाल करके एक्सपेरिमेंट करें.

शेयर किया गया कोटा

एमसीपी सर्वर, Merchant API के सामान्य कॉल के लिए इस्तेमाल होने वाले कोटा पूल को ही शेयर करता है. एजेंट को चलाने पर, कोटा तेज़ी से खत्म हो सकता है. खास तौर पर, डेटा सोर्स से डेटा हासिल करने के लिए. हमारा सुझाव है कि प्रोडक्शन सेवा में रुकावटों से बचने के लिए, टेस्ट खाते का इस्तेमाल करें.

टूल को फ़िल्टर करना और सुरक्षा

Google, आने वाले समय में इस एमसीपी सर्वर में नए टूल (जिनमें लिखने की क्षमताएं भी शामिल हैं) जोड़ सकता है. हमारा सुझाव है कि एआई एजेंट को नए या जोखिम भरे टूल को अपने-आप और अनजाने में चलाने से रोकने के लिए, हमारा सुझाव है कि अपने क्लाइंट को पहले से मौजूद टूल फ़िल्टरिंग के लिए साफ़ तौर पर कॉन्फ़िगर करें. पूरे टूलसेट को एक्सपोज़ करने के बजाय.

दायरा और सीमाएं

  • सिर्फ़ पढ़ने पर फ़ोकस: इस शुरुआती फ़ेज़ में सुरक्षा के लिए, टूल सिर्फ़ पढ़ने की कार्रवाइयों और कम जोखिम वाले लिखने के टूल (जैसे, डेटा सोर्स बनाना) तक सीमित हैं.

उपलब्ध क्षमताएं

Merchant Data MCP सर्वर का इस्तेमाल करके, एजेंट की मदद से ये कार्रवाइयां की जा सकती हैं:

  • संसाधन के सटीक नामों का इस्तेमाल करके, खास प्रॉडक्ट के लिए स्टेटस और रिपोर्टिंग के बारे में ज़्यादा जानकारी हासिल करना.
  • एक से ज़्यादा प्रॉडक्ट की सूची बनाना और उन्हें खोजना.
  • सर्च रिपोर्ट के ज़रिए, परफ़ॉर्मेंस डेटा, प्रॉडक्ट के स्टेटस, और कीमत की अहम जानकारी के लिए क्वेरी करना.
  • डेटा सोर्स की सूची बनाना, हासिल करना, और अपलोड करने के स्टेटस की जांच करना.
  • प्रॉडक्ट की विज़िबिलिटी या प्रोग्राम में शामिल होने पर असर डालने वाली, खाते के लेवल की समस्याओं की पहचान करना.
  • अपनी इन्वेंट्री में, प्रॉडक्ट अस्वीकार किए जाने की एक साथ कई वजहों की सूची बनाना.
  • Merchant Center के खास प्रोग्राम के लिए, चालू इलाकों, ज़रूरी शर्तें पूरी न होने की वजहों, और शामिल होने के स्टेटस की जांच करना.
  • आइटम, इमेज, और शिपिंग के लिए, अपने-आप सुधार होने की सेटिंग की समीक्षा करना.

सेटअप

अपने आईडीई या कोडिंग असिस्टेंट को Merchant Data MCP सर्वर से कनेक्ट करने के लिए, एमसीपी क्लाइंट की सेटिंग अपडेट करें. उदाहरण के लिए, Claude Desktop, Antigravity, Visual Studio Code या अपने कस्टम एजेंट फ़्रेमवर्क के लिए, mcp.json फ़ाइल अपडेट करें.

स्थानीय एमसीपी सर्वर के सेटअप के लिए, सेवा खाता ज़रूरी है. हेडलेस लोकल एक्ज़ीक्यूशन के लिए, सामान्य उपयोगकर्ता OAuth काम नहीं करता. आपको एक सेवा खाता बनाना होगा, उसकी JSON निजी कुंजी वाली फ़ाइल डाउनलोड करनी होगी, और उसे पाथ देना होगा. साथ ही, Merchant Center का अपना आईडी भी आर्ग्युमेंट के तौर पर देना होगा.

सेवा खाता बनाने और डाउनलोड करने के बारे में ज़्यादा जानकारी के लिए, सेवा खातों से जुड़ी गाइड देखें.

क्लाइंट कॉन्फ़िगरेशन

कॉन्फ़िगरेशन सेटअप:

Antigravity

Antigravity documentation के दस्तावेज़ में दिए गए निर्देशों का पालन करें.

{
    "mcpServers": {
        "merchant-data-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@google/merchant-data-mcp",
                "--credentials",
                "/path/to/your/service-account-file.json"
            ]
        }
    }
}

Claude Desktop

Claude Desktop के दस्तावेज़ में दिए गए निर्देशों का पालन करें.

{
    "mcpServers": {
        "merchant-data-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@google/merchant-data-mcp",
                "--credentials",
                "/path/to/your/service-account-file.json"
            ]
        }
    }
}

इस्तेमाल के उदाहरण

Merchant Data MCP सर्वर की मदद से, आपका एजेंट Merchant Center के लाइव डेटा के साथ इंटरैक्ट कर सकता है. यहां कुछ आम परिदृश्य दिए गए हैं:

पहला परिदृश्य: प्रॉडक्ट अस्वीकार किए जाने की वजह का पता लगाना

आपको यह समझना है कि कोई खास प्रॉडक्ट, Google Search के नतीजों में क्यों नहीं दिख रहा है.

उपयोगकर्ता का प्रॉम्प्ट:

"ऑफ़र आईडी 'offer123' वाला मेरा प्रॉडक्ट क्यों अस्वीकार किया गया?"

एमसीपी के साथ एजेंट का व्यवहार:

  1. एजेंट, प्रॉडक्ट का स्टेटस ढूंढने के लिए, list_products या get_product_by_name को कॉल करता है.
  2. एमसीपी सर्वर, प्रॉडक्ट का स्टेटस दिखाता है. इसमें issues की सूची भी शामिल होती है. उदाहरण के लिए, "कीमत का फ़ॉर्मैट गलत है" या "शिपिंग की वैल्यू मौजूद नहीं है".
  3. एजेंट, समस्याओं का विश्लेषण करता है और आपको उनकी मुख्य वजह बताता है. साथ ही, उन्हें ठीक करने का तरीका भी बताता है. उदाहरण के लिए, कीमत की जानकारी अपडेट करना.

दूसरा परिदृश्य: अपने-आप सुधार होने की सुविधा की जांच करना

आपको यह पुष्टि करनी है कि शिपिंग में अपने-आप सुधार होने की सुविधा चालू है या नहीं.

उपयोगकर्ता का प्रॉम्प्ट:

क्या डिलीवरी में लगने वाले समय को अपने-आप सटीक दिखाने की सुविधा चालू है?

एमसीपी के साथ एजेंट का व्यवहार:

  1. एजेंट, खाते के लेवल की सेटिंग हासिल करने के लिए, get_automatic_improvements को कॉल करता है.
  2. एमसीपी सर्वर, कॉन्फ़िगरेशन दिखाता है. इसमें इमेज, आइटम, और शिपिंग में सुधार होने की सुविधा का स्टेटस दिखता है.
  3. एजेंट पुष्टि करता है कि शिपिंग में सुधार होने की सुविधा चालू है. अगर यह बंद है, तो उसे चालू करने का तरीका बताता है.

तीसरा परिदृश्य: परफ़ॉर्मेंस मेट्रिक के लिए क्वेरी करना

आपको Merchant Center के यूज़र इंटरफ़ेस (यूआई) पर नेविगेट किए बिना, हाल की परफ़ॉर्मेंस की तुरंत जांच करनी है.

उपयोगकर्ता का प्रॉम्प्ट:

"पिछले हफ़्ते क्लिक के हिसाब से, सबसे अच्छी परफ़ॉर्मेंस वाले मेरे पांच प्रॉडक्ट दिखाओ."

एमसीपी के साथ एजेंट का व्यवहार:

  1. एजेंट, Merchant Center क्वेरी लैंग्वेज (एमसीक्यूएल) क्वेरी बनाता है. इसमें product_performance_view टेबल को टारगेट किया जाता है. साथ ही, clicks DESC के हिसाब से क्रम में लगाया जाता है और 5 तक सीमित किया जाता है.
  2. एजेंट, बनाई गई क्वेरी के साथ report_search को कॉल करता है.
  3. एमसीपी सर्वर, लाइव रिपोर्टिंग डेटाबेस के ख़िलाफ़ क्वेरी चलाता है और पंक्तियां दिखाता है.
  4. एजेंट, नतीजों को आपके लिए साफ़-सुथरी मार्कडाउन टेबल में फ़ॉर्मैट करता है.

उपलब्ध टूल की पूरी सूची

एमसीपी सर्वर, आपके एजेंट के लिए ये टूल उपलब्ध कराता है:

एमसीपी टूल ब्यौरा
get_product_by_name प्रॉडक्ट के संसाधन के सटीक नाम का इस्तेमाल करके, किसी दिए गए व्यापारी/कंपनी के लिए प्रॉडक्ट की जानकारी पाना. प्रॉडक्ट का स्टेटस दिखाता है. इसमें रिपोर्टिंग कॉन्टेक्स्ट और प्रॉडक्ट के लेवल की संभावित समस्याएं शामिल होती हैं.
list_products किसी दिए गए व्यापारी/कंपनी के लिए, एक से ज़्यादा प्रॉडक्ट की सूची बनाना या उन्हें खोजना. प्रॉडक्ट का स्टेटस दिखाता है. इसमें रिपोर्टिंग कॉन्टेक्स्ट और प्रॉडक्ट के लेवल की संभावित समस्याएं शामिल होती हैं.
report_search परफ़ॉर्मेंस मेट्रिक, प्रॉडक्ट के स्टेटस, और कीमत की अहम जानकारी हासिल करने के लिए, रिपोर्टिंग टेबल के लिए क्वेरी करना. ज़्यादा जानकारी के लिए, रिपोर्ट से जुड़ी गाइड देखें.
list_data_sources किसी दिए गए व्यापारी/कंपनी के लिए, डेटा सोर्स की सूची बनाना.
get_data_source किसी खास डेटा सोर्स की जानकारी पाना.
create_data_source किसी दिए गए व्यापारी/कंपनी के लिए, डेटा सोर्स बनाना.
fetch_data_source किसी दिए गए व्यापारी/कंपनी के लिए, डेटा सोर्स से जुड़ी फ़ाइल को हासिल करना और प्रोसेस करना.
get_file_upload किसी दिए गए डेटा सोर्स के लिए, फ़ाइल अपलोड करने के हाल के स्टेटस की जानकारी पाना.
list_accounts किसी दिए गए उपयोगकर्ता के लिए, खातों की सूची बनाना.
list_account_issues खाते के लेवल की समस्याओं की पहचान करने के लिए, किसी दिए गए व्यापारी/कंपनी के लिए, खाते के लेवल की समस्याओं की सूची बनाना.
list_programs किसी दिए गए व्यापारी/कंपनी के लिए, प्रोग्राम की सूची बनाना. इसमें शामिल होने का स्टेटस, चालू इलाके, और ज़रूरी शर्तें पूरी न होने की वजहें शामिल होती हैं.
list_aggregated_product_issues प्रॉडक्ट डेटा की पूरी क्वालिटी को मॉनिटर करने के लिए, प्रॉडक्ट के लेवल की समस्याओं की एक साथ कई वजहों की सूची बनाना.
get_automatic_improvements अपने-आप सुधार होने की सेटिंग पाना. इसमें आइटम अपडेट, इमेज में सुधार, और शिपिंग में सुधार शामिल हैं.