Merchant API MCP Access Service (אלפא)

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

סקירה כללית

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

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

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

אמצעי בקרה לגישה ולאבטחה

שירות הגישה ל-MCP של Merchant API מתוכנן עם דגש על אבטחה:

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

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

שירות הגישה MCP של Merchant API הוא גרסת אלפא. ההיקף והיכולות שלו יורחבו ועשויים להשתנות.

לפני שמתחילים, חשוב לקרוא את המגבלות הבאות ואת השיטות המומלצות:

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

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

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

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

מכסת אחסון משותפת

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

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

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

סיכום היכולות הזמינות

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

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

תחילת העבודה

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

ההגדרה של שירות הגישה של Merchant API 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"
            ]
        }
    }
}

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

כדי להמחיש איך אפשר להשתמש בשירות הגישה של Merchant API MCP כדי ליצור פעולות מבוססות-AI ותהליכי עבודה אוטומטיים, הנה כמה תרחישים:

תרחיש 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 מסודרת בשבילכם.

תרחיש 4: יצירה ואחזור של מקורות נתונים

אתם רוצים להוסיף מקור נתונים חדש כדי להעלות עדכונים למוצרים.

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

‫"Create a supplemental data source named 'price-updates' for my merchant account."

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

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

כלי MCP ותיאורים

שירות הגישה ל-MCP של Merchant API חושף את הכלים הבאים לסוכן:

כלי 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_aggregate_product_statuses רשימה של בעיות מצטברות ברמת המוצר, כדי לעקוב אחרי המצב הכללי של נתוני המוצרים.
get_automatic_improvements הגדרות לשיפורים אוטומטיים, כולל עדכוני פריטים, שיפורי תמונות ושיפורים של פרטי משלוח.