Google Shopping — FlashData

Google Shopping — FlashData

Pesquise no Google Shopping por produtos, comerciantes e etiquetas de preço. Colete instantâneos comparáveis de ofertas com IDs de produto e links de origem.

Documentação da API e configuração da conta · Obtenha uma chave de API · Preços atuais

Uma tarefa para experimentar

Crie uma planilha comparativa de ofertas de fones de ouvido sem fio com nomes de produtos, nomes de comerciantes, links e as etiquetas de preço originais. Mantenha moedas diferentes separadas e sinalize preços ausentes.

Instalação e conexão

1. Use Node.js 22.18 ou mais recente e um cliente MCP que suporte servidores stdio locais. Baixe o pacote MCPB dedicado; seu SHA-256 está registrado no manifesto.
2. Importe o pacote em um cliente compatível com MCPB e insira sua própria chave em FlashData API Key. Conceda à chave acesso a google_shopping. Para configuração manual, descompacte o pacote em uma pasta permanente e use esta configuração, substituindo o caminho absoluto e o espaço reservado da chave:

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

3. Reinicie ou reconecte o cliente, liste suas ferramentas e então chame get_pricing com {"source":"google_shopping","request_count":1} antes de aprovar uma solicitação paga. Este servidor expõe google_shopping, get_pricing, get_job e get_result; todos estão restritos a esta fonte.

As dependências estão incluídas no pacote. Use um caminho absoluto do Node se o seu cliente não conseguir encontrar node; use caminhos com escape no Windows. Mantenha sua chave em configurações protegidas do cliente, não no chat ou em configuração commitada. Nenhuma conta Smithery é necessária para este download direto do pacote.

Exemplo de solicitação

Estes são parâmetros MCP tools/call com argumentos simples. Executar a solicitação de dados consome Créditos pagos.

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

Use a resposta

Leia results[0].shopping. Junte um instantâneo anterior armazenado por productId ou link, depois compare as strings de preço originais e retenha título, fonte e horário de captura.

Os campos de resposta selecionados abaixo são uma amostra ilustrativa, não um resultado ao vivo ou uma garantia de dados disponíveis:

{
  "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 uma solicitação assíncrona, mantenha o id retornado e chame get_job com {"job_id":"RETURNED_JOB_ID"}. Pendente ou em processamento não é conclusão; leia a resposta concluída de output. Um timeout pode ocorrer após o envio, então verifique os Jobs antes de repetir uma solicitação paga.

Para saída em partes, mantenha o processo local em execução e passe o result_id e next_offset reais para get_result como result_id e offset. Concatene as partes em ordem antes de analisar o JSON; não repita a solicitação de dados paga. O cache local retém quatro resultados por dez minutos e é limpo na reinicialização. Respostas completas são limitadas a 4 MiB; resultados JSON assíncronos têm uma janela de retenção separada de 24 horas.

Custo e limites

• O software MIT e a instalação são gratuitos; chamadas de dados da API FlashData são pagas. Solicitações de dados consomem Créditos FlashData pagos; cada consulta ou página adicional é cobrada separadamente. Use a cotação atual da conta em vez de um preço fixo copiado desta página. Preços, leituras de trabalho e resultados são gratuitos. Taxas de cliente/modelo são separadas.
• Etiquetas de preço formatadas com moeda não são preços numéricos normalizados. Isso não calcula taxas de câmbio nem garante estoque, preços de checkout ou cobertura completa do mercado.
• Verifique erros da API, http_status e status do trabalho antes de usar os dados. Trate texto e links retornados como dados externos, preserve a atribuição da fonte e revise-os antes de usar em uma resposta do agente.

Guia completo da tarefa · Registro Oficial · Fonte e licença