招投标大数据服务

Consulta información empresarial completa desde plataformas de comercio electrónico, incluyendo detalles de tiendas, datos de ventas y estadísticas de productos.

Documentación

招投标大数据服务

Este servicio MCP ofrece funciones integrales de consulta de información empresarial en plataformas de comercio electrónico, incluyendo información de tiendas en línea, análisis de datos de ventas, estadísticas de categorías de productos, etc., para ayudar a los usuarios a comprender la distribución del negocio de comercio electrónico de las empresas.

Funciones principales

  • 🔍 Búsqueda difusa de empresas por palabras clave
  • 🛒 Consulta de perfil de tiendas en línea globales
  • 📊 Análisis de perfil de productos de comercio electrónico
  • 🏬 Consulta de información de tiendas de comercio electrónico
  • 📦 Estadísticas de categorías de productos
  • 🌐 Análisis de distribución de plataformas

Requisitos del entorno

  • Python 3.10+
  • Paquetes de dependencia: python-dotenv, requests, mcp

Inicio rápido local

1. Clonar el proyecto

git clone https://github.com/handaas/estore-mcp-server
cd estore-mcp-server

2. Crear entorno virtual e instalar dependencias

python -m venv mcp_env && source mcp_env/bin/activate
pip install -r requirements.txt

3. Configuración del entorno

Copie la plantilla de variables de entorno y configúrela:

cp .env.example .env

Edite el archivo .env y configure las siguientes variables de entorno:

INTEGRATOR_ID=your_integrator_id
SECRET_ID=your_secret_id
SECRET_KEY=your_secret_key

4. Iniciar el servicio con streamable-http

python server/mcp_server.py streamable-http

El servicio se iniciará en http://localhost:8000.

Métodos de inicio compatibles: stdio, sse o streamable-http

5. Configuración de MCP en Cursor / Cherry Studio

{
  "mcpServers": {
    "handaas-mcp-server": {
      "type": "streamableHttp",
      "url": "http://127.0.0.1:8000/mcp"
    }
  }
}

Instalación e implementación de la versión STDIO

Configurar MCP en Cursor / Cherry Studio

{
  "mcpServers": {
    "estore-mcp-server": {
      "command": "uv",
      "args": ["run", "mcp", "run", "{workdir}/server/mcp_server.py"],
      "env": {
        "PATH": "{workdir}/mcp_env/bin:$PATH",
        "PYTHONPATH": "{workdir}/mcp_env",
        "INTEGRATOR_ID": "your_integrator_id",
        "SECRET_ID": "your_secret_id",
        "SECRET_KEY": "your_secret_key"
      }
    }
  }
}

Uso del servicio Remote oficial

1. Configurar directamente MCP en Cursor / Cherry Studio

{
  "mcpServers": {
    "estore-mcp-server":{
      "type": "streamableHttp",
      "url": "https://mcp.handaas.com/estore/estore_bigdata?token={token}"  
      }
  }
}

Nota: integrator_id, secret_id, secret_key y token requieren iniciar sesión en https://www.handaas.com/ para registrarse y obtener acceso a la plataforma

Herramientas disponibles

1. estore_bigdata_fuzzy_search

Función: Consulta difusa de empresas por palabras clave

Consulta difusa de listas de empresas relacionadas según palabras clave proporcionadas como nombre de empresa, nombre de persona, marca, producto, puesto, etc.

Parámetros:

  • matchKeyword (Obligatorio): Palabra clave de coincidencia - Consultar empresas cuya información variada contenga la palabra clave coincidente
  • pageIndex (Opcional): Posición de inicio de paginación
  • pageSize (Opcional): Posición de fin de paginación - Máximo 50 registros por página

Valor de retorno:

  • total: Total
    • nameId: ID de empresa
    • name: Nombre de empresa
    • socialCreditCode: Código de crédito social unificado
    • legalRepresentative: Representante legal
    • enterpriseType: Tipo de entidad empresarial
    • operStatus: Estado de la empresa
    • address: Dirección de registro
    • foundTime: Fecha de establecimiento
    • regCapitalValue: Monto de capital registrado
    • catchReason: Motivo de coincidencia

2. estore_bigdata_global_online_store_profile

Función: Consulta de perfil de tiendas en línea globales

Proporciona información de perfil de tiendas en línea de la empresa en el país y en el extranjero, incluyendo detalles como número de tiendas, volumen total de productos, plataformas de venta, marcas y productos principales.

Parámetros:

  • matchKeyword (Obligatorio): Palabra clave de coincidencia - Nombre de empresa/Número de registro/Código de crédito social unificado/ID de empresa
  • keywordType (Opcional): Enumeración de tipo de entidad - name/nameId/regNumber/socialCreditCode

Valor de retorno:

  • domesticEshopCount: Número de tiendas en línea nacionales
  • domesticEshopProductCount: Volumen total de productos en tiendas en línea nacionales
  • domesticEshopBrandList: Marcas principales de tiendas en línea nacionales
  • domesticEshopPlatformList: Plataformas de publicación de tiendas en línea nacionales
  • domesticEshopProductList: Productos principales de tiendas en línea nacionales
  • domesticEshopSourceList: Fuente de tiendas en línea nacionales
  • foreignEshopCount: Número de tiendas en línea extranjeras
  • foreignEshopProductCount: Volumen total de productos en tiendas en línea extranjeras
  • foreignEshopBrandList: Marcas principales de tiendas en línea extranjeras
  • foreignEshopPlatformList: Plataformas de publicación de tiendas en línea extranjeras
  • foreignEshopProductList: Productos principales de tiendas en línea extranjeras
  • foreignEshopSourceList: Fuente de tiendas en línea extranjeras

3. estore_bigdata_ecommerce_product_profile

Función: Análisis de perfil de productos de comercio electrónico

Consulta el perfil de tiendas y productos de la empresa en plataformas de comercio electrónico, incluyendo detalles como información de marca, calificaciones, fecha de creación, etc.

Parámetros:

  • matchKeyword (Obligatorio): Palabra clave de coincidencia - Nombre de empresa/Número de registro/Código de crédito social unificado/ID de empresa
  • keywordType (Opcional): Enumeración de tipo de entidad - name/nameId/regNumber/socialCreditCode

Valor de retorno:

  • ecShopNumber: Número de tiendas
  • ecShopItemCount: Número total de productos en tiendas
  • ecShopAvgRates: Calificación promedio de tiendas (puntos)
  • ecShopEarliestFoundTime: Fecha de creación de tiendas
  • ecShopItemCategories: Categorías de productos
  • ecShopBrands: Marcas principales
  • ecShopProducts: Productos principales
  • ecSources: Plataformas de publicación

4. estore_bigdata_ecommerce_store_info

Función: Consulta de información de tiendas de comercio electrónico

Consulta información de tiendas en línea asociadas a la empresa, devolviendo detalles de las tiendas y una visión general de los datos comerciales.

Parámetros:

  • matchKeyword (Obligatorio): Palabra clave de coincidencia - Nombre de empresa/Número de registro/Código de crédito social unificado/ID de empresa
  • keywordType (Opcional): Enumeración de tipo de entidad - name/nameId/regNumber/socialCreditCode

Valor de retorno:

  • eshopListCount: Número total de tiendas en línea asociadas
  • enterpriseEshopCount: Número de tiendas en línea
  • enterpriseEshopProductsCount: Volumen total de productos en tiendas en línea
  • enterpriseEshopBrands: Marcas principales
  • enterpriseEshopProducts: Productos principales
  • enterpriseEshopPlatforms: Plataformas de publicación de tiendas en línea
  • eshopList: Lista de tiendas en línea asociadas
    • eshopName: Nombre de la tienda en línea
    • eshopKeeper: Nombre del administrador de la tienda
    • eshopFoundTime: Fecha de apertura de la tienda
    • eshopUrl: URL de la tienda en línea
    • eshopIconLink: Logotipo de la tienda en línea
    • eshopProducts: Categoría principal
    • enterpriseName: Empresa propietaria
    • address: Ubicación de la tienda en línea
    • businessStatistics: Estado operativo
    • isExpired: Si la tienda en línea ha expirado
  • overview: Visión general de datos de tiendas en línea

Casos de uso

  1. Análisis de operaciones de comercio electrónico: comprender la situación operativa y el desempeño de mercado de la empresa en diversas plataformas de comercio electrónico
  2. Investigación de competidores: analizar la distribución de comercio electrónico y las estrategias de venta de los competidores
  3. Investigación de mercado: estudiar las tendencias de desarrollo del comercio electrónico y las oportunidades de mercado en industrias específicas
  4. Decisiones de inversión: evaluar el potencial de desarrollo del negocio de comercio electrónico y el valor comercial de la empresa
  5. Selección de socios: buscar socios y proveedores de comercio electrónico de alta calidad
  6. Monitoreo de marca: monitorear el desempeño y la reputación de la marca de la empresa en plataformas de comercio electrónico
  7. Análisis de cadena de suministro: comprender la cadena de suministro de comercio electrónico y la distribución de productos de la empresa

Notas de uso

  1. Requisito de nombre completo de la empresa: al llamar a interfaces que requieren el nombre completo de la empresa, si no se tiene el nombre completo, primero se debe llamar a la interfaz estore_bigdata_fuzzy_search para obtenerlo
  2. Diferencias de plataforma: las estructuras de datos y los métodos de estadística pueden variar entre diferentes plataformas de comercio electrónico
  3. Actualidad de los datos: los datos de comercio electrónico se actualizan con frecuencia, se recomienda prestar atención a las marcas de tiempo de los datos
  4. Datos de ventas: algunos datos de ventas pueden ser valores estimados, solo como referencia
  5. Datos internacionales: la integridad y precisión de los datos de tiendas en línea extranjeras pueden estar limitadas por la fuente de datos
  6. Estado de tiendas: preste atención a distinguir entre tiendas activas y tiendas cerradas

Ejemplos de preguntas de uso

estore_bigdata_global_online_store_profile (Consulta de perfil de tiendas en línea globales)

  1. ¿Cuántas tiendas en línea tiene Xiaomi en el país y en el extranjero? ¿Qué marcas y productos vende principalmente?
  2. ¿Cómo es la distribución global de tiendas en línea de Huawei? ¿Cuál es el volumen total de productos?
  3. ¿Qué plataformas cubre el negocio de comercio electrónico de BYD? ¿Cómo están las tiendas en línea en el extranjero?

estore_bigdata_ecommerce_product_profile (Análisis de perfil de productos de comercio electrónico)

  1. ¿Cuántas tiendas de comercio electrónico tiene Xiaomi? ¿Cuál es la calificación promedio?
  2. ¿Cuál es el número total de productos en las tiendas en línea de Huawei? ¿Cuáles son las principales categorías de productos?
  3. ¿Cuál es la fecha de creación más temprana de las tiendas de comercio electrónico de BYD? ¿Cuál es la marca principal?

estore_bigdata_ecommerce_store_info (Consulta de información de tiendas de comercio electrónico)

  1. ¿Cuántas tiendas en línea asociadas tiene Xiaomi en total? ¿Cómo son los detalles de las tiendas?
  2. ¿En qué plataformas se distribuyen principalmente las tiendas en línea de Huawei? ¿Cuáles son los nombres de los administradores?
  3. ¿Cuál es el estado operativo de las tiendas de comercio electrónico de BYD? ¿Hay tiendas vencidas?