שרת MCP של נתוני מוצרים (אלפא ציבורית)

עכשיו אפשר לקבל נתונים בזמן אמת על חשבון Merchant Center ישירות מהעוזר האישי לתכנות שתבחרו. בסביבת הפיתוח המשולבת (IDE) או במסגרת הסוכן המותאם אישית, אפשר לגשת לנתונים שלכם ב-Merchant Center ולנהל אותם באמצעות שירות Model Context Protocol‏ (MCP). השירות הזה מאפשר לעוזר האישי לתכנות או לסוכן לבצע פעולות קריאה בלבד ופעולות כתיבה בטוחות בנתונים שלכם ב-Merchant Center. כך אפשר לאבחן בעיות, לבדוק תוכניות ולשאול שאלות לגבי דוחות עם הקשר מהימן ועדכני.

מידע נוסף על הפרוטוקול עצמו זמין בתקן Model Context Protocol.

אבטחה ובקרת גישה

השרת של Merchant Data MCP תוכנן כך שאבטחה היא בראש סדר העדיפויות:

  • אימות: ההרצה של הכלי כפופה באופן מוחלט לאימות רגיל של Merchant API, ולכן נדרשים פרטי כניסה של חשבון שירות או OAuth 2.0.
  • בטיחות ההפעלה: למרות שהסכימות של הכלים גלויות לסוכן, ההפעלה בפועל של כל כלי נשארת מאובטחת מאוד ומוגבלת באופן מוחלט על ידי פרטי הכניסה הספציפיים שלכם ל-API.

שיקולים חשובים

לפני שמשתמשים בכלים האלה, כדאי לעיין בשיטות המומלצות ובמגבלות הבאות:

שינויים וגרסאות

אנחנו נפרסם הודעות על שינויים בהערות לגרסה, אבל יכול להיות שהם יקרו באופן מיידי בלי תקופת הוצאה משימוש.

בדיקות בטוחות

לפני שמשתמשים בכלים האלה בסביבת ייצור פעילה, מומלץ להתנסות בהם באמצעות חשבון בדיקה או חשבון לא פעיל.

מכסה משותפת

שרת ה-MCP חולק את אותה מכסת שימוש עם הקריאות הרגילות ל-Merchant API. סוכנים פעילים עלולים לנצל את המכסה במהירות, במיוחד כשמדובר באחזור של מקורות נתונים. מומלץ מאוד להשתמש בחשבון בדיקה כדי למנוע שיבושים בשירות הייצור.

סינון ובטיחות של כלים

יכול להיות ש-Google תוסיף בעתיד כלים חדשים (כולל יכולות כתיבה) לשרת ה-MCP הזה. כדי למנוע מסוכן ה-AI להפעיל באופן אוטומטי ולא מכוון כלים חדשים או מסוכנים, מומלץ מאוד להגדיר באופן מפורש את הלקוח לסינון של כלים מובנים במקום לחשוף את כל ערכת הכלים.

היקף ומגבלות

  • התמקדות בקריאה בלבד: בשלב הראשוני הזה, כהגנה מפני סיכונים, הכלים מוגבלים לפעולות קריאה בלבד ולכלי כתיבה עם סיכון נמוך (כמו יצירת מקור נתונים).

יכולות זמינות

אתם יכולים להשתמש בשרת MCP של נתוני המוכר כדי לבצע את הפעולות הבאות בצורה אוטונומית:

  • אחזור של סטטוס מפורט והקשר של הדיווח לגבי מוצרים ספציפיים באמצעות שמות משאבים מדויקים.
  • רשימה וחיפוש של כמה מוצרים.
  • שאילתות של נתוני ביצועים, סטטוסים של מוצרים ומדדי מחירים באמצעות דוחות חיפוש.
  • הצגה, יצירה, אחזור ובדיקה של סטטוס ההעלאה של מקורות נתונים.
  • זיהוי בעיות ברמת החשבון שמשפיעות על חשיפת המוצרים או על ההשתתפות בתוכנית.
  • רשימת סיבות מצטברות לפסילת מוצרים במלאי.
  • בודקים את האזורים הפעילים, את הדרישות שלא עמדתם בהן ואת סטטוס ההשתתפות בתוכניות ספציפיות של Merchant Center.
  • בודקים את הגדרות השיפור האוטומטי של פריטים, תמונות ומשלוחים.

הגדרה

כדי לחבר את סביבת הפיתוח המשולבת (IDE) או את העוזר האישי לתכנות לשרת ה-MCP של נתוני המוכר, צריך לעדכן את הגדרות הלקוח של ה-MCP. לדוגמה, אפשר לעדכן את הקובץ mcp.json עבור Claude Desktop,‏ Antigravity,‏ Visual Studio Code או מסגרת סוכנים מותאמת אישית.

ההגדרה של שרת MCP מקומי דורשת חשבון שירות. משתמש רגיל לא נתמך OAuth בהרצה מקומית ללא ממשק משתמש. עליכם ליצור חשבון שירות, להוריד את קובץ מפתח ה-JSON הפרטי שלו ולספק את הנתיב אליו יחד עם מספר חשבון Merchant Center הספציפי שלכם כארגומנטים.

הוראות מפורטות ליצירה ולהורדה של חשבון שירות מופיעות במדריך לחשבונות שירות.

הגדרת לקוח

הגדרות תצורה:

Antigravity

פועלים לפי ההוראות במסמכי Antigravity.

{
    "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"
            ]
        }
    }
}

תרחישים לדוגמה לשימוש

שרת ה-MCP של נתוני המוכר מאפשר לסוכן שלכם לבצע אינטראקציה עם נתונים פעילים של Merchant Center. הנה כמה מהתרחישים הנפוצים:

תרחיש 1: אבחון של פסילות מוצרים

אתם רוצים להבין למה מוצר ספציפי לא מופיע בתוצאות החיפוש ב-Google.

הנחיה למשתמש:

"למה המוצר שלי עם מזהה המבצע offer123 נפסל?"

התנהגות הסוכן עם MCP:

  1. הנציג מתקשר אל list_products או אל get_product_by_name כדי לאתר את סטטוס המוצר.
  2. שרת ה-MCP מחזיר את סטטוס המוצר, כולל רשימה של issues (לדוגמה, 'פורמט מחיר שגוי' או 'חסר ערך משלוח').
  3. הסוכן ינתח את הבעיות ויסביר לכם את שורש הבעיה, ויציע לכם איך לפתור אותה (למשל, לעדכן את פרטי המחיר).

תרחיש 2: בדיקת שיפורים אוטומטיים

אתם רוצים לוודא שהשיפור האוטומטי של הערכת זמני משלוח פעיל.

הנחיה למשתמש:

האם הפעלתי את השיפור האוטומטי של הערכת זמני משלוח?

התנהגות הסוכן עם MCP:

  1. הסוכן מתקשר אל get_automatic_improvements כדי לאחזר את ההגדרות ברמת החשבון.
  2. שרת ה-MCP מחזיר את ההגדרה שמציגה את הסטטוס של שיפורי התמונות, הפריטים והמשלוחים.
  3. הנציג יאשר שהשיפורים במשלוח פעילים, או יסביר איך להפעיל אותם אם הם מושבתים.

תרחיש 3: מדדי ביצועים של שאילתות

אתם רוצים לבדוק במהירות את הביצועים האחרונים בלי לנווט בממשק המשתמש של Merchant Center.

הנחיה למשתמש:

‫"Show me my top 5 performing products by clicks last week" ‏(הצגת 5 המוצרים המובילים שלי לפי מספר הקליקים בשבוע שעבר)

התנהגות הסוכן עם MCP:

  1. הסוכן בונה שאילתת Merchant Center Query Language‏ (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 הגדרות לשיפורים אוטומטיים, כולל עדכוני פריטים, שיפורי תמונות ושיפורים של פרטי משלוח.