Service d'accès MCP de l'API Merchant (alpha)

Utilisez le service d'accès MCP (Model Context Protocol) de l'API Merchant pour obtenir un accès autorisé à vos données et insights Merchant Center afin de créer de nouvelles expériences agentives et des workflows automatisés.

Présentation

Le service d'accès MCP de l'API Merchant fournit un pont standardisé et sécurisé pour les LLM, les agents et les assistants de codage afin de créer et d'orchestrer de nouvelles expériences agentives et des workflows automatisés basés sur les données Merchant Center.

Plus précisément, il permet d'accéder de manière autorisée à vos données Merchant Center, ainsi qu'aux rapports et insights générés par Google pour effectuer des opérations en lecture seule et des opérations d'écriture limitées afin de répondre à des cas d'utilisation tels que :

• Diagnostiquer et corriger les refus de produits
• Générer des rapports et des insights sur les performances
• Examiner l'activation des améliorations automatiques
• Créer et récupérer des sources de données

Sécurité et contrôles d'accès

Le service d'accès MCP de l'API Merchant est conçu en mettant l'accent sur la sécurité :

• Authentification : l'exécution des outils est régie par l'authentification standard de l'API Merchant, qui nécessite des identifiants OAuth 2.0 ou de compte de service. Nous vous recommandons d'utiliser des identifiants avec les droits d'accès les plus restrictifs possibles.
• Sécurité d'exécution : bien que la visibilité des outils ne soit pas limitée pour la découverte agentive, leur exécution est limitée à vos identifiants API spécifiques.
• Mesures de protection : les outils sont strictement limités aux opérations en lecture seule et aux outils d'écriture à faible risque (par exemple, la création de sources de données) en tant que garde-fou de sécurité.

Remarques importantes

Le service d'accès MCP de l'API Merchant est une version alpha. Son champ d'application et ses fonctionnalités seront étendus et pourront être modifiés.

Avant de commencer, consultez les limites et les bonnes pratiques suivantes :

Modifications et versions

Les modifications peuvent être apportées sans préavis et seront publiées dans les notes de version.

Tests sécurisés

Nous vous recommandons d'abord de faire des essais avec un compte de test ou un compte non actif avant d'utiliser ces outils dans un environnement de production actif.

Quota partagé

Le service d'accès MCP de l'API Merchant partage le même pool de quotas que vos appels API Merchant standards. Les agents en cours d'exécution peuvent rapidement épuiser le quota, en particulier pour les récupérations de sources de données. Nous vous recommandons vivement d'utiliser un compte de test pour éviter les interruptions de service en production.

Filtrage et sécurité des outils

De nouvelles fonctionnalités, en particulier des actions d'écriture, seront ajoutées à l'avenir. Nous vous recommandons vivement de configurer explicitement votre client pour le filtrage d'outils intégré plutôt que d'exposer l'ensemble des outils.

Récapitulatif des fonctionnalités disponibles

Vous pouvez utiliser le service d'accès MCP de l'API Merchant pour effectuer les actions suivantes de manière agentive :

• Récupérer l'état détaillé et le contexte de création de rapports pour des produits spécifiques à l'aide de noms de ressources exacts.
• Lister et rechercher plusieurs produits.
• Interroger les métriques de performances, les états des produits et les insights sur les produits populaires, les insights sur les prix, la visibilité des concurrents et les données analytiques des affiliés YouTube Shopping.
• Identifier les problèmes au niveau du compte qui affectent la visibilité des produits ou la participation au programme.
• Lister, créer, récupérer et vérifier l'état d'importation des sources de données.
• Lister les raisons agrégées des refus de produits dans votre inventaire.
• Examiner les paramètres d'amélioration automatique pour les articles, les images et la livraison.
• Vérifier les régions actives, les exigences non satisfaites et l'état de participation pour des programmes Merchant Center spécifiques.

Premiers pas

Pour connecter votre IDE, votre assistant de codage ou votre agent au service d'accès MCP de l'API Merchant, mettez à jour les paramètres de votre client MCP. Par exemple, mettez à jour le fichier mcp.json pour Google Agent Studio, Claude Desktop, Antigravity, Visual Studio Code ou votre framework d'agent personnalisé.

La configuration locale du service d'accès MCP de l'API Merchant nécessite un compte de service. L'authentification OAuth de l'utilisateur standard n'est pas compatible avec cette exécution locale sans interface graphique. Vous devez créer un compte de service, télécharger son fichier de clé privée JSON et fournir le chemin d'accès à celui-ci ainsi que votre ID Merchant Center spécifique en tant qu'arguments.

Pour obtenir des instructions détaillées sur la création et le téléchargement d'un compte de service, consultez le guide Comptes de service.

Configuration du client

Configurations :

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

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

Exemples de scénarios d'utilisation

Pour illustrer comment vous pouvez exploiter le service d'accès MCP de l'API Merchant afin de créer des expériences agentives et des workflows automatisés, examinez les scénarios suivants :

Scénario 1 : Diagnostiquer et corriger les refus de produits

Vous souhaitez comprendre pourquoi un produit spécifique ne s'affiche pas dans les résultats de recherche Google.

Invite de l'utilisateur :

"Pourquoi mon produit avec l'ID d'offre 'offer123' est-il refusé ?"

Comportement de l'agent avec MCP :

1. L'agent appelle list_products ou get_product_by_name pour localiser l'état du produit.
2. Le serveur MCP renvoie l'état du produit, y compris une liste de issues (par exemple, "Format de prix incorrect" ou "Valeur de livraison manquante").
3. L'agent analyse les problèmes et vous explique la cause première, en vous suggérant comment les résoudre (par exemple, en mettant à jour les informations sur le prix).

Scénario 2 : Examiner l'activation des améliorations automatiques

Vous souhaitez vérifier si vos améliorations automatiques de la livraison sont activées.

Invite de l'utilisateur :

"Mes améliorations automatiques de la livraison sont-elles activées ?"

Comportement de l'agent avec MCP :

1. L'agent appelle get_automatic_improvements pour récupérer les paramètres au niveau du compte.
2. Le serveur MCP renvoie la configuration indiquant l'état des améliorations des images, des articles et de la livraison.
3. L'agent confirme que les améliorations de la livraison sont activées ou explique comment les activer si elles sont désactivées.

Scénario 3 : Générer des rapports et des insights sur les performances

Vous souhaitez vérifier rapidement vos performances récentes sans avoir à parcourir l'interface utilisateur de Merchant Center.

Invite de l'utilisateur :

"Affiche-moi mes cinq produits les plus performants par clics la semaine dernière."

Comportement de l'agent avec MCP :

1. L'agent crée une requête en langage de requête Merchant Center (MCQL) ciblant la table product_performance_view, en triant par clicks DESC et en limitant à 5.
2. L'agent appelle report_search avec la requête créée.
3. Le serveur MCP exécute la requête sur la base de données de rapports en direct et renvoie les lignes.
4. L'agent met en forme les résultats dans un tableau Markdown clair.

Scénario 4 : Créer et récupérer des sources de données

Vous souhaitez ajouter une source de données pour importer des mises à jour de produits.

Invite de l'utilisateur :

"Crée une source de données supplémentaire nommée 'price-updates' pour mon compte marchand."

Comportement de l'agent avec MCP :

1. L'agent appelle create_data_source avec les paramètres spécifiés pour enregistrer le nouveau flux.
2. Le serveur MCP crée la source de données et renvoie son nom de ressource unique.
3. L'agent appelle fetch_data_source pour déclencher le téléchargement et le traitement du fichier associé.
4. L'agent appelle get_file_upload pour surveiller la progression de l'importation et confirmer l'état de traitement réussi des articles.

Outils et descriptions MCP

Le service d'accès MCP de l'API Merchant expose les outils suivants à votre agent :