سرور MCP داده‌های تجاری (آلفای عمومی)

داده‌های زنده مربوط به حساب مرکز فروش خود را مستقیماً از دستیار کدنویسی مورد نظر خود دریافت کنید. اکنون می‌توانید در محیط توسعه یکپارچه (IDE) یا چارچوب عامل سفارشی خود، با استفاده از سرویس پروتکل زمینه مدل (MCP) به داده‌های مرکز فروش خود دسترسی پیدا کرده و آنها را مدیریت کنید. این سرویس به دستیار یا عامل کدنویسی شما این امکان را می‌دهد که عملیات فقط خواندنی و نوشتن ایمن را روی داده‌های مرکز فروش شما انجام دهد و به آن اجازه می‌دهد تا مشکلات را تشخیص دهد، برنامه‌ها را بررسی کند و گزارش‌ها را با زمینه معتبر و زنده پرس‌وجو کند.

برای اطلاعات بیشتر در مورد خود پروتکل، به استاندارد Model Context Protocol مراجعه کنید.

امنیت و کنترل دسترسی

سرور Merchant Data MCP با اولویت امنیت طراحی شده است:

  • احراز هویت : اجرای ابزار به شدت توسط احراز هویت استاندارد Merchant API اداره می‌شود و به OAuth 2.0 یا اعتبارنامه حساب سرویس نیاز دارد.
  • ایمنی اجرا : با وجود اینکه طرحواره‌های ابزار برای عامل شما به طور گسترده قابل مشاهده هستند، اجرای واقعی هر ابزاری بسیار ایمن باقی می‌ماند و به شدت توسط اعتبارنامه‌های API خاص شما محدود می‌شود.

ملاحظات مهم

قبل از استفاده از این ابزارها، بهترین شیوه‌ها و محدودیت‌های زیر را بررسی کنید:

تغییرات و نسخه‌ها

ما در مورد تغییرات یادداشت‌های انتشار پست خواهیم گذاشت، اما این تغییرات می‌توانند بلافاصله و بدون دوره‌ی منسوخ شدن اعمال شوند.

آزمایش ایمن

توصیه می‌کنیم قبل از استفاده از این ابزارها در یک محیط تولید زنده، ابتدا با استفاده از یک حساب آزمایشی یا یک حساب غیر زنده، آزمایش کنید.

سهمیه مشترک

سرور MCP همان سهمیه‌ای را که فراخوانی‌های استاندارد رابط برنامه‌نویسی کاربردی فروشنده شما از آن استفاده می‌کنند، به اشتراک می‌گذارد. کارگزارهای در حال اجرا می‌توانند به سرعت سهمیه را تمام کنند، به خصوص برای واکشی منابع داده. ما اکیداً توصیه می‌کنیم برای جلوگیری از اختلالات سرویس تولید، از یک حساب آزمایشی استفاده کنید.

فیلتر کردن ابزار و ایمنی

گوگل ممکن است در آینده ابزارهای جدیدی (از جمله قابلیت‌های نوشتن) را به این سرور MCP اضافه کند. برای جلوگیری از اجرای خودکار و ناخواسته ابزارهای جدید یا پرخطر توسط عامل هوش مصنوعی شما، اکیداً توصیه می‌کنیم که کلاینت خود را به جای افشای کل مجموعه ابزارها، به طور صریح برای فیلتر کردن ابزار داخلی پیکربندی کنید.

دامنه و محدودیت‌ها

  • تمرکز فقط خواندنی : به عنوان یک محافظ ایمنی برای این مرحله اولیه، ابزارها به شدت به عملیات فقط خواندنی و ابزارهای نوشتن کم‌خطر (مانند ایجاد منبع داده) محدود شده‌اند.

قابلیت‌های موجود

شما می‌توانید از سرور Merchant Data MCP برای انجام اقدامات زیر به صورت عامل‌محور استفاده کنید:

  • وضعیت دقیق و زمینه گزارش‌دهی را برای محصولات خاص با استفاده از نام دقیق منابع بازیابی کنید .
  • چندین محصول را فهرست و جستجو کنید .
  • داده‌های عملکرد، وضعیت محصولات و بینش‌های قیمت را از طریق گزارش‌های جستجو جستجو کنید .
  • فهرست کردن، ایجاد کردن، واکشی کردن و بررسی وضعیت آپلود منابع داده.
  • مشکلات سطح حساب کاربری که بر دیده شدن محصول یا مشارکت در برنامه تأثیر می‌گذارند را شناسایی کنید .
  • دلایل کلی عدم تایید محصولات را در موجودی خود فهرست کنید .
  • مناطق فعال، الزامات برآورده نشده و وضعیت مشارکت را برای برنامه‌های خاص مرکز بازرگانان بررسی کنید .
  • تنظیمات بهبود خودکار برای اقلام، تصاویر و ارسال را بررسی کنید .

راه‌اندازی

برای اتصال IDE یا دستیار کدنویسی خود به سرور Merchant Data MCP، تنظیمات کلاینت MCP خود را به‌روزرسانی کنید. برای مثال، فایل mcp.json را برای Claude Desktop، Antigravity، Visual Studio Code یا چارچوب عامل سفارشی خود به‌روزرسانی کنید.

راه‌اندازی سرور محلی MCP به یک حساب کاربری سرویس نیاز دارد . کاربر استاندارد OAuth برای این اجرای محلی بدون سر پشتیبانی نمی‌شود . شما باید یک حساب کاربری سرویس ایجاد کنید، فایل کلید خصوصی JSON آن را دانلود کنید و مسیر آن را به همراه شناسه مرکز فروش خاص خود به عنوان آرگومان ارائه دهید.

برای دستورالعمل‌های دقیق در مورد نحوه ایجاد و دانلود یک حساب کاربری سرویس، به راهنمای حساب‌های کاربری سرویس مراجعه کنید.

پیکربندی کلاینت

تنظیمات پیکربندی:

ضد جاذبه

دستورالعمل‌های موجود در مستندات Antigravity را دنبال کنید.

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

دسکتاپ کلود

دستورالعمل‌های موجود در مستندات Claude Desktop را دنبال کنید.

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

سناریوهای استفاده نمونه

سرور MCP داده‌های فروشگاه، نماینده شما را قادر می‌سازد تا با داده‌های زنده مرکز فروشگاه شما تعامل داشته باشد. در اینجا چند سناریوی رایج وجود دارد:

سناریو ۱: تشخیص عدم تایید محصول

شما می‌خواهید بفهمید که چرا یک محصول خاص در نتایج جستجوی گوگل نمایش داده نمی‌شود.

درخواست کاربر:

«چرا محصول من با شناسه پیشنهاد «offer123» تایید نشده است؟»

رفتار عامل با MCP:

  1. عامل برای یافتن وضعیت محصول list_products یا get_product_by_name را فراخوانی می‌کند.
  2. سرور MCP وضعیت محصول، شامل لیستی از issues (برای مثال، «فرمت قیمت نادرست» یا «ارزش ارسال ناموجود») را برمی‌گرداند.
  3. نماینده مشکلات را تجزیه و تحلیل می‌کند و علت اصلی را برای شما توضیح می‌دهد و نحوه رفع آن را پیشنهاد می‌دهد (برای مثال، به‌روزرسانی اطلاعات قیمت).

سناریو ۲: بررسی بهبودهای خودکار

شما می‌خواهید تأیید کنید که آیا بهبودهای ارسال خودکار شما فعال هستند یا خیر.

درخواست کاربر:

«آیا بهبودهای ارسال خودکار من فعال هستند؟»

رفتار عامل با MCP:

  1. عامل get_automatic_improvements را برای بازیابی تنظیمات سطح حساب فراخوانی می‌کند.
  2. سرور MCP پیکربندی را برمی‌گرداند که وضعیت بهبود تصویر، کالا و ارسال را نشان می‌دهد.
  3. نماینده تأیید می‌کند که بهبودهای حمل و نقل فعال هستند، یا در صورت غیرفعال بودن، نحوه فعال کردن آنها را توضیح می‌دهد.

سناریو ۳: معیارهای عملکرد پرس‌وجو

شما می‌خواهید بدون نیاز به پیمایش در رابط کاربری مرکز فروشندگان، عملکرد اخیر خود را به سرعت بررسی کنید.

درخواست کاربر:

«پنج محصول برتر من از نظر تعداد کلیک در هفته گذشته را به من نشان بده.»

رفتار عامل با MCP:

  1. عامل یک پرس‌وجوی زبان پرس‌وجوی مرکز فروشندگان (MCQL) می‌سازد که جدول product_performance_view هدف قرار می‌دهد، بر اساس clicks DESC مرتب می‌کند و به 5 محدود می‌کند.
  2. عامل report_search با پرس‌وجوی ساخته‌شده فراخوانی می‌کند.
  3. سرور MCP پرس و جو را در پایگاه داده گزارش زنده اجرا می‌کند و ردیف‌ها را برمی‌گرداند.
  4. عامل نتایج را در یک جدول Markdown تمیز برای شما قالب‌بندی می‌کند.

فهرست دقیق ابزارهای موجود

سرور MCP ابزارهای زیر را در اختیار نماینده شما قرار می‌دهد:

ابزار MCP توضیحات
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 تنظیمات بهبود خودکار، از جمله به‌روزرسانی‌های اقلام، بهبود تصاویر و بهبودهای ارسال را دریافت کنید.