Google Merchant Center a MCP: productos, feeds, problemas de productos, informes de rendimiento e inventario en cualquier agente de IA

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Google Merchant Center, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Google Merchant Center

Gestiona Google Merchant Center desde cualquier agente de IA con la Merchant API v1: productos procesados y entradas de producto, feeds (fuentes de datos), estados y problemas de productos, informes de rendimiento, competitividad de precios y más vendidos en Merchant Center Query Language, inventario local y regional, promociones y notificaciones. Acceso OAuth con Google; las eliminaciones vienen desactivadas al instalar.

Configuración

La configuración lleva unos 15 minutos y se hace una sola vez. Necesitas una cuenta de Merchant Center, un usuario de Google con acceso a ella (Admin para el registro único del proyecto) y un proyecto de Google Cloud. El conector usa la Merchant API v1 (https://merchantapi.googleapis.com), que sustituyó a la Content API for Shopping v2.1: Google la retiró el 18 de agosto de 2026, desde el 1 de septiembre de 2026 sus llamadas fallan cada vez más con HTTP 410 y a principios de 2027 se apagará por completo.

1. Abre https://console.cloud.google.com, elige o crea un proyecto, luego APIs & Services, Library, y activa Merchant API.
2. En APIs & Services, OAuth consent screen elige Internal en Google Workspace; si no, External con el estado de publicación In production. Mientras una app está en Testing, Google revoca sus refresh tokens a los 7 días y el conector deja de funcionar cada semana.
3. En Credentials, Create credentials, OAuth client ID elige el tipo Web application y añade la redirect URI autorizada <your AnythingMCP URL>/api/mcp-oauth/callback, en AnythingMCP Cloud https://cloud.anythingmcp.com/api/mcp-oauth/callback.
4. Pega el client ID en GOOGLE_CLIENT_ID y el client secret en GOOGLE_CLIENT_SECRET. En GOOGLE_MERCHANT_ACCOUNT_ID va el id de la cuenta de Merchant Center: el número que aparece arriba en Merchant Center junto al nombre de la tienda, o el que sigue a a= en su dirección (merchants.google.com/mc/overview?a=123456789). En una cuenta avanzada (multicliente), usa el id de la cuenta avanzada para gestionarla a ella o el id de una subcuenta para esa tienda.
5. En la página del conector haz clic en Authorize with Provider e inicia sesión con una cuenta de Google que sea usuaria de la cuenta de Merchant Center: Admin para la configuración y las escrituras, Standard para productos y feeds, Read only para lecturas (Performance reporting solo cubre los informes de rendimiento).
6. Registra el proyecto de Cloud una sola vez: ejecuta google_merchant_center_register_gcp_project, si quieres con developer_email. Esa cuenta de Google pasa a ser el contacto técnico y recibe el rol de desarrollador de API; si todavía no es usuaria de la cuenta, recibe una invitación que debe aceptar en 14 días. Hasta el registro, cualquier otra llamada responde 401 GCP project with id ... is not registered with the merchant account. Hace falta un usuario Admin, y el registro se hace en la cuenta principal (avanzada o independiente), no en cada subcuenta. google_merchant_center_get_developer_registration muestra los números de proyecto registrados.
7. Ejecuta google_merchant_center_get_account para comprobar la conexión.

El mismo proyecto de Cloud y el mismo cliente OAuth pueden servir a todos los conectores de Google (Gmail, Google Calendar, Google Drive, Google Sheets, Search Console, Analytics, Ads, Merchant Center): activa cada API en ese proyecto, reutiliza GOOGLE_CLIENT_ID y GOOGLE_CLIENT_SECRET y autoriza cada conector una vez.

Scope y cuenta: el conector pide https://www.googleapis.com/auth/content, el único scope de la Merchant API (lectura y escritura). Lo que la IA puede hacer está limitado por el acceso a Merchant Center del usuario que inició sesión; para un agente de solo lectura, inicia sesión con un usuario Read only y desactiva todas las herramientas de insert, update, create, fetch y register. Un conector trabaja con la única cuenta indicada en GOOGLE_MERCHANT_ACCOUNT_ID. google_merchant_center_list_accounts lista todas las cuentas que el usuario puede abrir y google_merchant_center_list_subaccounts las subcuentas de una cuenta avanzada. Para otra cuenta, instala el conector otra vez con ese id.

Qué lee: la cuenta con zona horaria e idioma, los datos de la empresa (dirección, teléfono, atención al cliente), la página principal y si está verificada y reclamada, los problemas de la cuenta con su gravedad, los programas (fichas gratuitas, anuncios de Shopping, fichas locales, checkout) con su elegibilidad, la configuración de envío, las regiones, los usuarios con sus permisos y las cuotas de la API. Los productos procesados, combinados de todas las fuentes de datos, con sus atributos y productStatus por destino y país, incluidos los problemas a nivel de artículo; recuentos de estados por contexto de informe y país con los problemas más frecuentes. Las fuentes de datos (feeds) y el resultado de la última subida de archivo. El inventario local y regional por producto, las promociones con su estado de aprobación y las suscripciones a notificaciones. Informes en Merchant Center Query Language: rendimiento de productos (clics, impresiones, CTR, conversiones), estado y problemas por producto, competitividad de precios y sugerencias de precio (suggested_price), más vendidos y visibilidad frente a la competencia.

Qué escribe: entradas de producto en una fuente de datos de tipo API (google_merchant_center_insert_product_input crea una o la sustituye entera, google_merchant_center_update_product_input cambia los campos indicados en update_mask, por ejemplo product_attributes.price,product_attributes.availability), fuentes de datos (crear, modificar, descargar ahora un feed de archivo), inventario local y regional por tienda o región (un insert sustituye esa entrada), promociones en una fuente de datos de promociones y suscripciones a notificaciones que envían a un callback HTTPS en PRODUCT_STATUS_CHANGE o ACCOUNT_SERVICE_CHANGE. Los productos de feeds de archivo o añadidos desde la interfaz de Merchant Center no se pueden editar aquí; sobrescribe sus atributos con una fuente de datos API complementaria. Los cambios aparecen en google_merchant_center_get_product a los pocos minutos, la aprobación para anuncios y fichas gratuitas puede tardar unos días y Google revisa cada promoción (el programa de Promociones debe estar activo para el país).

Desactivadas al instalar: google_merchant_center_delete_product_input, google_merchant_center_delete_local_inventory, google_merchant_center_delete_regional_inventory y google_merchant_center_delete_notification_subscription. No se pueden deshacer (un producto eliminado pierde su historial y su estado), así que un admin las activa cuando el equipo las necesita.

Formatos de datos: el id de un producto es contentLanguage~feedLabel~offerId, por ejemplo en~US~sku123; los offer id que contienen /, % o ~ se pasan como codificación base64url sin relleno del id completo. Los nombres de recursos son rutas como accounts/123/dataSources/456 y las herramientas toman la última parte como id. Los importes van en micros: {"amountMicros": "19990000", "currencyCode": "EUR"} son 19,99 EUR. Los números grandes (micros, cantidades, ids) llegan como cadenas JSON. Las horas son RFC 3339 en UTC; los valores date de los informes están en la zona horaria de la cuenta. Los nombres de atributos van en camelCase (title, link, imageLink, availability, condition, gtins, brand, mpn, googleProductCategory, salePrice, shipping).

Informes: google_merchant_center_search_reports acepta SELECT fields FROM table WHERE ... ORDER BY ... LIMIT n con nombres de campo en snake_case. Las condiciones solo se combinan con AND (en lugar de OR usa IN) y ORDER BY solo funciona con campos seleccionados. product_performance_view y non_product_performance_view necesitan una condición de fecha como date DURING LAST_30_DAYS y al menos una métrica. Las tablas de más vendidos necesitan report_granularity y report_country_code en el filtro. Las filas llegan como results[], cada una con un objeto que lleva el nombre de la tabla, como productPerformanceView.

Paginación y límites: las herramientas de listado devuelven nextPageToken; la IA vuelve a llamar con page_token hasta que deja de aparecer. google_merchant_center_list_products devuelve por defecto 25 productos por página, como máximo 1000; los informes hasta 100000 filas por página (por defecto 1000). google_merchant_center_list_quotas muestra los límites diarios y por minuto y el uso de hoy por grupo de métodos. Las escrituras de productos están limitadas por día en proporción al tamaño del catálogo: reparte los cambios masivos y prefiere un feed complementario a miles de actualizaciones sueltas.

Errores comunes: 401 GCP project with id ... is not registered significa que falta el paso 6; cualquier otro 401 significa que la autorización caducó o fue revocada (siempre a los 7 días mientras la pantalla de consentimiento está en Testing): vuelve a hacer clic en Authorize with Provider. 403 The caller does not have access to the accounts significa que el usuario no es usuario de esa cuenta o que GOOGLE_MERCHANT_ACCOUNT_ID es incorrecto; 403 Merchant API has not been used in project significa que la API no está activada (paso 1). 400 en una entrada de producto significa que falta un atributo obligatorio o está mal escrito, o que la fuente de datos no es de tipo API. 404 es un id de producto, fuente de datos o promoción desconocido. 429 RESOURCE_EXHAUSTED significa que se agotó la cuota: revisa google_merchant_center_list_quotas y vuelve a intentarlo más tarde.

El conector no gestiona pedidos ni devoluciones, no cambia las políticas de envío o devolución, no crea cuentas ni gestiona usuarios, no lee reseñas de productos y no gestiona campañas de Google Ads (para eso está el conector de Google Ads).

Requisitos previos: GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, GOOGLE_MERCHANT_ACCOUNT_ID

Instalar el conector localmente

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Abre http://localhost:3000/connectors/store, elige Google Merchant Center e introduce las variables listadas en los Requisitos previos.

Herramientas disponibles

Ejemplos de prompts

• "Haz una revisión de salud de la tienda: problemas de la cuenta y cuántos productos están rechazados por país."
• "¿Qué productos no son aptos o están rechazados, y qué tengo que corregir en cada uno?"
• "Muéstrame los 20 productos con más clics en los últimos 30 días, con impresiones y CTR."
• "¿Dónde está mi precio por encima del precio de referencia? Lista los productos con la mayor diferencia."
• "Pon el producto enUSsku123 en OUT_OF_STOCK. Muéstrame el cambio antes de enviarlo."

Siguientes pasos

• Conectar a Claude
• Conectar a ChatGPT