BigGo MCP Server

Un servidor para búsqueda de productos, seguimiento del historial de precios y búsqueda de especificaciones utilizando la API de BigGo.

Documentación

Servidor MCP de BigGo

PyPI - Python Version PyPI - Version PyPI - License

Introducción

El Servidor MCP de BigGo utiliza las APIs de BigGo, un sitio web profesional de comparación de precios.

Características

Soporta transportes stdio y SSE

  • Descubrimiento de Productos: Busca productos en múltiples plataformas de comercio electrónico (Amazon, Aliexpress, Ebay, Taobao, Shopee ... etc.)
  • Seguimiento de Historial de Precios: Rastrea el historial de precios de productos proporcionando la URL del producto o términos relacionados.
  • Comparación de Especificaciones [Deshabilitado en versiones >= v0.1.28]: Compara y encuentra productos según sus especificaciones, desde información básica hasta especificaciones técnicas más complejas.

Instalación

Requisitos previos

  1. Python >= 3.10
  2. Administrador de paquetes uvx (Incluido con uv)
  3. Certificación de BigGo (client_id y client_secret) para la búsqueda de especificaciones.

¿Cómo obtener la certificación de BigGo?

  • Regístrate en una cuenta de BigGo si no tienes una.
  • Ve a la Página de Certificación de BigGo
  • Haz clic en el botón "Generar certificación"
  • Generate Certification
  • Copia el client_id y client_secret
  • Úsalos en la configuración del Servidor MCP (BIGGO_MCP_SERVER_CLIENT_ID y BIGGO_MCP_SERVER_CLIENT_SECRET)

Configuración de Instalación

{
  "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 una versión específica usa BigGo-MCP-Server@VERSION, ej: BigGo-MCP-Server@0.1.1

Variables de Entorno

VariableDescripciónPredeterminadoOpciones
BIGGO_MCP_SERVER_CLIENT_IDID de ClienteNingunoRequerido para la búsqueda de especificaciones
BIGGO_MCP_SERVER_CLIENT_SECRETSecreto de ClienteNingunoRequerido para la búsqueda de especificaciones
BIGGO_MCP_SERVER_REGIONRegión para la búsqueda de productosTWUS, TW, JP, HK, SG, MY, IN, PH, TH, VN, ID
BIGGO_MCP_SERVER_SSE_PORTPuerto para el servidor SSE9876Cualquier número de puerto disponible
BIGGO_MCP_SERVER_SERVER_TYPETipo de transporte del servidorstdiostdio, sse

URL SSE predeterminada: http://localhost:9876/sse

Herramientas Disponibles

  • product_search: Búsqueda de productos con la API de búsqueda de BigGo
  • price_history_graph: Enlace que visualiza el historial de precios de productos
  • price_history_with_history_id: Utiliza IDs de historial de los resultados de búsqueda de productos
  • price_history_with_url: Rastrea el historial de precios usando URLs de productos
  • spec_indexes: Lista los índices de Elasticsearch disponibles para especificaciones de productos
  • spec_mapping: Muestra el mapeo de índices de Elasticsearch con documentos de ejemplo
  • spec_search: Consulta especificaciones de productos desde Elasticsearch
  • get_current_region: Obtiene la región actual

Preguntas Frecuentes

¿Cómo activar el uso de herramientas?

Para lo relacionado con Descubrimiento de Productos:

Look for Nike running shoes

Para lo relacionado con Seguimiento de Historial de Precios:

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

Para lo relacionado con Comparación de Especificaciones:

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

Compilación

Consulta build.md para más detalles.

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulta el archivo LICENSE para más detalles.