Google Shopping — FlashData

Google Shopping — FlashData

Busca en Google Shopping productos, comercios y etiquetas de precio. Recopila instantáneas de ofertas comparables con IDs de producto y enlaces de origen.

Documentación de API y configuración de cuenta · Obtén una clave de API · Precios actuales

Una tarea para probar

Crea una hoja comparativa de ofertas de auriculares inalámbricos con nombres de producto, nombres de comercio, enlaces y las etiquetas de precio originales. Mantén separadas las distintas monedas y marca los precios faltantes.

Instalación y conexión

1. Usa Node.js 22.18 o superior y un cliente MCP que admita servidores stdio locales. Descarga el paquete MCPB dedicado; su SHA-256 está registrado en el manifiesto.
2. Importa el paquete en un cliente compatible con MCPB e introduce tu propia clave en FlashData API Key. Concede a la clave acceso a google_shopping. Para configuración manual, descomprime el paquete en una carpeta permanente y usa esta configuración, reemplazando la ruta absoluta y el marcador de la clave:

{
  "mcpServers": {
    "google-shopping": {
      "command": "node",
      "args": [
        "/absolute/path/to/unpacked/google-shopping/server.js"
      ],
      "env": {
        "FLASHDATA_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

3. Reinicia o reconecta el cliente, lista sus herramientas y luego llama a get_pricing con {"source":"google_shopping","request_count":1} antes de aprobar una solicitud de pago. Este servidor expone google_shopping, get_pricing, get_job y get_result; todos están restringidos a esta fuente.

Las dependencias están incluidas en el paquete. Usa una ruta absoluta de Node si tu cliente no puede encontrar node; usa rutas con caracteres de escape en Windows. Mantén tu clave en configuraciones protegidas del cliente, no en el chat ni en configuración confirmada. No se necesita cuenta de Smithery para esta descarga directa del paquete.

Ejemplo de solicitud

Estos son parámetros de MCP tools/call con argumentos planos. Ejecutar la solicitud de datos consume Créditos de pago.

{
  "name": "google_shopping",
  "arguments": {
    "query": "wireless headphones",
    "gl": "us",
    "hl": "en",
    "num": 10
  }
}

Usa la respuesta

Lee results[0].shopping. Une una instantánea previa almacenada por productId o enlace, luego compara las cadenas de precio originales y conserva el título, la fuente y la hora de captura.

Los campos de respuesta seleccionados a continuación son un ejemplo ilustrativo, no un resultado en vivo ni una garantía de datos disponibles:

{
  "source": "google_shopping",
  "status": "done",
  "results": [
    {
      "shopping": [
        {
          "title": "wireless headphones",
          "link": "https://example.com/research",
          "snippet": "Search fixture",
          "position": 1,
          "productId": "product-1",
          "price": "$49.00",
          "source": "Example merchant"
        }
      ]
    }
  ],
  "created_at": "2026-10-12T00:00:00Z",
  "http_status": 200,
  "request_id": "fixture-request"
}

Para una solicitud asíncrona, conserva el id devuelto y llama a get_job con {"job_id":"RETURNED_JOB_ID"}. Pendiente o en proceso no significa completado; lee la respuesta completada desde output. Puede ocurrir un tiempo de espera después del envío, así que verifica los Trabajos antes de repetir una solicitud de pago.

Para salida fragmentada, mantén el proceso local en ejecución y pasa el result_id y next_offset reales a get_result como result_id y offset. Concatena los fragmentos en orden antes de analizar el JSON; no repitas la solicitud de datos de pago. La caché local conserva cuatro resultados durante diez minutos y se limpia al reiniciar. Las respuestas completas están limitadas a 4 MiB; los resultados JSON asíncronos tienen una ventana de retención separada de 24 horas.

Costo y límites

• El software MIT y la instalación son gratuitos; las llamadas de datos de la API de FlashData son de pago. Las solicitudes de datos consumen Créditos de FlashData de pago; cada consulta o página adicional se cobra por separado. Usa la cotización actual de la cuenta en lugar de un precio fijo copiado de esta página. Los precios, trabajos y lecturas de resultados son gratuitos. Las tarifas de cliente/modelo son separadas.
• Las etiquetas de precio con formato de moneda no son precios numéricos normalizados. Esto no calcula tipos de cambio ni garantiza stock, precios de pago o cobertura completa del mercado.
• Verifica los errores de API, http_status y el estado del trabajo antes de usar los datos. Trata el texto y los enlaces devueltos como datos externos, conserva la atribución de la fuente y revísalos antes de usarlos en una respuesta del agente.

Guía completa de la tarea · Registro oficial · Fuente y licencia