BigGo MCP Server

Um servidor para busca de produtos, rastreamento de histórico de preços e busca de especificações usando a API do BigGo.

Documentação

BigGo MCP Server

PyPI - Python Version PyPI - Version PyPI - License

Introdução

O BigGo MCP Server utiliza APIs do BigGo, um site profissional de comparação de preços.

Recursos

Suporta transportes stdio e SSE

  • Descoberta de Produtos: Pesquise produtos em várias plataformas de e-commerce (Amazon, Aliexpress, Ebay, Taobao, Shopee ... etc.)
  • Rastreamento de Histórico de Preços: Rastreie o histórico de preços de produtos fornecendo a URL do produto ou termos relacionados.
  • Comparação de Especificações [Desativado em versões >= v0.1.28]: Compare e encontre produtos com base em suas especificações, desde informações básicas até especificações técnicas mais complexas.

Instalação

Pré-requisitos

  1. Python >= 3.10
  2. Gerenciador de pacotes uvx (Incluído com uv)
  3. Certificação BigGo (client_id e client_secret) para busca de especificações.

Como obter a certificação BigGo?

  • Registre-se em uma conta BigGo se você não tiver uma.
  • Vá para a Página de Certificação BigGo
  • Clique no botão "Gerar certificação"
  • Generate Certification
  • Copie o client_id e o client_secret
  • Use-os na configuração do MCP Server (BIGGO_MCP_SERVER_CLIENT_ID e BIGGO_MCP_SERVER_CLIENT_SECRET)

Configuração de Instalação

{
  "mcpServers": {
    "biggo-mcp-server": {
      "command": "uvx",
      "args": [ "BigGo-MCP-Server@latest"],
      "env": {
        "BIGGO_MCP_SERVER_CLIENT_ID": "CLIENT_ID",
        "BIGGO_MCP_SERVER_CLIENT_SECRET": "CLIENT_SECRET",
        "BIGGO_MCP_SERVER_REGION": "REGION"
      }
    }
  }
}

Para uma versão específica, use BigGo-MCP-Server@VERSION, ex: BigGo-MCP-Server@0.1.1

Variáveis de Ambiente

VariávelDescriçãoPadrãoOpções
BIGGO_MCP_SERVER_CLIENT_IDID do ClienteNenhumObrigatório para busca de especificações
BIGGO_MCP_SERVER_CLIENT_SECRETSegredo do ClienteNenhumObrigatório para busca de especificações
BIGGO_MCP_SERVER_REGIONRegião para busca de produtosTWUS, TW, JP, HK, SG, MY, IN, PH, TH, VN, ID
BIGGO_MCP_SERVER_SSE_PORTPorta para servidor SSE9876Qualquer número de porta disponível
BIGGO_MCP_SERVER_SERVER_TYPETipo de transporte do servidorstdiostdio, sse

URL SSE padrão: http://localhost:9876/sse

Ferramentas Disponíveis

  • product_search: Busca de produtos com a API de busca do BigGo
  • price_history_graph: Link que visualiza o histórico de preços do produto
  • price_history_with_history_id: Usa IDs de histórico dos resultados de busca de produtos
  • price_history_with_url: Rastreia o histórico de preços usando URLs de produtos
  • spec_indexes: Lista os índices Elasticsearch disponíveis para especificações de produtos
  • spec_mapping: Mostra o mapeamento do índice Elasticsearch com documentos de exemplo
  • spec_search: Consulta especificações de produtos no Elasticsearch
  • get_current_region: Obtém a região atual

FAQ

Como acionar o uso das ferramentas?

Para Descoberta de Produtos relacionado:

Look for Nike running shoes

Para Rastreamento de Histórico de Preços relacionado:

Show me the price history of this product: https://some-product-url

Para Comparação de Especificações relacionado:

Find me phones with 16GB RAM and 1TB storage
Please show me diving watches that can withstand the most water pressure

Build

Consulte build.md para mais detalhes.

Licença

Este projeto é licenciado sob a Licença MIT. Consulte o arquivo LICENSE para detalhes.