Google Merchant Center MCP

Español | Русский

A1 Google Merchant Center MCP conecta tu aplicación de IA con tu cuenta de Google Merchant Center. Descubre por qué se rechazan productos, inspecciona feeds e informes, explora precios de mercado y realiza cambios deliberados en los datos de los productos cuando lo necesites.

Funciona con los datos de Merchant Center que aparecen en los anuncios de Shopping: productos, fuentes de datos y promociones. Las campañas, los presupuestos y las 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 productos, fuentes de datos o promociones; 2 son potencialmente destructivas.

• Tu acceso a Google. El servidor utiliza tus credenciales OAuth y la API de Merchant v1 — no crea una cuenta separada de Merchant Center.

• Cambios conscientes de la fuente. Las entradas de productos y promociones solo pueden modificarse mediante 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 una escritura, lectura o destructiva 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 desaprobados y qué problemas informa Google para cada uno?

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

Compruébalo en menos de un minuto

Tú: ¿Qué productos están desaprobados 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 en_stock.

Asistente: Muestra la entrada de producto actual, la fuente de datos API a la que pertenece y el cambio exacto para hacer. Pide confirmación antes de actualizar el 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.

Related MCP server: gmc-mcp

Contenido

• Inicio rápido

• Qué se le puede pedir que haga

• Cómo se conecta la fuente de Google Merchant Center

• Qué se puede cambiar

• 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, credenciales OAuth de Google Cloud y un proyecto de Google Cloud registrado en Merchant Center. La configuración del acceso se describe en Obtener acceso.

1. Prepara los cuatro valores: ID de cliente OAuth, secreto de cliente OAuth, token de actualización OAuth y ID de cuenta de Merchant Center.

2. Añade el servidor a tu aplicación de IA con una de las instrucciones de abajo.

3. Haz la primera pregunta de solo lectura de arriba.

En la aplicación:

1. Abre Configuración → Acceso → Servidores MCP.

2. Selecciona Añadir servidor.

3. Añade el comando de inicio: npx -y mcp-google-merchants@latest y las cuatro variables de entorno de abajo.

Desde la línea de comandos:

codex mcp add google-merchants \
  --env GOOGLE_MERCHANTS_CLIENT_ID=your_client_id \
  --env GOOGLE_MERCHANTS_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_MERCHANTS_REFRESH_TOKEN=your_refresh_token \
  --env GOOGLE_MERCHANTS_ACCOUNT_ID=your_merchant_id \
  -- npx -y mcp-google-merchants@latest

Comprueba la conexión:

codex mcp list

Documentación de MCP de Codex

claude mcp add \
  --env GOOGLE_MERCHANTS_CLIENT_ID=your_client_id \
  --env GOOGLE_MERCHANTS_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_MERCHANTS_REFRESH_TOKEN=your_refresh_token \
  --env GOOGLE_MERCHANTS_ACCOUNT_ID=your_merchant_id \
  --transport stdio \
  --scope user \
  google-merchants \
  -- npx -y mcp-google-merchants@latest

Comprueba la conexión:

claude mcp list

Documentación MCP de Claude Code

1. Abre Claude Desktop y ve a Configuración → Desarrollador.

2. Selecciona Editar configuración.

3. Añade el servidor a mcpServers:

{
  "mcpServers": {
    "google-merchants": {
      "command": "npx",
      "args": ["-y", "mcp-google-merchants@latest"],
      "env": {
        "GOOGLE_MERCHANTS_CLIENT_ID": "your_client_id",
        "GOOGLE_MERCHANTS_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_MERCHANTS_REFRESH_TOKEN": "your_refresh_token",
        "GOOGLE_MERCHANTS_ACCOUNT_ID": "your_merchant_id"
      }
    }
  }
}

Si Editar configuración no está disponible, abre el archivo de configuración directamente:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Documentación MCP de Claude Desktop

Añade un servidor a nivel de usuario en ~/.cursor/mcp.json en macOS/Linux o %USERPROFILE%\.cursor\mcp.json en Windows:

{
  "mcpServers": {
    "google-merchants": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-merchants@latest"],
      "env": {
        "GOOGLE_MERCHANTS_CLIENT_ID": "your_client_id",
        "GOOGLE_MERCHANTS_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_MERCHANTS_REFRESH_TOKEN": "your_refresh_token",
        "GOOGLE_MERCHANTS_ACCOUNT_ID": "your_merchant_id"
      }
    }
  }
}

Documentación MCP de Cédice

Ejecuta MCP: Abrir configuración de usuario desde la Paleta de comandos y añade:

{
  "servers": {
    "google-merchants": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-merchants@latest"],
      "env": {
        "GOOGLE_MERCHANTS_CLIENT_ID": "${input:google_merchants_client_id}",
        "GOOGLE_MERCHANTS_CLIENT_SECRET": "${input:google_merchants_client_secret}",
        "GOOGLE_MERCHANTS_REFRESH_TOKEN": "${input:google_merchants_refresh_token}",
        "GOOGLE_MERCHANTS_ACCOUNT_ID": "${input:google_merchants_account_id}"
      }
    }
  },
  "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"
    }
  ]
}

Comprueba el servidor con MCP: Lista de servidores MCP.

Documentación MCP de VS Code

Qué puede pedírsele que haga

Encontrar y sus catálogos de Google Merchant Center

• ¿Qué productos están desaprobados, y qué informa Google de cada uno?

• Muestra el título, el precio, la disponibilidad y el estado actual del producto SKU-123.

• ¿Qué productos están agotados?

• Muestra los problemas de productos más frecuentes para cuenta de Merchant Center.

Explorar rendimiento y precios

• Muestra los clics y las impresiones por producto para julio.

• ¿Qué productos están por encima del punto de referencia del mercado en Estados Unidos?

• ¿Qué precios sugiere Google y qué impacto predice?

Las comparaciones y sugerencias de precios requieren la suscripción gratuita a Market Insights en Merchant Center. Añada la opción, más información. Si la cuenta no lo ha hecho, el servidor no explicará por qué el informe no tiene filas.

Inspeccionar cuenta y fuentes de datos

• Enumera las cuentas de Merchant Center a las que puedes acceder.

• ¿Está reclamada la home 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 este archivo programado ahora.

Hacer cambios deliberados

• Actualiza el precio y la disponibilidad de este producto en su fuente de datos API.

• Crea una fuente de datos API para un nuevo producto.

• Crea o actualiza una promoción y luego comprueba su estado de aprobación.

Para cualquier solicitud que cambie datos, primero pido al asistente que muestre la cuenta de destino, los campos y el cambio exacto que planea hacer.

Cómo se conectan los datos de Google Merchant Center

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

1. Una cuenta contiene fuentes de datos de producto y de promociones.

2. Una fuente de datos puede ser una fuente API, overlo ar o Google Sheets, el interfaz de Merchant Center o un feed automático.

3. Una fruta de productos son los datos de una sola fuente.

4. Un producto procesado es lo que Merchant Center deriva después de procesar esa entrada. Incluye problemas de elegibilidad y de artículos.

El servidor puede dar visto bueno a cada tipo fuente listado. Puede crear fuentes de datos API y actualizar productos solo en una fuente de datos API; puede escribir en un archivo, interfaz o feed automático. Noéder para actualizar. Para buscar productos por condición, usa un informe de consulta: list_products en sí mismo no proporciona ??.

Qué puede cambiar

Una manipuladora de datos MCP decide qué tipo de confirmación pide para escribir borrado. El servidor con su herramienta de solo lectura, escritura o destructivo para pueda mostrar el correcto límite.

Cómo obtener acceso

El servidor necesita la API de Google Merchant y el permiso de OAuth https://www.googleapis.com/auth/content.

1. Crea o selecciona un proyecto de Google Cloud, habilita la API Merchant y configura la pantalla de consentimiento de OAuth.

2. En Google Cloud, crea un cliente OAuth de tipo Aplicación de escritorio. Guarda su ID y secreto de cliente.

3. Autoriza la cuenta de Google que tiene acceso a tu Merchant Center y obtiene un token de actualización para el permiso anterior. El OAuth 2.0 Playground puede ayudar: activa Usar tus propias credenciales OAuth, arroja el permiso, autoriza, luego intercambia el código por tokens.

4. Busca tu ID de cuenta en Merchant Center y úsala como GOOGLE_MERCHANTS_ACCOUNT_ID.

5. Registra el proyecto de Google Cloud con Merchant Center una vez. Google requiere para esta operación una cuenta de Google Merchant Center de producción con un sitio web verificado y un administrador de cuenta. El registro vincula un proyecto de Cloud a la cuenta de Merchant Center; hasta que esté completo,las llamadas de la API de Merchant de ese proyecto quedan bloqueadas. Sigue la guía de registro para desarrolladores de Google.

El registro único se realiza a través del tool raw_request, pero es más seguro seguir la guía de Google si se trata de tu primera instalación de Merchant API. Después del registro, Google puede tardar hasta cinco minutos para aceptar la llamada.

En la aplicación:

1. Abre Configuración → Complementos → Servidores MCP.

2. Selecciona Añadir servidor.

3. Añade el comando de inicio npx -y mcp-google-merchants@latest y las cuatro variables de entorno de abajo.

Desde la línea de comandos:

codex mcp add google-merchants \
  --env GOOGLE_MERCHANTS_CLIENT_ID=your_client_id \
  --env GOOGLE_MERCHANTS_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_MERCHANTS_REFRESH_TOKEN=your_refresh_token \
  --env GOOGLE_MERCHANTS_ACCOUNT_ID=your_merchant_id \
  -- npx -y mcp-google-merchants@latest

Comprueba la conexión:

codex mcp list

Documentación de MCP para Codex

claude mcp add \
  --env GOOGLE_MERCHANTS_CLIENT_ID=your_client_id \
  --env GOOGLE_MERCHANTS_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_MERCHANTS_REFRESH_TOKEN=your_refresh_token \
  --env GOOGLE_MERCHANTS_ACCOUNT_ID=your_merchant_id \
  --transport stdio \
  --scope user \
  google-merchants \
  -- npx -y mcp-google-merchants@latest

Comprueba la conexión:

claude mcp list

Documentación MCP de Claude Code

1. Abre Claude Desktop y ve a Configuración → Desarrollador.

2. Selecciona Editar configuración.

3. Añade el servidor a mcpServers:

{
  "mcpServers": {
    "google-merchants": {
      "command": "npx",
      "args": ["-y", "mcp-google-merchants@latest"],
      "env": {
        "GOOGLE_MERCHANTS_CLIENT_ID": "your_client_id",
        "GOOGLE_MERCHANTS_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_MERCHANTS_REFRESH_TOKEN": "your_refresh_token",
        "GOOGLE_MERCHANTS_ACCOUNT_ID": "your_merchant_id"
      }
    }
  }
}

Si Editar configuración no está disponible, abre el archivo de configuración directamente:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Documentación MCP de Claude Desktop

Añade un servidor a nivel de usuario en ~/.cursor/mcp.json en macOS/Linux o en %USERPROFILE%\.cursor\mcp.json en Windows:

{
  "mcpServers": {
    "google-merchants": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-merchants@latest"],
      "env": {
        "GOOGLE_MERCHANTS_CLIENT_ID": "your_client_id",
        "GOOGLE_MERCHANTS_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_MERCHANTS_REFRESH_TOKEN": "your_refresh_token",
        "GOOGLE_MERCHANTS_ACCOUNT_ID": "your_merchant_id"
      }
    }
  }
}

Documentación de MCP de Cursor

Ejecuta MCP: Abrir configuración de usuario desde la paleta de comandos y añade:

{
  "servers": {
    "google-merchants": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-merchants@latest"],
      "env": {
        "GOOGLE_MERCHANTS_CLIENT_ID": "${input:google_merchants_client_id}",
        "GOOGLE_MERCHANTS_CLIENT_SECRET": "${input:google_merchants_client_secret}",
        "GOOGLE_MERCHANTS_REFRESH_TOKEN": "${input:google_merchants_refresh_token}",
        "GOOGLE_MERCHANTS_ACCOUNT_ID": "${input:google_merchants_account_id}"
      }
    }
  },
  "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"
    }
  ]
}

Comprueba el servidor con MCP: Lista de servidores MCP.

Documentación de MCP de VS Code

Qué se le puede pedir que haga

Encontrar y comprender los problemas de Google Merchant Center

• ¿Qué productos están desaprobados y qué informa Google sobre cada uno de ellos?

• Muestra el título, el precio, la disponibilidad y el 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 el rendimiento y los precios

• Muestra los clics y las impresiones por producto para julio.

• ¿Qué productos están por encima de la referencia en Estados Unidos?

• ¿Qué precios sugiere Google y qué impacto predice?

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

Inspeccionar cuentas y fuentes de datos

• Enumera las cuentas de Merchant Center a las que puedo acceder.

• ¿La página de la tienda está reclamada? Muestra la configuración de envío actual.

• Enumera las fuentes de datos de productos y promociones e identifica una fuente de datos API.

• Vuelve a obtener esta fuente programada de la fuente.

Hacer cambios deliberados

• Actualiza de este producto en su fuente de datos API.

• Crea una fuente de datos API para un nuevo feed de productos.

• Crea o actualiza una promoción y luego comprueba su estado de aprobación.

Para cualquier solicitud que cambia los datos, primero haz que el asistente muestre la cuenta de destino, los campos y el cambio exacto que planea hacer.

conexión de datos de Google Merchant Center

El Google Merchant Center mantiene los datos entrantes y el estado resultante del producto por separado:

1. Una cuenta contiene producto y datos de producto.

2. Una fuente de datos puede ser una fuente API, un archivo, un Google Sheets, la interfaz de Merchant Center o un feed automático.

3. Una entrada de producto es la datos de producto de una sola fuente.

4. Un producto procesado es lo que Merchant Center deriva después de procesar esa entrada. Incluye problemas de elegibilidad y problemas de productos.

El servidor puede leer cada tipo de fuente que se lista. Puede crear fuentes de datos de productos y actualizar una entrada de producto demuestro en una fuente de datos de API; no puede escribir a archivo, interfaz o suministro automático. Para encontrar productos por condición, usa una consulta de informe: list_products no proporciona el servidor.

Qué se puede cambiar

El cliente MCP hace la confirmación que pide para escritura y destructivo. Los servidores y la marca de solo lectura, escritura y destructivo para que el cliente pueda presentar el límite correcto.

Obten acceso

El servidor utiliza la Google Merchant API y elOAuth https://www.googleapis.com/auth/content.

1. Crea oo selecciona un proyecto de Google Cloud, habilita Merchant API y configura la pantalla de consentimiento de OAuth.

2. En Google Cloud, crea un OAuth del tipo Aplicación de escritorio. Guarda su ID y secreto de cliente.

3. Autoriza la cuenta de Google que tiene acceso a tu Merchant Center y obtener un token de actualización para el OAuth anterior. El OAuth 2.0 Playground puede ayudar: activa Usa tus propias credenciales OAuth, introduce el permission, autoriza, y luego cambie el código por los tokens.

4. Encuentra tu ID de cuenta de Merchant Center y úsalo como GOOGLE_MERCHANTS_ACCOUNT_ID.

5. Registra el proyecto de Google Cloud con Merchant Center una vezPage. Se necesita una cuenta de producción y un sitio web verificado y un administrador de cuenta para esta operación. El registro vincula un proyecto de Google Cloud con la cuenta de Merchant Center; hasta que no esté completo, las llamadas de Merchant API de ese proyecto están bloqueadas. Siga la guía de registro para desarrolladores de Google.

El registro de una sola vez se puede realizar a través de la herramienta técnica raw_request, pero es más seguro seguir la guía de Google si es tu primera configuración de Merchant API. Después del registro, Google puede tardar hasta cinco minutos en aceptar llam

En la aplicación:

1. Abre Configuración → Complementos → Servidores MCP.

2. Selecciona Añadir servidor.

3. Añade el comando de lanzamiento npx -y mcp-google-merchants@latest y las cuatro variables de entorno siguientes.

Desde la línea de comandos:

GCP1

Comprueba la conexión:

GCP2

Documentación de MCP de Codex

GCP3

Comprueba la conexión:

GCP4

Documentación de MCP de Claude Code

1. Abre Claude Desktop y ve a Configuración → Desarrollador.

2. Selecciona Editar configuración.

3. Añade el servidor a mcpServers:

GCP5

Si Editar configuración no está disponible, abre el archivo de configuración directamente:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Documentación de MCP de Claude Desktop

Añade un servidor a nivel de usuario en ~/.cursor/mcp.json en macOS o %USERPROFILE%\.cursor\mcp.json en Windows:

GCP6

Documentación de MCP de Cursor

Ejecuta MCP: Abrir configuración de usuario desde la paleta de comandos y añade:

GCP7

Comprueba el servidor con MCP: Lista de servidores MCP.

Documentación de MCP de VS Code

Qué se le puede pedir que haga

Buscar y comprender catálogo en Google Merchant Center

• ¿Qué productos están desaprobados y qué informa Google de cada uno?

• Muestra el título, el precio, la disponibilidad y el 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 el rendimiento y los precios

• Muestra los clics y las impresiones por producto para julio.

• ¿Qué productos están por encima del punto de referencia de precios en Estados Unidos?

• ¿Qué precios sugiere Google y qué impacto prevé?

Las comparaciones y sugerencias de precios requieren que se haya activado la suscripción gratuita de Market Insights en Merchant Center. Si la cuenta es no suscrita, el servidor explica por qué el informe no tiene filas.

Inspeccionar la cuenta y las fuentes

• Enumera las cuentas de Merchant Center a las que puedes acceder.

• ¿Está reclamada la página de inicio de la tienda? Muestra la configuración de envío actual a través de la página.

• Enumera las fuentes de datos de producto y de promoción, e identifica una fuente de datos API.

• Vuelve a obtener esta fuente de datos programada ahora.

Hacer cambios deliberados

• Actualiza el precio y la disponibilidad de este producto en su fuente de datos API.

• Crea una fuente de datos de API para un nuevo feed de productos.

• Crea o actualiza una promoción y revisiones de su estado de aprobación.

Para cualquier solicitud que cambie datos, primero haz que el asistente muestre la cuenta de destino, los campos y la utilidad exacta que la fuente de datos y el cambio propuesto.

Cómo se conectan los datos de Google Merchant Center

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

• Una cuenta contiene productos y fuentes de datos de productos.

• Una fuente de datos puede ser una fuente de API, un archivo, Google Sheets, la interfaz de Merchant Center o un feed automático.

• Una entrada de producto es los datos de producto de una fuente.

• Un producto procesado es lo que Merchant Center obtiene después de procesar esa entrada. Incluye problemas de idonéitérialidad y de producto.

El servidor puede leer todos los tipos de fuentes enumerados. Puede crer fuentes de datos de API y actualizar una entrada de producto en un fuente de datos de API; no puede escribir en un archivo, interfaz o feed automático. Para encontrar productos por condición, usa una consulta de información: list_products en sí no hace servidor.

Qué se puede cambiar

El cliente del MCP lo que hace es pedir una confirmación para operaciones de confirmación y destructivas. Server and the user is able to see the right shows the right boundary.

Cómo obtener acceso

El servidor usa la Google Merchant API y elpermiso de OAuth https://www.googleapis.com/auth/content.

1. Crea oo selecciona un proyecto de Google Cloud, activa Merchant API y configura la pantalla de consentimiento de OAuth.

2. En Google Cloud, crea un cliente OAuth de tipo App de escritorio. Guarda su ID de cliente y su secreto de cliente.

3. Autoriza el con Google que tiene acceso a tu Merchant Center y siguiente de un permiso de actualización para más información. Las OAuth 2.0 Playground pueden ayudar: habilita Usa tus propias credenciales OAuth, escribe el permiso, autoriza y luego cambiar el código por un permiso de actualización.

4. Busca tu ID de cuenta de Merchant Center y úsalo como GOOGLE_MERCHANTS_ACCOUNT_ID.

5. Registra el proyecto de Google Cloud con un solo Merchant Center. Google requiere una cuenta de producción de Merchant Center con un sitio web verificado y un administrador de cuenta para esta operación. El registro enlaza un proyecto de Google Cloud con la cuenta de Merchant Center; hasta que no se complete, las llamadas a la API de Merchant de ese proyecto se bloquean. Sigue la guía de registro para desarrolladores.

El registro se puede hacer una sola vez mediante la herramienta técnica raw_request, pero es más seguro seguir la guía de Google si esta es la primera configuración de la API Merchant. Después del registro, Google puede tardar hasta cinco minutos en aceptarlas llamadas.

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

Configuración

* Use el ID de cliente, el secreto de cliente y el token de actualización juntos, o un token de acceso previamente emitido. Un token de acceso suele caducar en aproximadamente una hora; un token de actualización permite al servidor obtener un nuevo token de acceso cuando sea necesario.

Datos y telemetría

El servidor se ejecuta localmente como un proceso iniciado por su aplicación de IA. Envía solicitudes de Merchant Center a Google y actualiza los tokens de acceso OAuth mediante el punto final de OAuth de Google.

Envía telemetría anónima de uso para contar instalaciones activas y demanda de la herramienta: ID de instalación aleatoria, versión del paquete y del cliente de IA y del sistema operativo/Node.js, y el nombre de la herramienta. Nunca envía ni almacena tokens OAuth, datos de Merchant Center, argumentos de la herramienta ni indicaciones. Para deshabilitar esta telemetría en servidores A1 use:

ASKADS_TELEMETRY=0

Limites 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 de precios sugeridos solo devuelven datos 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. Compruebe el consumo actual con la herramienta 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 cuando se proporciona y hace un número limitado de reintentos. No reenvía una escritura después de una fallo de red o de servidor incierto.

• No hay monitoreo en segundo plano. El servidor solo funciona mientras una aplicación de IA solicita funciones. Si su aplicación de IA admite tareas programadas, puede pedirle que compruebe el estado de los productos o el uso de cuotas periódicamente.

• Los problemas agregados de productos tienen una limitación de la cuenta. list_product_issues funciona para subcuentas y cuentas independientes, no para cuentas parentales 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

• Resumen de la API de Google Merchant

• Autenticación de la API de Google Merchant

• Registro de desarrolladores de Google

Soporte

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