mcp-google-merchants

Google Merchant Center MCP

Inglés | Русский

A1 Google Merchant Center MCP conecta una aplicación de IA con tu cuenta de Google Merchant Center. Descubre por qué los productos están rechazados, inspecciona fuentes de datos y promociones, explora informes y precios de mercado, y luego realiza cambios deliberados en los datos de producto cuando lo necesites.

Funciona con los datos de Merchant Center detrás de los anuncios de Shopping: productos, fuentes de datos, promociones e informes. Las campañas, presupuestos y pujas pertenecen a Google Ads y quedan fuera de este servidor.

• 22 herramientas. 15 operaciones solo leen datos de Merchant Center; 5 escriben datos de producto, fuente de datos o promoción; 2 son potencialmente destructivas.
• Tu acceso de Google. El servidor usa tus credenciales OAuth y la Merchant API v1 — no crea una cuenta separada de Merchant Center.
• Cambios conscientes de la fuente. Las entradas de producto y promoción solo pueden modificarse a través de una fuente de datos API. Una fuente de archivo puede volver a obtenerse, pero su contenido no se edita aquí.
• Límites visibles. Las herramientas llevan metadatos de solo lectura, escritura o destructivos, para que un cliente de IA pueda distinguir una inspección de un cambio en vivo.

Comienza con una pregunta de solo lectura:

¿Qué productos están rechazados y qué problemas informa Google para cada uno?

Conectar el servidor · Explorar casos de uso · Abrir documentación técnica

Véalo funcionar en un minuto

Tú: ¿Qué productos están rechazados y qué problemas informa Google para cada uno?

Asistente: Enumera los productos afectados y explica los problemas a nivel de artículo que informa Merchant Center.

Tú: Muestra el precio y la disponibilidad actuales del producto SKU-123, luego prepara una actualización de disponibilidad a in_stock.

Asistente: Muestra la entrada de producto actual, la fuente de datos API a la que pertenece y el cambio exacto a realizar. Pide confirmación antes de actualizar la entrada de producto en vivo.

Tú: Confirma la actualización.

Asistente: Envía la actualización y explica que Merchant Center procesa los datos de producto de forma asíncrona. El producto procesado y su estado de calidad pueden tardar varios minutos en actualizarse.

Contenido

• Inicio rápido
• Qué puedes pedirle que haga
• Cómo se conectan los datos de Merchant Center
• Qué puede cambiar
• Cómo obtener acceso
• Configuración
• Datos y telemetría
• Límites y trabajo en segundo plano
• Documentación técnica
• Soporte

Inicio rápido

Necesitas Node.js 20+, una cuenta de Google Merchant Center y un proyecto de Google Cloud registrado con Merchant Center. Las credenciales OAuth no son necesarias al momento de la instalación — el servidor se conecta desde la conversación; consulta Cómo obtener acceso.

1. Añade el servidor a tu aplicación de IA usando una de las instrucciones a continuación.
2. Di "conectar Google Merchant Center": el asistente te guía a través del cliente OAuth y el consentimiento del navegador, sin archivos de configuración ni reinicios.
3. Haz la primera pregunta de solo lectura anterior.

codex mcp add google-merchants \
  -- npx -y mcp-google-merchants@latest

codex mcp list

claude mcp add \
  --transport stdio \
  --scope user \
  google-merchants \
  -- npx -y mcp-google-merchants@latest

claude mcp list

{
  "mcpServers": {
    "google-merchants": {
      "command": "npx",
      "args": ["-y", "mcp-google-merchants@latest"]
    }
  }
}

{
  "mcpServers": {
    "google-merchants": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-merchants@latest"]
    }
  }
}

{
  "servers": {
    "google-merchants": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-merchants@latest"]
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "google_merchants_client_id",
      "description": "Google OAuth client ID"
    },
    {
      "type": "promptString",
      "id": "google_merchants_client_secret",
      "description": "Google OAuth client secret",
      "password": true
    },
    {
      "type": "promptString",
      "id": "google_merchants_refresh_token",
      "description": "Google OAuth refresh token",
      "password": true
    },
    {
      "type": "promptString",
      "id": "google_merchants_account_id",
      "description": "Merchant Center account ID"
    }
  ]
}

Qué puedes pedirle que haga

Encontrar y comprender problemas del catálogo

• ¿Qué productos están rechazados y qué informa Google para cada uno de ellos?
• Muestra el título, precio, disponibilidad y estado actual del producto SKU-123.
• ¿Qué productos están agotados?
• Muestra los problemas de producto más frecuentes para esta cuenta de Merchant Center.

Explorar rendimiento y precios

• Muestra clics e impresiones por producto para julio.
• ¿Qué productos tienen un precio superior al punto de referencia del mercado en Estados Unidos?
• ¿Qué precios sugiere Google y qué impacto predice?

Las comparaciones y sugerencias de precios requieren la activación gratuita de Market Insights en Merchant Center. Si la cuenta no la ha activado, el servidor explica por qué el informe no tiene filas.

Inspeccionar la cuenta y las fuentes de datos

• Enumera las cuentas de Merchant Center a las que puedo acceder.
• ¿Está reclamada la página de inicio de la tienda? Muestra la configuración de envío actual.
• Enumera las fuentes de datos de producto y promoción, e identifica una fuente de datos API.
• Vuelve a obtener esta fuente de archivo programada ahora.

Realizar cambios deliberados

• Actualiza el precio y la disponibilidad de este producto en su fuente de datos API.
• Crea una fuente de datos API para una nueva fuente de producto.
• Crea o actualiza una promoción y luego verifica su estado de aprobación.

Para cualquier solicitud que cambie datos, primero pide al asistente que muestre la cuenta de destino, la fuente de datos y los campos exactos que planea cambiar.

Cómo se conectan los datos de Merchant Center

Merchant Center mantiene separados los datos entrantes y el estado del producto resultante:

1. Una cuenta contiene fuentes de datos de producto y promoción.
2. Una fuente de datos puede ser una fuente API, un archivo, una hoja de Google, la interfaz de Merchant Center o una fuente automática.
3. Una entrada de producto son los datos de producto proporcionados por una fuente.
4. Un producto procesado es lo que Merchant Center deriva después de procesar esa entrada. Incluye elegibilidad y problemas a nivel de artículo.

El servidor puede leer cada tipo de fuente enumerado. Puede crear fuentes de datos API y actualizar entradas de producto solo en una fuente de datos API; no puede escribir en una fuente de archivo, interfaz o automática. Para encontrar productos por condición, usa una consulta de informe: list_products en sí mismo no proporciona filtrado del lado del servidor.

Qué puede cambiar

El cliente MCP decide cómo te pide confirmación para las herramientas de escritura y destructivas. El servidor marca sus operaciones de solo lectura, escritura y destructivas para que el cliente pueda presentar el límite correcto.

Cómo obtener acceso

El servidor usa la Google Merchant API y el alcance OAuth https://www.googleapis.com/auth/content. Hay dos formas de entregarle credenciales, y la primera no necesita archivos de configuración.

Conectar desde el chat (recomendado)

Di "conectar Google Merchant Center" y el asistente ejecuta el flujo contigo:

1. setup_instructions imprime la lista de verificación: crear o seleccionar un proyecto de Google Cloud, habilitar Merchant API, configurar la pantalla de consentimiento y crear un cliente OAuth de Aplicación de escritorio.
2. Descarga el JSON de ese cliente ("Download JSON") y dale al asistente su ruta — set_client lo almacena solo para el propietario. El secreto nunca pasa por la conversación.
3. start_login devuelve un enlace de consentimiento de Google. Ábrelo en esta máquina y aprueba; el código vuelve a un listener de una sola vez en 127.0.0.1 (PKCE), nunca a través del chat.
4. finish_login intercambia el código, guarda los tokens en ~/.config/mcp-google-merchants/credentials.json (modo 0600) y los verifica con una llamada real a Merchant API — así, un proyecto que aún no está registrado con Merchant Center se detecta allí mismo.

Los tokens se releen en cada llamada, por lo que la conexión funciona de inmediato — sin reiniciar la aplicación de IA. auth_status muestra qué está conectado, logout revoca y elimina. El registro del proyecto de Cloud a continuación sigue siendo necesario: es un paso de Merchant Center, no de OAuth.

Variables de entorno (CI, instalaciones desatendidas)

1. Crea o selecciona un proyecto de Google Cloud, habilita Merchant API y configura la pantalla de consentimiento OAuth.
2. En Google Cloud, crea un cliente OAuth de tipo Aplicación de escritorio. Guarda su ID de cliente y secreto de cliente.
3. Autoriza la cuenta de Google que tiene acceso a tu Merchant Center y obtén un token de actualización para el alcance anterior. El OAuth 2.0 Playground puede ayudar con este paso: activa Use your own OAuth credentials, ingresa el alcance, autoriza y luego intercambia el código por tokens.
4. Encuentra tu ID de cuenta de Merchant Center en Merchant Center y úsalo como GOOGLE_MERCHANTS_ACCOUNT_ID.
5. Registra el proyecto de Google Cloud con Merchant Center una vez. Google requiere una cuenta de Merchant Center de producción con un sitio web verificado y un administrador de cuenta para esta operación. El registro vincula un proyecto de Cloud a la cuenta de Merchant Center; hasta que se complete, las llamadas a Merchant API desde ese proyecto están bloqueadas. Sigue la guía de registro para desarrolladores de Google.

El registro único está disponible a través de la herramienta técnica raw_request, pero es más seguro seguir la guía de Google si esta es tu primera configuración de Merchant API. Google puede tardar hasta cinco minutos en aceptar llamadas después del registro.

Trata el secreto de cliente OAuth y el token de actualización como contraseñas. Se guardan en la configuración del cliente MCP y pueden otorgar acceso a la cuenta de Merchant Center.

Configuración

* Usa el ID de cliente, el secreto de cliente y el token de actualización juntos, o un token de acceso previamente generado. Un token de acceso normalmente caduca en aproximadamente una hora; un token de actualización permite que el servidor obtenga un nuevo token de acceso cuando sea necesario.

Datos y telemetría

El servidor se ejecuta localmente como un proceso iniciado por tu aplicación de IA. Envía solicitudes de Merchant Center a Google y actualiza los tokens de acceso OAuth a través del punto final OAuth de Google.

Envía telemetría de uso anónima para contar instalaciones activas y demanda de herramientas: un ID de instalación aleatorio, versión del paquete, cliente de IA y versiones de Node.js/sistema operativo, y el nombre de la herramienta. Nunca envía ni almacena tokens OAuth, datos de Merchant Center, argumentos de herramientas o indicaciones. Desactiva esta telemetría para servidores MCP A1 con:

ASKADS_TELEMETRY=0

Límites y trabajo en segundo plano

• El procesamiento de Merchant Center es asíncrono. Una entrada de producto recién insertada, actualizada o eliminada puede tardar varios minutos en aparecer en los productos procesados. Los problemas de aprobación de productos y promociones aparecen más tarde, no como un error inmediato de la API.
• Market Insights es opcional. Los informes de competitividad de precios y precios sugeridos devuelven datos solo después de que la cuenta se suscriba al programa gratuito Market Insights.
• Las cuotas dependen de la cuenta y del método de API. Verifica el consumo actual con list_method_quotas; los contadores diarios de Google se restablecen a las 12:00 UTC.
• Los límites temporales se manejan con cautela. Cuando Google devuelve 429, el servidor sigue Retry-After si se proporciona y realiza un número limitado de reintentos. No reproduce una escritura después de un fallo incierto de red o servidor.
• No hay monitoreo en segundo plano. El servidor funciona solo mientras una aplicación de IA lo llama. Si tu aplicación de IA admite tareas programadas, puedes pedirle que verifique problemas de productos o uso de cuotas periódicamente.
• Los problemas agregados de productos tienen una limitación de cuenta. list_product_issues funciona para cuentas independientes y subcuentas, no para cuentas principales avanzadas.

Documentación técnica

• Catálogo de capacidades de MCP — páginas orientadas a tareas para cada herramienta.
• Todas las herramientas y sus entradas
• Documentación de desarrollo
• Documentación de publicación
• Descripción general de la API de Google Merchant
• Autenticación de la API de Google Merchant
• Registro de desarrollador de Google

Soporte

¿Encontraste un error o necesitas un escenario? Crea un problema o escribe en Telegram.

¡Llegaste al final!