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

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

Présentation

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

Plus précisément, il permet un accès autorisé à vos données Merchant Center, ainsi qu'aux rapports et insights générés par Google. Il permet d'effectuer des opérations en lecture seule et en écriture limitée pour 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 privilégiant la sécurité :

• Authentification : l'exécution de l'outil 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 possible.
• Sécurité d'exécution : bien que la visibilité des outils ne soit pas limitée pour la découverte agentique, l'exécution des outils 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 mesure de protection.

Remarques importantes

Le service d'accès MCP de l'API Merchant est une version alpha. Sa portée et ses fonctionnalités seront étendues et peuvent changer.

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 de commencer par faire des tests 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 standards à l'API Merchant. Les agents en cours d'exécution peuvent rapidement épuiser le quota, en particulier pour les extractions de sources de données. Nous vous recommandons vivement d'utiliser un compte de test pour éviter les interruptions de service en production.

Filtrage des outils et sécurité

De nouvelles fonctionnalités, en particulier les actions d'écriture, seront ajoutées à l'avenir. Nous vous recommandons vivement de configurer explicitement votre client pour le filtrage des outils intégrés plutôt que d'exposer l'ensemble de l'ensemble d'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 agentique :

• Récupérez le contexte détaillé de l'état et des rapports pour des produits spécifiques à l'aide de noms de ressources exacts.
• Lister et rechercher plusieurs produits.
• Métriques de performance des requêtes, états des produits et insights sur les produits populaires, insights sur les prix, visibilité par rapport aux concurrents et données analytiques sur les affiliés YouTube Shopping.
• Identifiez 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.
• Affichez les raisons agrégées pour lesquelles vos produits ont été refusés dans votre inventaire.
• Vérifiez les paramètres d'amélioration automatique pour les articles, les images et la livraison.
• Consultez 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 vos paramètres 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 du service d'accès MCP de l'API Merchant locale nécessite un compte de service. L'authentification OAuth n'est pas acceptée pour 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 à ce fichier 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 sur les 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 agentiques et des workflows automatisés, considérez 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.

Requête de l'utilisateur :

"Pourquoi mon produit associé à l'ID d'offre 'offer123' a-t-il été 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 leur cause première, en vous suggérant comment les résoudre (par exemple, en mettant à jour les informations sur les prix).

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

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

Requête 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 apportées aux images, aux articles et à la livraison.
3. L'agent confirme que les améliorations de la livraison sont actives 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 parcourir l'UI Merchant Center.

Requête de l'utilisateur :

"Montre-moi mes cinq produits les plus performants en termes de clics la semaine dernière."

Comportement de l'agent avec MCP :

1. L'agent construit une requête MCQL (Merchant Center Query Language) ciblant la table product_performance_view, en effectuant un tri par clicks DESC et en limitant le résultat à 5.
2. L'agent appelle report_search avec la requête construite.
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 pour vous.

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.

Requête 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 éléments.

Outils et descriptions MCP

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